API reference

Context

Resolve which program an API key belongs to. Call this once at setup — every other endpoint is nested under a program id.

Get key context

GET/v1/meno scope

Returns the program and agency this API key is bound to, plus its scopes. Because keys are program-scoped, this is how a client discovers the program id it needs for every other call.

Response

json

{
  "program": {
    "id": "8f2c1e94-...",
    "name": "PeakCare",
    "subdomain": "peakcare",
    "customDomain": "partners.peakcare.health",
    "isActive": true,
    "payoutProvider": "stripe_connect",
    "storeConnector": "vco"
  },
  "agency": { "id": "3a1b...", "name": "Rangel Holdings", "slug": "rangel" },
  "scopes": ["read", "write"]
}

Cache the program id. It never changes for a given key.
Also the cheapest way to verify a key is live during setup.