---
title: "Global data freshness"
method: GET
path: "/v1/health"
tags: ["Health"]
---

# Global data freshness

`GET /v1/health`

## Request

- Base URL: `https://api.dapperglobal.com`
- URL: `https://api.dapperglobal.com/v1/health`
- Auth: none declared

Freshness status (ok / warning / stale / no_data / not_covered) per reported domain, per country. Check this before a bulk pull or when a query looks stale — a `stale` domain means the underlying ingestion pipeline is behind, not that you're querying wrong.

Domains not listed here are withheld, not empty: votes, interventions have data but too little of it for a freshness claim to mean anything, so they are omitted until their ingestion improves. Query their endpoints directly.

`not_covered` means Dapper has no source for that domain in that country (for example consultations in PE, AR, VE, GT and DO): say the domain is not covered there, not that ingestion is behind. Each status is measured against that country's own publishing rhythm, so a congress that publishes weekly is not `stale` mid-week.

`search_corpus` is separate from freshness: it says how much of each domain is in the SEMANTIC index for that country. A domain absent from it has zero indexed documents, so `q` there is a plain title match — use the record listings (date, entity, code filters) instead of concluding a topic is absent. A null `search_corpus` means the summary was unavailable, not that coverage is zero.

## Response `200`

Successful Response

- HealthResponse
  - `countries` CountryHealth[], required
    - `country_code` string, required
    - `country_id` integer, nullable
    - `country_name` string, required
    - `dapper_url` string, nullable
    - `domains` object, required
    - `search_corpus` object, nullable
  - `generated_at` string, date-time, required

---

[API](https://skmtc.dev/dapperglobal/apis/dapper-political-intelligence-api.md) · [All operations](https://skmtc.dev/dapperglobal/apis/dapper-political-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dapperglobal/apis/dapper-political-intelligence-api/revisions/f34d9e6a2b0e?raw)