Get an extraction request

Use this endpoint to retrieve the details of a specific extraction request by its identifier.

GET /v1/discovery/extractions/{extractionId}

Get an extraction request

cURL

curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/discovery/extractions/{extractionId} \
  --header 'Authorization: Bearer <token>'

200

Example

{ "connectionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "createdAt": "2026-06-17T14:32:05Z", "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "status": "pending", "tables": {}, "updatedAt": "2026-06-17T14:32:05Z", "endDate": "2026-06-30", "errorMessage": "<string>", "filters": { "equals": {} }, "ingestionJobId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "startDate": "2026-06-01" }

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 ruta

extractionId · string<uuid> · requerido

The unique identifier of the extraction request. Extraction ID (UUID)

Ejemplo:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

Respuesta

200

application/json

Extraction request details

connectionId · string · requerido

Connection the extraction runs against

Ejemplo:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

createdAt · string<date-time> · requerido

Timestamp the extraction request was created (RFC 3339)

Ejemplo:

"2026-06-17T14:32:05Z"

id · string · requerido

Internal extraction request identifier

Ejemplo:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

status · string · requerido

Current lifecycle status of the extraction request

Ejemplo:

"pending"

tables · object · requerido

Per-table extraction configuration keyed by table name

Show child attributes

updatedAt · string<date-time> · requerido

Timestamp the extraction request was last updated (RFC 3339)

Ejemplo:

"2026-06-17T14:32:05Z"

endDate · string

Inclusive end date of the extracted range (RFC 3339)

Ejemplo:

"2026-06-30"

errorMessage · string

Sanitized error message when the extraction failed; empty otherwise

filters · object

Extraction filters applied to the request, when set

Show child attributes

ingestionJobId · string

Ingestion job created from the extracted data, once available

Ejemplo:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

startDate · string

Inclusive start date of the extracted range (RFC 3339)

Ejemplo:

"2026-06-01"