Clinia
API ReferenceREST API

List ingest executions

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

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.

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}$

Query Parameters

limit?integer

Maximum number of executions to return per page. Defaults to 50; maximum is 200.

Default50
Range0 < value <= 200
cursor?|

Pagination cursor returned as nextCursor from the previous page. Omit to start from the most recent execution.

Response Body

application/json

curl -X GET "https://example.com/v1/patients/patient-123/ingest/executions"
{
  "executions": [
    {
      "id": "string",
      "sourceLabel": "fhir",
      "status": "pending",
      "startedAt": 0,
      "finishedAt": 0,
      "payloadHash": "string",
      "deltasSummary": {
        "entitiesAdded": 0,
        "eventsAdded": 0,
        "relsAdded": 0
      },
      "llmCallsUsed": 0,
      "errorCode": "string",
      "skippedReason": "string"
    }
  ],
  "nextCursor": 0
}

Get ingest status GET

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.

Get ingest execution GET

Returns full detail for a single ingest execution: stage-level timings, per-entity-type and per-source delta breakdowns, entity merge count, extraction warnings, and error detail if failed.