Skip to main content
GET
/
v1
/
ingest
/
runs
/
{ingest_run_id}
Get an ingest run
curl --request GET \
  --url https://api.withsplendor.com/v1/ingest/runs/{ingest_run_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'x-splendor-tenant-id: <x-splendor-tenant-id>'
{
  "bucket": "acme-logs",
  "completed_at": "2026-01-15T09:30:00Z",
  "connector_run_id": null,
  "created_at": "2026-01-15T09:30:00Z",
  "dataset_id": "app-logs",
  "documents": {
    "expected": 1240000,
    "index_committed": 1240000,
    "parsed": 1240000,
    "schema_observed": 1240000,
    "semantic_embedded": 1240000,
    "semantic_total": 1240000
  },
  "error_code": null,
  "error_message": null,
  "etag": "\"9b2cf5e1\"",
  "failed_at": null,
  "ingest_failure_id": null,
  "ingest_run_id": "ing_01H8Z3",
  "input_kind": "hosted_upload",
  "key": "2026/01/15/app-0001.jsonl.gz",
  "lifecycle": {
    "reasons": [],
    "repairable": false,
    "state": "ready"
  },
  "queued_at": "2026-01-15T09:30:00Z",
  "ready_for": {
    "semantic_search": true,
    "sql_search": true,
    "text_search": true
  },
  "reindex_job_id": null,
  "semantic_ready_at": "2026-01-15T09:30:00Z",
  "source_id": 12,
  "started_at": "2026-01-15T09:30:00Z",
  "status": "ready",
  "tenant_id": "acme",
  "text_indexed_at": "2026-01-15T09:30:00Z",
  "updated_at": "2026-01-15T09:30:00Z",
  "upload_session_id": "ups_01H8Z3"
}

Authorizations

Authorization
string
header
required

API token issued from the Splendor console.

Headers

x-splendor-tenant-id
string
required

Selects the tenant (workspace) the request acts within.

Path Parameters

ingest_run_id
string
required

Response

Successful Response

bucket
string
required
completed_at
string<date-time> | null
required
connector_run_id
integer | null
required
created_at
string<date-time>
required
dataset_id
string
required
documents
IngestReadinessDocumentCounts · object
required
error_code
string | null
required
error_message
string | null
required
etag
string | null
required
failed_at
string<date-time> | null
required
ingest_failure_id
integer | null
required
ingest_run_id
string
required
input_kind
string
required
key
string
required
lifecycle
IngestLifecycleDiagnostic · object
required
queued_at
string<date-time> | null
required
ready_for
IngestReadinessReadyFor · object
required
reindex_job_id
string | null
required
semantic_ready_at
string<date-time> | null
required
source_id
integer
required
started_at
string<date-time> | null
required
status
string
required
tenant_id
string
required
text_indexed_at
string<date-time> | null
required
updated_at
string<date-time>
required
upload_session_id
string | null
required