Cases API

List cases

Returns the prior-authorization cases associated with the authenticated organization.

GET/v2/cases

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

page

integerquery

Page number.

Default: 1

limit

integerquery

Maximum number of cases to return.

Default: 10

status

string or array<string>query

Filter by one or more case statuses.

recommendation

stringquery

Filter by decision recommendation.

sort_by

stringquery

Case field used for sorting.

order_by

stringquery

Sort direction.

Default: asc

Responses

200A paginated collection of cases.

CasesResponse

dataarray<Case>

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/v2/cases?page=1&limit=10&order_by=asc' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Accept: application/json'

Response example

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "open",
      "recommendation": "approve",
      "policy_id": "f844ba52-0b67-4874-a06a-900f98b10dd7",
      "created_at": "2026-08-05T14:30:00Z",
      "last_modified": "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