---
title: "GET /api/v1/fhir-push/upload-url?organization_id={uuid}&correlation_id={optional}"
method: GET
path: "/api/v1/fhir-push/upload-url"
tags: ["/api/v1/fhir-push"]
---

# GET /api/v1/fhir-push/upload-url?organization_id={uuid}&correlation_id={optional}

`GET /api/v1/fhir-push/upload-url`

## Request

- Base URL: `https://sdp.suki.ai`
- URL: `https://sdp.suki.ai/api/v1/fhir-push/upload-url`
- Auth: API key in header `sdp_suki_token`

Request a pre-signed upload URL for uploading a FHIR bundle to Suki's Clinical Knowledge Graph (CKG) ingestion pipeline. This is Step 1 of the three-step CKG Data Ingestion workflow. The returned `upload_url` is valid for 15 minutes and accepts a PUT request with your FHIR bundle JSON (max 500 MB). Use the `transaction_id` from the response to poll processing status via GET /api/v1/fhir-push/status/{transaction_id}. FHIR data ingested through this API powers Patient Summary generation. Include consistent patient, encounter, and practitioner identifiers in your FHIR resources so they match the `fhir_encounter_id` and `fhir_practitioner_id` values used for generation and retrieval.

## Query parameters

- `organization_id` string, required
- `correlation_id` string

## Response `200`

Upload URL returned successfully.

- object
  - `transaction_id` string, required: Unique identifier for this upload transaction.
  - `upload_url` string, required: Pre-signed URL to PUT your FHIR bundle to (expires in ~15 minutes).
  - `expires_at` string, date-time, required: RFC 3339 timestamp when the upload_url expires.
  - `correlation_id` string: Echo of client-supplied correlation_id or server-generated value.

## Other responses

- `400`: Bad request. Missing or invalid query parameters.
- `401`: Unauthorized. Missing or invalid sdp_suki_token.
- `403`: Forbidden. Token lacks required scopes or access to the organization.
- `404`: Not found. The requested resource or organization was not found.
- `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/upload-url/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)