# GenHealth API reference

> Learn the conventions, authentication, pagination, and response patterns used across the reviewed public GenHealth endpoints.

Source: [https://genhealth.ai/docs/api-reference](https://genhealth.ai/docs/api-reference)

## Conventions

Requests and responses use JSON unless an endpoint states otherwise. Send credentials through the Authorization header and use the documented query parameter names exactly as shown.

## Base URL

```text
https://api.umpa.genhealth.ai
```

## Pagination

List endpoints use page and limit query parameters. Start with the default values, inspect the returned pagination metadata, and stop when the response indicates there are no more records.

| Parameter | Type | Description |
| --- | --- | --- |
| page | integer | One-based page number |
| limit | integer | Maximum records returned on a page |

## Responses and errors

| Range | Meaning | Action |
| --- | --- | --- |
| 2xx | Request succeeded | Read the documented response body |
| 4xx | Request or authorization problem | Correct the request before retrying |
| 5xx | Service could not complete the request | Retry with backoff and preserve the request ID |

## Operations

- [List cases](https://genhealth.ai/docs/api-reference/v1/cases/list-cases-v2.md): `GET /v2/cases` — Returns the prior-authorization cases associated with the authenticated organization.
- [Retrieve a case](https://genhealth.ai/docs/api-reference/v1/cases/get-case.md): `GET /v1/cases/{case_id}` — Retrieves a single case belonging to the authenticated organization.
- [List policies](https://genhealth.ai/docs/api-reference/v1/policies/list-policies.md): `GET /v1/policies` — Returns active medical-necessity policies visible to the authenticated organization.
- [List medical codes](https://genhealth.ai/docs/api-reference/v1/codes/list-codes.md): `GET /v1/codes` — Returns medical codes available to the authenticated organization.
- [List publishers](https://genhealth.ai/docs/api-reference/v1/publishers/list-publishers.md): `GET /v1/publishers` — Returns policy publishers available to the authenticated organization.