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

Sandboxhttps://api.sandbox.pierflow.com
Productionhttps://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-Key to retry safely.
  • AI fields are stable and explained in the AI layer guide.