---
title: "Poll a SOAP analysis (status: processing | completed | failed)"
method: GET
path: "/api/v3/soap/analysis/{analysis_id}"
tags: ["Open API", "SOAP Validation"]
---

# Poll a SOAP analysis (status: processing | completed | failed)

`GET /api/v3/soap/analysis/{analysis_id}`

## Request

- Base URL: `https://developer.claimmind.life` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.claimmind.life/api/v3/soap/analysis/{analysis_id}`
- Auth: none declared. Required headers: `X-API-Key`

## Path parameters

- `analysis_id` string, required

## Headers

- `X-API-Key` string, required

## Response `200`

Successful Response

- SoapAnalysisPollResponse: Single DB-authoritative status response with the three SOAP results.
  - `analysis_id` string, required: Run handle
  - `episode_id` string, nullable
  - `workflow_id` string, nullable
  - `cppt_types` string, nullable
  - `version` integer, nullable
  - `status` string, required: processing | completed | failed
  - `phase` string, nullable: Current pipeline phase
  - `progress_current` integer, nullable: Steps completed
  - `progress_total` integer, nullable: Total steps
  - `error_message` string, nullable: Failure detail when status='failed'
  - `coding_result` union
    - SoapCodingResult: Public scored SOAP coding result returned by the poll endpoint.
      - `schema_version` integer, required: Public coding result schema version
      - `status` string, required: Coding result status
      - `data` SoapCodingData, required: Public IDRG and INA-CBG coding recommendations.
        - `idrg` SoapCodingBranch, required: Public diagnosis and procedure recommendations for one grouper branch.
          - `diagnoses` SoapCodingItem[]: Diagnosis recommendations
            - `code` string, required: ICD-10 / ICD-9 code
            - `description` string: Human-readable description
            - `score` number, nullable: Weighted percentage of applicable VALID and NOT_FOUND rules
            - `coverage` number, nullable: Percentage of applicable rules with VALID status
          - `procedures` SoapCodingItem[]: Procedure recommendations
            - `code` string, required: ICD-10 / ICD-9 code
            - `description` string: Human-readable description
            - `score` number, nullable: Weighted percentage of applicable VALID and NOT_FOUND rules
            - `coverage` number, nullable: Percentage of applicable rules with VALID status
        - `inacbg` SoapCodingBranch, required: Public diagnosis and procedure recommendations for one grouper branch.
          - `diagnoses` SoapCodingItem[]: Diagnosis recommendations
            - `code` string, required: ICD-10 / ICD-9 code
            - `description` string: Human-readable description
            - `score` number, nullable: Weighted percentage of applicable VALID and NOT_FOUND rules
            - `coverage` number, nullable: Percentage of applicable rules with VALID status
          - `procedures` SoapCodingItem[]: Procedure recommendations
            - `code` string, required: ICD-10 / ICD-9 code
            - `description` string: Human-readable description
            - `score` number, nullable: Weighted percentage of applicable VALID and NOT_FOUND rules
            - `coverage` number, nullable: Percentage of applicable rules with VALID status
      - `warning_codes` unknown[]: Non-fatal coding warnings
        - unknown
      - `error` unknown
    - object
  - `validation_result` object, nullable
  - `tariff_result` SoapTariffResultEnvelope: Public v1 tariff result returned by the SOAP polling endpoint.
    - `schema_version` 1, required
    - `status` 'completed' | 'completed_degraded', required
    - `data` SoapTariffResultData, required: Provider-owned tariff branches plus the canonical shared profile.
      - `inacbg` object, nullable, required
      - `idrg` object, nullable, required
      - `tariff_profile` object, nullable, required
      - `provisional` boolean, required
    - `warning_codes` string[], required
    - `error` unknown, required
    - `started_at` string, nullable
    - `finished_at` string, nullable
    - `duration_ms` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/claimmind/apis/claimmind-open-api-service.md) - [All operations](https://skmtc.dev/claimmind/apis/claimmind-open-api-service/llms.txt) - [OpenAPI document](https://skmtc.dev/claimmind/apis/claimmind-open-api-service/revisions/ee8bfbeadb8a?raw)