Codes API

List medical codes

Returns medical codes available to the authenticated organization.

GET/v1/codes

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

Records per page.

Default: 20

query

stringquery

Search by code or display name.

Responses

200Medical-code results.

array<MedicalCode>

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

Error

detailstring

Request example

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

Response example

[
  {
    "code": "99213",
    "system": "CPT",
    "display": "Office or other outpatient visit"
  }
]

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