Skip to main content
GET
/
v1
/
discovery
/
extractions
/
bridge
/
summary
Get Fetcher bridge readiness summary
curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/discovery/extractions/bridge/summary \
  --header 'Authorization: Bearer <token>'
{
  "readyCount": 10,
  "pendingCount": 5,
  "staleCount": 2,
  "failedCount": 1,
  "inFlightCount": 3,
  "totalCount": 21,
  "staleThresholdSec": 3600,
  "generatedAt": "2025-01-01T00:00:00Z",
  "workerHealthy": true,
  "workerLastTickAt": "2025-01-01T00:00:00Z",
  "workerStalenessSeconds": 120
}

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.

Response

Aggregate readiness counts

Aggregate counts of Fetcher extractions partitioned by bridge readiness state for the requesting tenant.

​
readyCount
integer<int64>
required

Number of extractions in the ready state.

Example:

10

​
pendingCount
integer<int64>
required

Number of extractions in the pending state.

Example:

5

​
staleCount
integer<int64>
required

Number of extractions in the stale state.

Example:

2

​
failedCount
integer<int64>
required

Number of extractions in the failed state.

Example:

1

​
inFlightCount
integer<int64>
required

Number of upstream extractions still running (PENDING/SUBMITTED/EXTRACTING).

Example:

3

​
totalCount
integer<int64>
required

Total count of extractions (sum of all buckets).

Example:

21

​
staleThresholdSec
integer<int64>
required

The staleness threshold in seconds used to partition extractions.

Example:

3600

​
generatedAt
string<date-time>
required

Timestamp when the summary was generated.

Example:

"2025-01-01T00:00:00Z"

​
workerHealthy
boolean
required

Server-side verdict on whether the bridge worker is healthy.

Example:

true

​
workerLastTickAt
string<date-time> | null

Latest cycle timestamp written by any bridge worker replica. Omitted when no heartbeat has been observed.

Example:

"2025-01-01T00:00:00Z"

​
workerStalenessSeconds
integer<int64> | null

Seconds since the last worker heartbeat. Omitted alongside workerLastTickAt.

Example:

120