Directories API

Search diagnosis codes

Look up ICD-10-CM codes by code prefix or description.

GEThttps://app.mindbill.org/partner/v2/diagnosis-codes

Populate the diagnosis selector in a bill-entry form. searchDiagnosisCodes() calls this endpoint.

AuthenticationServer API key or browser session + Origin

Permissions by credentialServer: payers:read · Browser: payers:read

IdempotencyNot required

Use this URL with a server API key or a browser session and its exact allowed Origin. Both credentials use the same request and response contract. See the component API inventory for exact paths and SDK methods.

Query parameters

FieldTypeDescription

q

string

Code or description search; blank browses the catalog.

limit

integer

Page size; default 30, clamped to 1–100.

offset

integer

Zero-based offset; default 0.

Examples

curl 'https://app.mindbill.org/partner/v2/diagnosis-codes?q=M25.562&limit=1' \
  --header "Authorization: Bearer $MINDBILL_API_KEY"

curl 'https://app.mindbill.org/partner/v2/diagnosis-codes?q=M25.562&limit=1' \
  --header "Authorization: Bearer $MINDBILL_BROWSER_TOKEN" \
  --header 'Origin: https://your-app.example'

Response

200 OK

{
  "results": [{ "code": "M25.562", "description": "Pain in left knee" }],
  "total": 100000,
  "matched": 1
}

FieldTypeDescription

results[]

object[]

This page's matches, each with code and description. No data wrapper.

total

integer

Full catalog size, not the number matching the query.

matched

integer

Number of matches available for the query before pagination.

error

string

Present when the code set is unavailable; see the error note.