List export jobs

Use this endpoint to retrieve all export jobs for the authenticated tenant.

GET /v1/export-jobs

List export jobs

cURL

curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/export-jobs \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "hasMore": true,
  "items": [
    {
      "bytesWritten": 524288,
      "contextId": "550e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2025-01-15T10:30:00Z",
      "expiresAt": "2025-01-16T10:30:00Z",
      "format": "CSV",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "recordsWritten": 4250,
      "reportType": "MATCHED",
      "status": "SUCCEEDED",
      "downloadUrl": "/v1/export-jobs/550e8400-e29b-41d4-a716-446655440000/download",
      "error": "timeout exceeded",
      "fileName": "matched_report_2025-01-31.csv",
      "finishedAt": "2025-01-15T10:35:00Z",
      "startedAt": "2025-01-15T10:30:05Z"
    }
  ],
  "limit": 20,
  "nextCursor": "eyJpZCI6IjEyMyJ9"
}

Autorizaciones

Authorization · string · header · requerido

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

Encabezados

X-Request-Id · string

A unique identifier for tracing the request across services.

Parámetros de consulta

status · string

Filter by status (QUEUED, RUNNING, SUCCEEDED, FAILED, EXPIRED, CANCELED)

cursor · string

Cursor for pagination (opaque)

limit · integer<int64> · predeterminado: 20

Maximum number of jobs to return (default 20, max 100) Maximum number of records to return

Rango requerido: 1 <= x <= 200

Respuesta

200

application/json

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

hasMore · boolean · requerido

True when another page is available (nextCursor is non-empty).

Ejemplo:

true

items · object[] | null · requerido

Export jobs in the current page, newest first.

Maximum array length: 200

Show child attributes

limit · integer<int64> · requerido

Page size applied to this response.

Rango requerido: 1 <= x <= 200

Ejemplo:

20

nextCursor · string

Opaque forward-only cursor; pass it as the cursor query param to fetch the next page. Empty when there are no further pages.

Ejemplo:

"eyJpZCI6IjEyMyJ9"