Skip to main content

Diagnosis codes query

Summary​

The GraphQL API now exposes diagnosisCodes, a paginated query for valid diagnosis codes. The query is available only to practices in the PATHWAY_DIAGNOSES feature segment.

What changed​

New query:

query DiagnosisCodes($search: String, $pagination: Pagination) {
  diagnosisCodes(search: $search, pagination: $pagination) {
    data {
      code
      description
    }
    pageInfo {
      page
      pageSize
      hasMore
    }
  }
}

New types:

  • DiagnosisCode — includes code and description.
  • DiagnosisCodeData — includes data and pageInfo.

Supported parameters:

  • search: String — optional search text matched against code and description, case-insensitively.
  • pagination: Pagination — optional page and page size controls. Defaults match the existing Public API pagination defaults.

Integration guidance​

  • Omit search to retrieve the paginated list.
  • Pass search to match against either the code or description, case-insensitively.
  • Use pagination for real-time lookup and list synchronization.
  • If your practice does not have the feature enabled, the query returns a forbidden GraphQL error.

Example response​

{
  "data": {
    "diagnosisCodes": {
      "data": [
        {
          "code": "78000",
          "description": "GENERAL SYMPTOMS"
        }
      ],
      "pageInfo": {
        "page": 1,
        "pageSize": 30,
        "hasMore": false
      }
    }
  }
}

See also​