Skip to main content

FHIR server

What this is for

ClinikAPI stores healthcare records in a standard format called FHIR (pronounced “fire”). In FHIR, every kind of record is a resource: a Patient, an Appointment, a Medication and so on. The FHIR server page is a read-only menu of everything your project’s API can handle: each resource, the actions it supports (read, create, search…) and the search filters you can use. It changes nothing; it just answers “can I do this with the API?”

Before you start

  • Any member can open it. No key is needed to view it.
  • You do not need to know FHIR to use ClinikAPI, but this page is easier if you know two words: a resource is a type of record, and a search parameter is a field you can filter by (such as a patient’s birth date).

Read the page

1

Open the page

Choose FHIR server in the sidebar. The page is titled FHIR server: “What your project’s FHIR API supports.”
2

Find a resource

The card Resource types and search parameters lists one row per resource. Scan the Resource column, for example Patient.
3

Read its operations

The Operations column shows badges for what you can do, such as read, create, update, delete and search.
4

Read its search parameters

Search parameters lists the fields you can filter by. A dash means none are offered.
5

Go deeper

Select Read the docs to open the API reference for details.

What you’ll see

  • The card says “Read from the live capability statement (FHIR (version)).” A capability statement is the API’s own published list of what it supports, so this page always reflects reality.
  • If it cannot be loaded: Not reachable right now: “The capability list could not be loaded. Try again shortly.”
  • Two cards, Backups and point-in-time recovery (“Restore your project to a chosen moment.”) and Failover standby (“A standby copy that takes over if your server fails.”). They describe features rather than controls. On the Free plan each says “Upgrade to Pro for a dedicated server.” with a See plans link. On paid plans each says “Arrives with dedicated projects.” For their prices see Compute and Disk.
Your code can read the same list at GET /v1/metadata, which needs no key.

Common questions

A widely used international standard for exchanging health records. It means your data has a predictable shape that other health systems understand.
This page lists what the API supports. The API reference page gives copy-ready requests for each resource.
A standby is a second copy of your server that takes over if the first fails. Point-in-time recovery lets you restore the project to a chosen moment. Both are described in Compute and Disk. Here they are information, not buttons.
These features belong to projects that have their own private server. The page tells you honestly that they are not switched on from this screen yet.
Not from here. The page only reports what the API supports. Contact support from the help menu to ask.

Troubleshooting