Pierflow API
The Pierflow API is a single canonical surface across every connected HMO, provider, and partner in the network. Authenticate with a bearer token. Everything else is plain JSON.
Base URLs
| Sandbox | https://api.sandbox.pierflow.com |
| Production | https://api.pierflow.com |
Quick start
curl
curl https://api.sandbox.pierflow.com/v1/plans \
-H "Authorization: Bearer $PIERFLOW_KEY"Conventions
- All requests and responses are JSON.
- Timestamps are ISO-8601 in UTC.
- Money is represented in minor units (kobo for NGN).
- Writes are idempotent — set
Idempotency-Keyto retry safely. - AI fields are stable and explained in the AI layer guide.