> ## Documentation Index
> Fetch the complete documentation index at: https://docs.junction.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Validate ICD Codes

> Check ICD-10-CM codes for unknown or inactive codes, missing primary diagnoses, and conflicting code combinations before ordering.

```bash cURL theme={null}
curl --request POST \
     --url 'https://api.us.junction.com/v3/insurance/validate_icd_codes' \
     --header 'Content-Type: application/json' \
     --header 'x-vital-api-key: YOUR_API_KEY' \
     --data '{"codes": ["G93.3"]}'
```

```json "Unknown or inactive code" theme={null}
{
  "valid": false,
  "errors": ["Unknown or inactive codes: G93.3"],
  "violations": [],
  "warnings": []
}
```


## OpenAPI

````yaml POST /v3/insurance/validate_icd_codes
openapi: 3.1.0
info:
  title: Junction API
  description: https://docs.junction.com/
  version: 0.5.10
servers:
  - url: https://api.us.junction.com
    x-fern-server-name: Production
  - url: https://api.eu.junction.com
    x-fern-server-name: ProductionEU
  - url: https://api.sandbox.us.junction.com
    x-fern-server-name: Sandbox
  - url: https://api.sandbox.eu.junction.com
    x-fern-server-name: SandboxEU
security:
  - apiKeyAuth: []
paths:
  /v3/insurance/validate_icd_codes:
    post:
      tags:
        - insurance
      summary: Validate Icd Codes
      operationId: validate_icd_codes_v3_insurance_validate_icd_codes_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ValidateICDCodesBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidateICDCodesResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidateICDCodesBody:
      properties:
        codes:
          items:
            type: string
          type: array
          title: Codes
      type: object
      required:
        - codes
      title: ValidateICDCodesBody
    ValidateICDCodesResponse:
      properties:
        valid:
          type: boolean
          title: Valid
        errors:
          items:
            type: string
          type: array
          title: Errors
        violations:
          items:
            $ref: '#/components/schemas/ICDExcludesViolation'
          type: array
          title: Violations
        warnings:
          items:
            $ref: '#/components/schemas/ICDExcludesWarning'
          type: array
          title: Warnings
      type: object
      required:
        - valid
        - errors
        - violations
        - warnings
      title: ValidateICDCodesResponse
    HTTPValidationError:
      properties:
        detail:
          title: Detail
      type: object
      title: HTTPValidationError
    ICDExcludesViolation:
      properties:
        code:
          type: string
          title: Code
        conflicts_with:
          type: string
          title: Conflicts With
        type:
          type: string
          title: Type
      type: object
      required:
        - code
        - conflicts_with
        - type
      title: ICDExcludesViolation
    ICDExcludesWarning:
      properties:
        code:
          type: string
          title: Code
        overlaps_with:
          type: string
          title: Overlaps With
        type:
          type: string
          title: Type
      type: object
      required:
        - code
        - overlaps_with
        - type
      title: ICDExcludesWarning
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-vital-api-key
      description: Vital Team API Key

````

## Related topics

- [Insurance Ordering](https://docs.junction.com/lab/overview/insurance.md)
- [Search ICD Codes](https://docs.junction.com/api-reference/lab-testing/insurance/search-diagnosis.md)
- [Create Code](https://docs.junction.com/api-reference/link/create-code.md)
- [Hosting OAuth Callbacks on Your Own Domain](https://docs.junction.com/wearables/connecting-providers/bring-your-own-oauth/callback-endpoints.md)
- [Lab Report Parsing](https://docs.junction.com/lab/report-parsing/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.