Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card

Your first API call in 2 minutes

One path from nothing to a real API answer: sign in, create a free sandbox with 30 synthetic patients, copy the key and make one call in curl, Python, JavaScript or Dart, with the expected result and the usual errors.

One path from nothing to a real answer from the API: an account, a sandbox, a key and one call. The sandbox is free, needs no card, and comes with 30 synthetic patients, so you never touch real patient data while you build.

In short:

1. Create your account

Open the dashboard at platform.anpheros.com/dashboard and sign in with Google. That is the whole account: no form, no card.

2. Create your sandbox

Press Get a sandbox key. You get an organization, a sandbox project and its own copy of 30 synthetic patients with six months of history: conditions (ICD-10), medications (ATC), allergies, lab results and vital signs (LOINC). Nobody else sees your copy, and you can change or delete anything in it.

3. Copy your key

The key starts with sk_test_ and is shown only once. Copy it now and keep it on your computer or server, never in an app you ship. If you lose it, create a new key in the dashboard and revoke the old one.

Put it in your terminal so the examples below work as they are:

export ANPHEROS_KEY=sk_test_your_key_here

4. Make your first call

The base URL is https://platform.anpheros.com for the sandbox and for production: the key decides which data you reach. Every request sends the key as Authorization: Bearer <key>.

curl

curl https://platform.anpheros.com/v1/patients -H "Authorization: Bearer $ANPHEROS_KEY"

Python (with requests: pip install requests)

import os, requests

r = requests.get("https://platform.anpheros.com/v1/patients",
                 headers={"Authorization": f"Bearer {os.environ['ANPHEROS_KEY']}"})
r.raise_for_status()
body = r.json()
print(body["total"], "patients; first:", body["data"][0]["given"], body["data"][0]["family"])

JavaScript (Node 18 or newer, no package needed)

const r = await fetch('https://platform.anpheros.com/v1/patients', {
  headers: { Authorization: `Bearer ${process.env.ANPHEROS_KEY}` },
});
if (!r.ok) throw new Error(`${r.status} ${await r.text()}`);
const body = await r.json();
console.log(body.total, 'patients; first:', body.data[0].given, body.data[0].family);

Save it as first.mjs and run node first.mjs. With the TypeScript SDK (npm install @anpheros/sdk):

import { Anpheros, apiKey } from '@anpheros/sdk';

const anpheros = new Anpheros({ auth: apiKey(process.env.ANPHEROS_KEY!) });
const { data: patients } = await anpheros.patients.list();
console.log(patients.length, patients[0].given, patients[0].family);

Dart / Flutter (dart pub add anpheros_sdk; run it on your server or in a command-line tool, not inside a shipped app)

import 'dart:io';
import 'package:anpheros_sdk/anpheros_sdk.dart';

Future<void> main() async {
  final anpheros = Anpheros(auth: AnpherosAuth.apiKey(Platform.environment['ANPHEROS_KEY']!));
  final patients = await anpheros.patients.list();
  print('${patients.data.length} patients; first: ${patients.data.first.given} ${patients.data.first.family}');
}

5. What you should see

Status 200 and a list of your sandbox patients:

{"data":[{"id":"…","given":"Elena","family":"Ionescu","birth_date":"1985-09-03","gender":"female",…,"fhir":"Patient/…"}, …],"total":30,"next_cursor":null}

total is 30 in a new sandbox. Each patient has an id you use in the next calls, and a fhir reference to the same record in the FHIR R4 API. Try one more, with the id of the first patient:

curl "https://platform.anpheros.com/v1/patients/<id>/observations?category=laboratory&limit=5" \
     -H "Authorization: Bearer $ANPHEROS_KEY"

6. Next: your first write

Reading works, so write one value. This adds a glucose result to the patient whose id you used above, says who the author is, and sends an Idempotency-Key so a retry never creates a duplicate:

curl -X POST "https://platform.anpheros.com/v1/patients/<id>/observations" \
     -H "Authorization: Bearer $ANPHEROS_KEY" -H 'content-type: application/json' \
     -H "Idempotency-Key: $(uuidgen)" -d '{
  "code": "2339-0", "display": "Glucose", "category": "laboratory",
  "value": 112, "unit": "mg/dL", "effective_at": "2026-09-19T08:10:00Z",
  "author_type": "device"
}'

The answer is the stored observation with its id, its fhir reference and updated_at. More writes, documents and provenance: Getting started.

If it did not work

These are the answers people get most often on their first call. Every response carries an Anpheros-Request-Id header: quote it if you write to us.

More answers, with examples: Troubleshooting.

Next steps

You have made the first of five steps. The bar at the top of these guides shows where you are:

1. Quickstart: this page.
2. First write: add an observation with its author and an Idempotency-Key, in Getting started.
3. OAuth app: when your app acts for a real person, the person signs in and approves access: Authentication and OAuth.
4. Webhooks: get told when a record changes instead of polling: Webhooks.
5. Go live: from the sandbox to production with real patients: Go live.

Along the way: read and share a patient summary with IPS and SMART Health Links, or let an AI coding tool write the integration with Build with Claude Code or Cursor.

Frequently asked questions

Is the sandbox really free?

Yes. The sandbox is free, with no card and no time limit. You pay only for production, from €99 a month, and the first month of production is free.

Can I use real patient data in the sandbox?

No. The sandbox is for synthetic patients and test data. Real patients go in a production project, after your organization is verified and has signed the data processing agreement.

Do I need the FHIR API or the REST API?

Either. /v1 is a simple REST API and /fhir/R4 is strict FHIR R4. Both read and write the same records with the same ids, and the same key works for both.

Where do I find every endpoint?

In the API reference and in openapi.json.

Read https://developers.anpheros.com/guides/first-api-call.md and help me make my first call to the Anpheros API from my project. Use the Anpheros sandbox (base URL https://platform.anpheros.com) with my API key from the ANPHEROS_KEY environment variable, never written in the code. Give me complete, runnable code, the response I should expect, and how to fix the errors in https://developers.anpheros.com/guides/troubleshooting.md if a call fails.

Try it free in the sandbox · first FHIR call in 5 minutesFree · 30 synthetic patients · no card