Skip to main content
GET
/
v1
/
imports
/
contexts
/
{contextId}
/
jobs
/
{jobId}
Get ingestion job status
curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/jobs/{jobId} \
  --header 'Authorization: Bearer <token>'
{
  "completedAt": "2025-01-15T10:35:00.000Z",
  "contextId": "550e8400-e29b-41d4-a716-446655440000",
  "createdAt": "2025-01-15T10:30:00.000Z",
  "failedRows": 5,
  "fileName": "transactions_2024.csv",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "sourceId": "550e8400-e29b-41d4-a716-446655440000",
  "startedAt": "2025-01-15T10:30:00.000Z",
  "status": "PROCESSING",
  "totalRows": 1000
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication (format: "Bearer {token}")

Headers

​
X-Request-Id
string

A unique identifier for tracing the request across services.

Path Parameters

​
contextId
string
required

The unique identifier of the reconciliation context.

​
jobId
string
required

Job ID

Response

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

Ingestion job details

​
completedAt
string

When the job completed in RFC3339 format (if completed)

Example:

"2025-01-15T10:35:00.000Z"

​
contextId
string

Context ID this job belongs to

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
createdAt
string

Creation timestamp in RFC3339 format

Example:

"2025-01-15T10:30:00.000Z"

​
failedRows
integer

Number of rows that failed processing

Required range: x >= 0
Example:

5

​
fileName
string

Original file name

Example:

"transactions_2024.csv"

​
id
string

Unique identifier for the job

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
sourceId
string

Source ID this job ingests data into

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
startedAt
string

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

Example:

"2025-01-15T10:30:00.000Z"

​
status
enum<string>

Current status of the job

Available options:
QUEUED,
PROCESSING,
COMPLETED,
FAILED
Example:

"PROCESSING"

​
totalRows
integer

Total number of rows in the file

Required range: x >= 0
Example:

1000