Partner API reference

The arztkonsultation Partner API is the public server-to-server contract for integration partners. Its stable first release is 1.0.0.

OpenAPI JSON 1.0.0
OpenAPI YAML 1.0.0

Language

curl --request GET \
  --url https://sandbox.arztkonsultation.io/api/v1/s2s/scheduling/appointment-types \
  --header 'Accept: application/json' \
  --header 'X-API-Key: {PARTNER_API_KEY}'

Published endpoints

From the immutable OpenAPI 1.0.0 contract.

OpenAPI JSON

Appointments & bookings

GET
/api/v1/s2s/appointments
List partner appointments
GET
/api/v1/s2s/appointments/{appointmentId}
Get partner appointment
POST
/api/v1/s2s/appointments/{appointmentId}/cancel
Cancel partner appointment
POST
/api/v1/s2s/bookings
Create a booking

Providers & availability

POST
/api/v1/s2s/organizations
Create an organization
POST
/api/v1/s2s/providers
Create a provider
POST
/api/v1/s2s/providers/{providerId}/availability-rules
Create provider availability rule
GET
/api/v1/s2s/providers/{providerId}/slots
List provider slots
POST
/api/v1/s2s/providers/{providerId}/specialties
Attach provider specialty
GET
/api/v1/s2s/scheduling/appointment-types
List partner appointment types
GET
/api/v1/s2s/scheduling/providers/{providerId}/availability-rules
List partner provider availability rules
POST
/api/v1/s2s/scheduling/providers/{providerId}/availability-rules
Create partner provider availability rule
PATCH
/api/v1/s2s/scheduling/providers/{providerId}/availability-rules/{ruleId}
Update partner provider availability rule
DELETE
/api/v1/s2s/scheduling/providers/{providerId}/availability-rules/{ruleId}
Deactivate partner provider availability rule
GET
/api/v1/s2s/scheduling/providers/{providerId}/slots
List partner provider slots

Partner pharmacies & organizations

POST
/api/v1/s2s/partners/pharmacies
Register a partner pharmacy
GET
/api/v1/s2s/partners/pharmacies/{partnerOrgId}
Get a partner pharmacy registration
POST
/api/v1/s2s/partners/pharmacies/{partnerOrgId}/login-links
Create a one-time backoffice login link
POST
/api/v1/s2s/partners/pharmacies/{partnerOrgId}/offboarding-requests
Request partner pharmacy offboarding
GET
/api/v1/s2s/partners/pharmacies/{partnerOrgId}/resource-mode
Read partner pharmacy resource mode
POST
/api/v1/s2s/partners/pharmacies/{partnerOrgId}/resource-mode
Switch partner pharmacy resource mode

Webhooks

GET
/api/v1/s2s/partners/pharmacies/{partnerOrgId}/webhooks
List partner pharmacy webhooks
POST
/api/v1/s2s/partners/pharmacies/{partnerOrgId}/webhooks
Create partner pharmacy webhook
DELETE
/api/v1/s2s/partners/pharmacies/{partnerOrgId}/webhooks/{webhookId}
Deactivate partner pharmacy webhook
POST
/api/v1/s2s/partners/pharmacies/{partnerOrgId}/webhooks/{webhookId}/test
Send webhook test delivery

Rooms & resources

GET
/api/v1/s2s/pharmacy/rooms
List partner pharmacy rooms
POST
/api/v1/s2s/pharmacy/rooms
Create partner pharmacy room
PATCH
/api/v1/s2s/pharmacy/rooms/{roomId}
Update partner pharmacy room
DELETE
/api/v1/s2s/pharmacy/rooms/{roomId}
Deactivate partner pharmacy room
POST
/api/v1/s2s/pharmacy/rooms/{roomId}/availability-rules
Create partner pharmacy room availability rule
PATCH
/api/v1/s2s/pharmacy/rooms/{roomId}/availability-rules/{ruleId}
Update partner pharmacy room availability rule
DELETE
/api/v1/s2s/pharmacy/rooms/{roomId}/availability-rules/{ruleId}
Deactivate partner pharmacy room availability rule