GET/api/v1/s2s/scheduling/providers/{providerId}/slots

List partner provider slots

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/scheduling/providers/{providerId}/slots
Authentication: X-API-Key

Request

Parameters

providerIdstring (uuid)pathRequired: Provider identifier.; Example: 5cd4f03b-5c1d-406e-b834-35b4f635c1c3
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-05-13
tostring (date)queryRequired: End date in YYYY-MM-DD format.; Example: 2026-05-20
specialtySlugstringquery: Specialty slug, for example adipositas.; Example: adipositas
statusstringquery: Optional slot status filter. Defaults to AVAILABLE; AVAILABLE results exclude active slot holds.; Example: AVAILABLE

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/scheduling/providers/example-providerId/slots \
  --header 'Accept: application/json' \
  --header 'X-API-Key: {PARTNER_API_KEY}'

Response scenario