Sign in

v1

latestOpenAPI 3.1.02026-07-263644911022.4 KB
Ingestion

Get ingestion job status

Use this endpoint to retrieve the status and details of a specific ingestion job by its identifier. The response includes progress metrics and error information.

get/v1/imports/contexts/{contextId}/jobs/{jobId}

Path parameters

contextIdstring required

The unique identifier of the reconciliation context.

jobIdstring required

Job ID

Headers

X-Request-Idstring

A unique identifier for tracing the request across services.

Response

Indicates that the request was successful and the response contains the expected data.

completedAtstring

When the job completed in RFC3339 format (if completed)

contextIdstring

Context ID this job belongs to

createdAtstring

Creation timestamp in RFC3339 format

failedRowsinteger

Number of rows that failed processing

fileNamestring

Original file name

idstring

Unique identifier for the job

sourceIdstring

Source ID this job ingests data into

startedAtstring

When the job started in RFC3339 format (null for QUEUED jobs)

status'QUEUED' | 'PROCESSING' | 'COMPLETED' | 'FAILED'

Current status of the job

totalRowsinteger

Total number of rows in the file

Example response

{
  "completedAt": "2025-01-15T10:35:00.000Z",
  "contextId": "019c96a0-10a0-72d2-9fb0-2b7de8093182",
  "createdAt": "2025-01-15T10:30:00.000Z",
  "failedRows": 5,
  "fileName": "transactions_2024.csv",
  "id": "019c96a0-10ce-75fc-a273-dc799079a99c",
  "sourceId": "019c96a0-108c-7a74-8e31-3789daffe1ed",
  "startedAt": "2025-01-15T10:30:00.000Z",
  "status": "PROCESSING",
  "totalRows": 1000
}