Open API
ICD History

Submit ICD change

Submit a new ICD code change for a claim.

Creates a new versioned record in the ICD history audit trail.

**Authentication:** API Key (X-API-Key header)
**Required Scope:** `claims:write`

**Request Body:**
- icd_inacbg: ICD codes for INA-CBG processing (optional)
  - icd9_list: Array of ICD-9 codes
  - icd10_list: Array of ICD-10 codes
- icd_idrg: ICD codes for IDRG processing (optional)
  - icd9_list: Array of ICD-9 codes
  - icd10_list: Array of ICD-10 codes
- feedback: Free-text reason for the change (optional, max 4000 characters)

**Example Request:**
```json
{
    "icd_inacbg": {
        "icd9_list": ["01.1"],
        "icd10_list": ["A01.0", "B02.1"]
    },
    "icd_idrg": {
        "icd9_list": ["02.2"],
        "icd10_list": ["C03.0"]
    },
    "feedback": "koreksi dari koder RS"
}
```

**Note:** You can submit only `icd_inacbg`, only `icd_idrg`, or both.
A `feedback` value alone is not a submission and is rejected with 422.

**Note:** `origin` is recorded server-side as `human` for every submission made
through this endpoint. It cannot be set from the request body.

**Example Response:**
```json
{
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "claim_id": "660e8400-e29b-41d4-a716-446655440001",
    "version": 1,
    "icd_inacbg": {
        "icd9_list": ["01.1"],
        "icd10_list": ["A01.0", "B02.1"]
    },
    "icd_idrg": null,
    "created_at": "2026-02-16T10:00:00Z",
    "origin": "human",
    "feedback": "koreksi dari koder RS"
}
```
post/api/v1/claims/{claim_id}/icd-history

Request

  • Base URL
    https://developer.claimmind.life (the document declares no server; this is the origin it was published from)
  • Auth
    none declared. Required headers: X-API-Key

Path parameters

claim_idstring required

Headers

authorizationstring nullable
X-API-Keystring required

Request body

feedbackstring nullable

Example request

{
  "icd_idrg": {
    "icd10_list": [
      "C03.0"
    ],
    "icd9_list": [
      "02.2"
    ]
  },
  "icd_inacbg": {
    "icd10_list": [
      "A01.0",
      "B02.1"
    ],
    "icd9_list": [
      "01.1"
    ]
  }
}

Response

Successful Response

idstring required
claim_idstring required
versioninteger required
created_atstring required
originstring
feedbackstring nullable

Example response

{
  "claim_id": "660e8400-e29b-41d4-a716-446655440001",
  "created_at": "2026-02-16T10:00:00Z",
  "feedback": "koreksi dari koder RS",
  "icd_inacbg": {
    "icd10_list": [
      "A01.0",
      "B02.1"
    ],
    "icd9_list": [
      "01.1"
    ]
  },
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "origin": "human",
  "version": 1
}

Changes

No recorded changes to this operation across all 1 revision of this API.