Getting started
Health check
Confirm the API is up before anything else. No key required.
The only unauthenticated endpoint on this API — no X-API-Key needed. Useful as an uptime check, or to
confirm which environment you're actually talking to before debugging anything else.
GET
/v1/api/healthWrapped in the same envelope as every other endpoint — see Overview — so a shared response parser doesn't need a special case for this one.
Response fields
| Field | Type | Description | |
|---|---|---|---|
| version | string | — | API version |
| peppol_ap_id | string | — | SUMU's Peppol Access Point identifier — scheme 0242 (an Access Point, not a taxpayer's 0248 address) followed by this deployment's seat ID |
| environment | string | — | Which deploy environment answered — useful for confirming you're not accidentally hitting sandbox |
| status | string | — | operational is the only value seen in practice; treat anything else, or a non-200, as down |
| pint_om_version | string | — | Which version of the Oman PINT specification this deployment validates against |