API v1 · 1.18.0 · SDK 0.17.0

Build on a clinic's live data

The pozyskajpacjenta.pl API gives your frontend the data the clinic's own site is rendered from: pages and blocks, treatments, the team, case studies, posts, the theme and the clinic profile. It books appointments in the clinic's calendar and sends enquiries to its CRM. Everything the clinic publishes in its panel is in the API at once.

Quickstart API reference

Base URL: https://app.pozyskajpacjenta.pl/api/v1
Auth: Bearer key pp_live_…
Rate limit: 120 requests per minute per key

Your first request

curl "https://app.pozyskajpacjenta.pl/api/v1/site" \
  -H "Authorization: Bearer $PP_API_KEY"

200 OK (excerpt)

{
  "site": {
    "name": "Klinika Wzorcowa",
    "primaryDomain": "wzorcowa.pozyskajpacjenta.pl",
    "menu": [
      {
        "label": "Strona główna",
        "path": "/"
      },
      {
        "label": "Zabiegi",
        "path": "/zabiegi"
      }
    ],
    "profile": {
      "phone": "+48 22 100 20 30",
      "address": {
        "street": "ul. Przykładowa 12",
        "postalCode": "00-950",
        "city": "Warszawa",
        "district": "Mokotów",
        "accessNote": "Wejście od podwórza, parter, winda."
      },
      "openingHours": {
        "mon": [
          {
            "opens": "08:00",
            "closes": "20:00"
          }
        ]
      }
    },
    "noindex": false
  }
}

Start here

QuickstartA key, the site as JSON, a page rendered with the SDK and a test lead, in four steps.Content modelSite, pages told apart by kind, blocks, entities, theme tokens and media.Booking modesOnline booking, a request for a time, a widget or the phone: follow the clinic's mode.LeadsEnquiries from your forms to the clinic's CRM, with aliases, warnings and strict mode.WebhooksReceive lead.created signed with HMAC-SHA256, with retries.TypeScript SDKOne typed method per endpoint, typed errors, the page union.

API reference

Six tags. Every endpoint page has request samples in cURL, TypeScript and PHP (WordPress), responses recorded from a running server, and its errors by code.

ContentThe clinic's site as data: a page with its site, the site alone, the privacy policy and every published path.getContentgetSitelistLocationsgetPrivacylistPages EntitiesTreatments, team members, case studies and posts, each with a list and a detail endpoint.listServicesgetServicelistDoctorsgetDoctorlistCaseStudiesgetCaseStudylistPostsgetPost BookingBookable services and specialists, free slots, booking an appointment and the clinic's appointment list.getBookingCataloggetSlotslistAppointmentscreateAppointment LeadsPatient enquiries from your own forms, stored in the clinic's CRM with the same e-mail to reception as an enquiry from the clinic's site.createLead MediaThe clinic's media library: list the files and upload images.uploadMedialistMedia FeedbackRemarks about the clinic's site or about the API, sent to the platform team. Never patient data.sendFeedback ConversationsThe clinic's conversations with patients on every channel: read them, read their messages and reply, by the rules the clinic's inbox applies. Needs the key scopes conversations:read and conversations:write.listConversationsgetConversationlistMessagessendMessage

Versions

API v1 is 1.18.0 and changes only by addition: new endpoints, optional parameters and new fields. A change that tightens behaviour is marked in the changelog. The SDK is 0.17.0. Versioning · Changelog