Skip to main content
GET
/
v1
/
ingest
/
runs
List ingest runs
curl --request GET \
  --url https://api.withsplendor.com/v1/ingest/runs \
  --header 'Authorization: Bearer <token>' \
  --header 'x-splendor-tenant-id: <x-splendor-tenant-id>'
{
  "runs": [
    {
      "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.

Query Parameters

source_id
integer | null
dataset_id
string | null
status
enum<string> | null
Available options:
uploading,
queued,
processing,
text_indexed,
semantic_pending,
ready,
failed,
aborted,
deleted,
superseded
include_non_current
boolean
default:false
limit
integer
default:100
Required range: 1 <= x <= 1000

Response

Successful Response

runs
IngestRunReadinessResponse · object[]
required