---
title: "Get FHIR Push transaction status"
method: GET
path: "/api/v1/fhir-push/status/{transaction_id}"
tags: ["/api/v1/fhir-push"]
---

# Get FHIR Push transaction status

`GET /api/v1/fhir-push/status/{transaction_id}`

## Request

- Base URL: `https://sdp.suki.ai`
- URL: `https://sdp.suki.ai/api/v1/fhir-push/status/{transaction_id}`
- Auth: API key in header `sdp_suki_token`

Poll the ingestion status for a FHIR bundle upload transaction. This is Step 3 of the CKG Data Ingestion workflow. Use the `transaction_id` returned from GET /api/v1/fhir-push/upload-url. Status values: CREATED (transaction created, awaiting upload), READY (bundle uploaded, queued for processing), RUNNING (actively ingesting), COMPLETED (successfully ingested into CKG), FAILED (processing error, see error field), ARCHIVED (upload not received within the allowed window). Poll at reasonable intervals (e.g., every 5 seconds) and stop once you receive a terminal status (COMPLETED, FAILED, or ARCHIVED). Transaction status is retained for 7 days after the last update.

## Path parameters

- `transaction_id` string, required

## Response `200`

Transaction status returned successfully.

- object
  - `transaction_id` string, required: Unique identifier for this ingestion transaction.
  - `organization_id` string: Your partner organization ID for this organization. It can be a UUID or non-UUID string. But not a Suki UUID.
  - `correlation_id` string: Client-supplied or server-generated correlation ID for tracing.
  - `status` string, required: Current transaction status: CREATED | READY | RUNNING | COMPLETED | FAILED | ARCHIVED
  - `created_at` string, date-time, required: RFC 3339 timestamp when the transaction was created.
  - `updated_at` string, date-time: RFC 3339 timestamp of the last status update.
  - `completed_at` string, date-time, nullable: RFC 3339 timestamp when processing completed (present for terminal statuses).
  - `error` string, nullable: Error details when the transaction status is FAILED; otherwise null.

## Other responses

- `401`: Unauthorized. Invalid or missing sdp_suki_token.
- `403`: Forbidden. Token lacks required scopes or access to the organization.
- `404`: Not Found. Unknown transaction_id or retention window exceeded.
- `500`: Internal server error.

## Changes

- **2026-11-03** `2181be71d4dd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/suki/apis/suki-developer-platform/changes/api/v1/fhir-push/status/:transaction_id/get.md)

---

[API](https://skmtc.dev/suki/apis/suki-developer-platform.md) - [All operations](https://skmtc.dev/suki/apis/suki-developer-platform/llms.txt) - [OpenAPI document](https://skmtc.dev/suki/apis/suki-developer-platform/revisions/2181be71d4dd?raw)