Sign in

v1

latestOpenAPI 3.1.02026-07-263644911022.4 KB
Discovery

Get an extraction request

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

get/v1/discovery/extractions/{extractionId}

Path parameters

extractionIdstring required

The unique identifier of the extraction request.

Headers

X-Request-Idstring

A unique identifier for tracing the request across services.

Response

Extraction request details

idstring

Internal identifier for the extraction request

connectionIdstring

Connection this extraction was submitted to

statusstring

Current lifecycle status of the extraction

ingestionJobIdstring

Job identifier returned by Fetcher

startDatestring

Start of the extracted date range

endDatestring

End of the extracted date range

tablesobject

Per-table extraction status

errorMessagestring

Error details if the extraction failed

createdAtstring

Timestamp when the extraction was requested

updatedAtstring

Timestamp of the last status update

bridgeAttemptsinteger

Number of times the Matcher bridge pipeline has attempted to retrieve and ingest this extraction

bridgeLastErrorstring

Error class of the last bridge pipeline failure

bridgeLastErrorMessagestring

Appended-history error message from the bridge pipeline; primary failure stays at the head

bridgeFailedAtstring date-time nullable

Timestamp of the first terminal bridge failure; omitted when no failure has occurred

custodyDeletedAtstring date-time nullable

Timestamp when the custody object was deleted; omitted when still held