Quickstart

curl https://api.heyrafiki.space/v1 \
  -H "Authorization: Bearer $HEYRAFIKI_API_KEY"

{
  "object": "api",
  "version": "v1",
  "environment": "sandbox",
  "resources": [
    "practitioners",
    "availability",
    "bookings",
    "sessions",
    "eligibility_checks",
    "preauthorizations",
    "claims",
    "remittances",
    "webhook_endpoints"
  ]
}

curl "https://api.heyrafiki.space/v1/practitioners?limit=10" \
  -H "Authorization: Bearer $HEYRAFIKI_API_KEY"

curl "https://api.heyrafiki.space/v1/practitioners/prc_2481/availability" \
  -H "Authorization: Bearer $HEYRAFIKI_API_KEY"

curl https://api.heyrafiki.space/v1/bookings \
  -X POST \
  -H "Authorization: Bearer $HEYRAFIKI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: booking-demo-001" \
  -d '{
    "practitioner_id": "prc_2481",
    "starts_at": "2026-08-03T06:00:00.000Z",
    "ends_at": "2026-08-03T07:00:00.000Z",
    "format": "online",
    "payment_source": "self_pay"
  }'