List Fetcher bridge readiness candidates

Returns extractions in the requested readiness state with cursor pagination. Drilldown surface for the operational dashboard summary.

GET /v1/discovery/extractions/bridge/candidates

List Fetcher bridge readiness candidates

cURL

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

200

{
  "items": [
    {
      "extractionId": "123e4567-e89b-12d3-a456-426614174000",
      "connectionId": "123e4567-e89b-12d3-a456-426614174001",
      "status": "COMPLETED",
      "readinessState": "ready",
      "createdAt": "2025-01-01T00:00:00Z",
      "updatedAt": "2025-01-01T01:00:00Z",
      "ageSeconds": 3600,
      "ingestionJobId": "123e4567-e89b-12d3-a456-426614174002",
      "fetcherJobId": "fetcher-job-abc123",
      "bridgeLastError": "integrity_failed"
    }
  ],
  "state": "ready",
  "limit": 50,
  "nextCursor": "eyJjIjoiMjAyNS0wMS0wMVQwMDowMDowMFoiLCJpIjoiMTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDAwIn0="
}

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.

Query Parameters

state · enum<string> · required

Readiness state filter: pending, ready, stale, failed, or in_flight

Available options: pending, ready, stale, failed, in_flight

cursor · string

Opaque pagination cursor returned by the previous response.

limit · integer · default: 50

Page size (default 50, max 200)

Required range: 1 <= x <= 200

Response

200

application/json

Page of bridge candidates

A cursor-paginated page of bridge readiness candidates.

items · object[] · required

List of bridge candidates for the current page.

Show child attributes

state · string · required

The readiness state filter applied to this page.

Example:

"ready"

limit · integer · required

The page size used for this response.

Example:

50

nextCursor · string

Opaque cursor for fetching the next page. Absent when no more pages exist.

Example:

"eyJjIjoiMjAyNS0wMS0wMVQwMDowMDowMFoiLCJpIjoiMTIzZTQ1NjctZTg5Yi0xMmQzLWE0NTYtNDI2NjE0MTc0MDAwIn0="