---
title: "Data source health"
description: "Lists health for every monitored OSINT source that has reported at least once: derived freshness status, expected cadence, staleness threshold, circuit-breaker state, and failure counts. Retired sources are omitted. Accepts a bearer API key or [x402 payment](https://y2.dev/docs/api/x402). Without a key, read the `402` challenge in `PAYMENT-REQUIRED`. Retry with `PAYMENT-SIGNATURE`."
canonical: https://y2.dev/docs/api/reference/osint/listSourceStatus/
---

Endpoint Reference[OSINT](https://y2.dev/docs/api/reference/osint)

# Data source health

Lists health for every monitored OSINT source that has reported at least once: derived freshness status, expected cadence, staleness threshold, circuit-breaker state, and failure counts. Retired sources are omitted. Accepts a bearer API key or \[x402 payment]\(https\://y2.dev/docs/api/x402). Without a key, read the \`402\` challenge in \`PAYMENT-REQUIRED\`. Retry with \`PAYMENT-SIGNATURE\`.

`GET https://api.y2.dev/api/v1/osint/sources/status`

- Operation ID: `listSourceStatus`
- Required scopes: `osint:read`
- Accepts x402 pay-per-request payment
- Contract: https://y2.dev/openapi.json

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | Data source health statuses | `SourceStatusListResponse` |
| 401 | Missing or invalid API key |  |
| 402 | x402 payment required | `X402PaymentRequiredResponse` |
| 403 | Insufficient permissions or access denied |  |
| 429 | Rate limit exceeded (per-key or per-account aggregate) |  |
| 500 | Internal server error |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data[]` | array of `SourceStatus` |  |
| `data[].source` | `RecordSource` | Where a record came from, how Y2 obtained it, and when. |
| `data[].sourceType` | string | Data source identifier |
| `data[].status` | `healthy`, `degraded`, `stale`, `unavailable`, `unknown` | Source health. `healthy` means the source succeeded within `staleAfterSeconds`; an untripped circuit breaker whose last success is older reports `stale`. Use this field, not `state`, to judge freshness. |
| `data[].lastSuccessfulIngestAt` | string or null (date-time) | Last successful ingest time, or null if the source has never succeeded |
| `data[].expectedCadenceSeconds` | integer | How often the source is expected to refresh |
| `data[].staleAfterSeconds` | integer | Age of the last success after which the source reports `stale` |
| `data[].state` | `closed`, `open`, `half_open` | Circuit breaker state. `closed` means requests are not being blocked; it does not mean the source is fresh. |
| `data[].failureCount` | integer | Number of consecutive failures |
| `data[].lastSuccessAt` | integer (int64) | Last successful fetch time (milliseconds) |
| `data[].lastSuccessAtISO` | string or null (date-time) | Last successful fetch time as ISO 8601 string |
| `data[].lastFailureAt` | integer (int64) | Last failure time (milliseconds) |
| `data[].lastFailureAtISO` | string or null (date-time) | Last failure time as ISO 8601 string |
| `data[].lastError` | string | Most recent error message |
| `meta` | object |  |
| `meta.count` | integer |  |
