Clinia
API ReferenceREST API

Get ingest execution

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

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.

Path Parameters

patientId*string

Registry key of the patient.

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

Unique execution ID returned in the IngestExecutionEnvelope or execution list.

Length1 <= length

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/patients/patient-123/ingest/executions/01HZ..."
{
  "execution": {
    "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"
  },
  "stageTimings": {
    "property1": 0,
    "property2": 0
  },
  "deltasFull": {
    "byEntityType": {
      "property1": 0,
      "property2": 0
    },
    "bySource": {
      "property1": {
        "entitiesAdded": 0,
        "eventsAdded": 0,
        "relsAdded": 0
      },
      "property2": {
        "entitiesAdded": 0,
        "eventsAdded": 0,
        "relsAdded": 0
      }
    },
    "entitiesMerged": 0
  },
  "warnings": [
    {
      "source": "string",
      "id": "string",
      "message": "string",
      "severity": "info"
    }
  ],
  "errorDetail": {
    "code": "string",
    "message": "string",
    "detail": "string"
  }
}
{
  "code": 1,
  "type": "ALREADY_EXISTS",
  "message": "string"
}

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.

Create session POST

Opens a new query session scoped to a patient. Sessions track interaction context across multiple MCP tool calls within a single agent run.