Policies API

List policies

Returns active medical-necessity policies visible to the authenticated organization.

GET/v1/policies

Authorizations

Authorization

stringheaderrequired

Send your GenHealth credential as Bearer <YOUR_API_KEY>. This endpoint requires API read access for the authenticated organization.

Headers

Accept

stringheader

Response media type. Use application/json for the current API.

Parameters

title

stringquery

Filter by policy title.

publisher

stringquery

Filter by publisher name.

publisher_id

stringquery

Filter by publisher identifier.

policy_id

stringquery

Filter by policy identifier.

page

integerquery

Page number.

Default: 1

limit

integerquery

Records per page, capped at 100.

Default: 20

Responses

200A paginated collection of policies.

PoliciesResponse

dataarray<Policy>

paginationPagination

401The bearer token is missing, invalid, or lacks the required scope.

Error

detailstring

422One or more request values failed validation.

Error

detailstring

Request example

curl --request GET \
  --url 'https://api.umpa.genhealth.ai/v1/policies?page=1&limit=20' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Accept: application/json'

Response example

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "Example medical policy",
      "publisher": "Example health plan",
      "type": "string",
      "last_updated": "2026-08-05T14:45:00Z"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "pageSize": 1,
    "totalPages": 1,
    "totalItems": 1,
    "next": 1,
    "previous": 1
  }
}

Live API playgroundTry this request

Runs against the GenHealth API with your existing signed-in credentials.

Checking your GenHealth API access…

Responses can contain organization data or PHI. They are shown only in this tab and are not stored by the documentation site.

View OpenAPI document