Skip to main content
GET
cURL
Use this endpoint to generate a pre-signed upload URL for your FHIR bundle. This is Step 1 of the CKG data ingestion workflow. The response includes:
  • upload_url: A Google Cloud Storage pre-signed URL that is valid for 15 minutes and can be used to upload the FHIR bundle.
  • transaction_id: A unique identifier for the ingestion job. Use this value to check the ingestion status in Step 3.
To generate accurate Patient Summaries, 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.

CKG data ingestion steps

Once you have the upload URL, use it to upload your FHIR bundle and check the ingestion status by using the following endpoints:

Authorizations

sdp_suki_token
string
header
required

Suki access token (suki_token) from Login or Register. Expires after one hour.

Query Parameters

organization_id
string
required

Your organization UUID provided during onboarding (required).

correlation_id
string

Optional client-defined identifier for ordering or correlating uploads (max 128 chars). If omitted the server generates one.

Maximum string length: 128

Response

Upload URL returned successfully.

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.

Last modified on August 7, 2026