---
title: "Single-country data freshness"
method: GET
path: "/v1/health/{country_code}"
tags: ["Health"]
---

# Single-country data freshness

`GET /v1/health/{country_code}`

## Request

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

Freshness status (ok / warning / stale / no_data / not_covered) for every data domain in ONE country — the same computation as get_health, scoped down. Check it before a bulk pull, or when a query comes back thinner than expected: a `stale` domain means the ingestion pipeline is behind, not that you queried wrong, and it is the difference between reporting 'nothing was filed' and 'Dapper has not ingested anything recent here'. No API key required.

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.

## Path parameters

- `country_code` string, required: ISO 3166-1 alpha-2 country code (e.g. BR, CO, MX). The legacy numeric id (e.g. 8) is also accepted. See GET /v1/countries for the full list.

## 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

## Other responses

- `422`: Validation Error

---

[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)