# FinchNode Public Demo API

Canonical URL: https://finchnode.com/developers/demo-api

API base URL: https://api.finchnode.com/demo/v1

The FinchNode Public Demo API is free, accountless, and rate limited. It serves only the fixed fictional Northstar Health sample EMR used by the FinchNode Visualizer. It never accesses a production database, real patient account, credential, protected health information, or third-party EHR sandbox, and it is not for clinical use.

## Free production-grade EHR API access.

[Production-grade access is free with an account.](https://finchnode.com/signup)

With a FinchNode account, developers get free production-grade access to real, patient-authorized health records through one unified EHR API.

The $0/month plan includes 100 connected patient-months, 100,000 production API calls per month, one production application, and an unlimited synthetic sandbox.

The public demo API serves fixed fictional records for free without an account. Create a FinchNode account for free production-grade access to real, patient-authorized records within the included plan allowances. The demo itself cannot access real patient data.

Free production access and the public synthetic demo

| What you get | Free production plan | Public demo API |
| --- | --- | --- |
| Price | $0/month within included allowances | $0 |
| Patient data | Real records with patient authorization and consent | Fixed fictional patient records only |
| EHR access | Supported live sources; availability varies by organization | No live EHR connections |
| Included usage | 100 connected patient-months; 100,000 production API calls/month; 1 production app | Rate-limited sample API |
| Getting started | Account, production credentials, and source availability | No account or API key |

Production access requires a FinchNode account, production credentials, a supported live source, and patient authorization and consent. Availability depends on the EHR, organization, application approvals, scopes, and records returned.

[Free production EHR API](https://finchnode.com/ehr-integration-api) · [Plans and usage allowances](https://finchnode.com/#pricing)


## Start in one request

```sh
curl https://api.finchnode.com/demo/v1/patients/patient-demo-001/records?categories=demographics,labs,medications
```

## Useful resources

- [API discovery document](https://api.finchnode.com/demo/v1)
- [OpenAPI 3.1](https://finchnode.com/demo-openapi.json)
- [Synthetic FHIR Bundle](https://api.finchnode.com/demo/v1/fhir/Bundle/finchnode-visualizer-synthetic-bundle)
- MCP Streamable HTTP endpoint: https://api.finchnode.com/demo/mcp
- [Visualizer](https://finchnode.com/tools/finchnode-visualizer)

The default limit is 120 requests per minute per IP and running API instance. Use the RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and Retry-After response headers as authoritative runtime policy.