Clinia
API ReferenceREST API

Get ingest status

GET
/v1/patients/{patientId}/ingest/status

Returns whether the patient graph is ready to query, per-source extraction stats, aggregate load stats, and extraction warnings that did not halt ingestion. Poll this endpoint after a fire-and-forget ingest call.

Path Parameters

patientId*string

Registry key of the patient, as assigned by the caller when the first ingest was submitted.

Match^[A-Za-z0-9._-]{1,128}$

Response Body

application/json

curl -X GET "https://example.com/v1/patients/patient-123/ingest/status"
{
  "ready": true,
  "sources": [
    {
      "label": "string",
      "stats": {
        "itemsScanned": 0
      }
    }
  ],
  "patient": {
    "id": "string",
    "name": "string"
  },
  "loadStats": {
    "entitiesExtracted": 0,
    "eventsExtracted": 0,
    "relationshipsExtracted": 0
  },
  "loadMs": 0
}

Batch ingest POST

Submits FHIR bundles, CDA documents, and unstructured document registrations in a single request. Each source type is processed independently; the graph is rebuilt once after all sources are loaded.

List ingest executions GET

Returns a cursor-paginated list of ingest executions for a patient, ordered by start time descending. Each item includes status, source type, delta counts, and error code if failed.