Freshness dashboard
Dashboard
GET /v1/freshness/dashboard returns aggregate counts:
total_sourcestotal_entitiesdue_in_24hby_state
Entity view
GET /v1/freshness/entities/:entity_id returns the source list plus a per-state summary for one entity.
Due queue
GET /v1/freshness/due returns the priority-sorted worklist for sources that need refresh.
Dashboard request
```bash
curl https://api.faircompany.ai/v1/freshness/dashboard \
-H "Authorization: Bearer fc_live_xxx"
```
```ts
const dashboard = await fc.freshness.dashboard();
console.log(dashboard.total_sources);
console.log(dashboard.by_state);
```
```python
import httpx
import os
api_key = os.environ.get("FAIRCRAWL_API_KEY", "fc_live_xxx")
response = httpx.get(
"https://api.faircompany.ai/v1/freshness/dashboard",
headers={"Authorization": f"Bearer {api_key}"},
timeout=30,
)
response.raise_for_status()
print(response.json()["by_state"])
```
```json
{
"tool": "faircrawl_freshness_check",
"arguments": {
"entity_id": "company_stripe"
}
}
```