Skip to main content
Everything the API does is plain HTTPS with a bearer key, so you never need a library. Client libraries take care of the plumbing you would otherwise write yourself.

Install the TypeScript client

It calls https://api.clinikehr.com/v1 by default. Start with a test key from the developer portal — it reaches only your sandbox. Call the API from your server: the client refuses to run in a web browser, whatever the key. Read the full TypeScript client guide → — calls, idempotent writes, retries, errors, paging, FHIR and webhooks. Each published version is built from its public source by GitHub Actions and carries a signed provenance statement, so you can confirm what you installed with npm audit signatures.

Install the Python client

It also calls https://api.clinikehr.com/v1 by default, and needs Python 3.11 or later. Use a test key from the developer portal to begin, and keep your key on your server: unlike the TypeScript client, the Python client has no way to tell that it has been put in front of a browser. Read the full Python client guide → — calls, idempotent writes, retries, errors, paging, FHIR and webhooks. Each published version is published from its public source by GitHub Actions using PyPI trusted publishing, and PyPI shows a signed attestation for each file on that file’s page.
Install only the package named clinikehr from PyPI, and only @clinikehr/api from npm. Do not install a package with a similar name, or either of these names from anyone else’s account or mirror: they are ours alone.

What the libraries do

Both are thin. They call the same endpoints this documentation describes, and add the parts that are easy to get wrong:
  • sending your key, and keeping it out of a browser;
  • a fresh Idempotency-Key on every write, reused across retries so a retry cannot create a second record — see Retries and duplicates;
  • retrying a failed or rate-limited request with a sensible delay — see Rate limits;
  • walking a paged list for you — see Pagination;
  • typed errors that carry the code and request_id — see Errors;
  • checking a webhook’s signature — see Verifying a webhook’s signature;
  • asking for FHIR instead of JSON — see FHIR R4.

The Postman collection

The collection has one request for every endpoint, grouped the way this reference groups them. To use it:
  1. Get the collection. Download the collection (one JSON file). It is kept in step with this reference, so download it again when the API changes.
  2. In Postman, choose Import and select the file.
  3. Open the collection’s Variables tab. baseUrl is already https://api.clinikehr.com/v1. Set bearerToken to your key. Use a test key from the developer portal to begin, which reaches only your sandbox.
  4. Send the request for GET /v1/me first. It tells you which clinic or workspace the key belongs to, and proves the key works.
Every request that creates or changes something carries an Idempotency-Key header with a fresh value, so sending it twice by accident does not do it twice. Fill in the path values (such as clinic_id) and the body before you send.
Treat your key like a password. Do not save a live key into a collection you share, and do not export a collection with a live key filled in.

Base URL

Every endpoint lives under this base URL. See Versioning for how the path changes over time, and Authentication for how the key is sent.