Search ICD Codes

Search for ICD (International Classification of Diseases) codes based on query parameters, specialty, and payer type.

Endpoint

GET /apis/soap-enrichment/v1/bcs/icd/search

Query Parameters

Parameter	Type	Required	Description
q	string	Yes	The search query (ICD code or description)
speciality	string	No	Medical specialty filter (e.g., MSK for Musculoskeletal)
payerType	string	No	Insurance payer type filter
rev	string	No	ICD revision version (e.g., ICD10, ICD11)

Example Request

curl '{base_url}/apis/soap-enrichment/v1/bcs/icd/search?q=M25.50&speciality=MSK&payerType=&rev=ICD10' \
  -H 'Authorization: Bearer JWT_TOKEN' \
  -H 'Accept: application/json, text/plain, */*'

Response

Success Response

Status Code: 200 OK

{
  "code": 2000,
  "data": {
    "total": 10,
    "pages": 1,
    "current": 1,
    "no_of_records": 10,
    "content": null,
    "results": [
      {
        "uuid": "66b3817d2fa0546147a1a8f0",
        "id": 9676,
        "code": "M72.1",
        "description": "Knuckle pads",
        "revision": "ICD10",
        "code_trim": "M721",
        "billing_type": "BILLABLE",
        "organisation_id": -1,
        "clinic_id": null
      },
      {
        "uuid": "66b3b08bba73d0f8d87d788f",
        "id": 102490,
        "code": "Z00.110",
        "description": "Health examination for newborn under 8 days old",
        "revision": "ICD10",
        "code_trim": "Z00110",
        "billing_type": "BILLABLE",
        "organisation_id": -1,
        "clinic_id": null
      }, // other icd codes
    ]
  },
  "message": "Success"
}

Response Parameters

Parameter	Type	Description
total	integer	Total number of matching results
pages	integer	Total number of pages available
current	integer	Current page number
no_of_records	integer	Number of records in current response
content	null	Additional content (currently null)
results	array	Array of matching ICD codes
uuid	string	Unique identifier for the ICD code record
id	integer	Internal database ID
code	string	The ICD code identifier
description	string	Human-readable description of the condition
revision	string	ICD revision version (ICD10, ICD11, etc.)
code_trim	string	ICD code with periods removed
billing_type	string	Billing classification (BILLABLE, NON_BILLABLE)
organisation_id	integer	Organization ID (-1 for global codes)
clinic_id	null	Clinic-specific ID (null for global codes)

Usage Notes

• The search query (q) can be either an ICD code (e.g., "M25.50") or a description fragment (e.g., "joint pain")
• Partial matches are supported for both codes and descriptions
• The speciality parameter helps filter results relevant to specific medical specialties
• Results include pagination information with total, pages, and current page details
• The API supports both only ICD-11 code sets
• billing_type indicates whether the code is "BILLABLE" or "NON_BILLABLE"
• code_trim provides the ICD code with periods removed for simplified processing

Common Specialty Codes

Code	Description
MSK	Musculoskeletal
NEURO	Neurology