Skip to main content
GET
/
v1
/
discovery
/
extractions
/
bridge
/
candidates
List Fetcher bridge readiness candidates
curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/discovery/extractions/bridge/candidates \
  --header 'Authorization: Bearer <token>'
{
  "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="
}

Documentation Index

Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt

Use this file to discover all available pages before exploring further.

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

Page of bridge candidates

A cursor-paginated page of bridge readiness candidates.

​
items
object[]
required

List of bridge candidates for the current page.

​
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="