GET/api/v1/s2s/appointments

List partner appointments

Published Partner endpoint from the stable OpenAPI 1.0.0 contract.

Overview

Use this endpoint only with a Partner API key. Code samples use placeholders and the public sandbox URL.

Method: GET
Endpoint: /api/v1/s2s/appointments
Authentication: X-API-Key

Request

Parameters

X-Correlation-IDstringheader: Optional opaque request correlation ID for tracing API calls across systems. Billing audit paths persist only UUIDv4-shaped values and drop free-form values.; Example: 33333333-3333-4333-8333-333333333333
fromstring (date)queryRequired: Start date in YYYY-MM-DD format.; Example: 2026-06-01
tostring (date)queryRequired: End date in YYYY-MM-DD format.; Example: 2026-06-07
providerIdstring (uuid)query: Filter or target a specific provider. Defaults to the authenticated provider when omitted.; Example: 5cd4f03b-5c1d-406e-b834-35b4f635c1c3
statusstringquery: Optional appointment status filter.; Example: CONFIRMED
specialtySlugstringquery: Specialty slug, for example adipositas.; Example: adipositas

Contract

The versioned OpenAPI contract is the authoritative source for parameters, request bodies, and response schemas.

Version

1.0.0

Expected response

200 OK

Download OpenAPI 1.0.0

Simulated sandbox

Language

cURL

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

Response scenario