---
title: "Dataset coverage statistics"
method: GET
path: "/coverage"
tags: ["Account"]
---

# Dataset coverage statistics

`GET /coverage`

## Request

- Base URL: `https://api.prometiam.com/functions/v1/risk-api`
- URL: `https://api.prometiam.com/functions/v1/risk-api/coverage`
- Auth: HTTP bearer

Returns dataset coverage statistics per country: total company count, event count, person count, appointment count, latest filing date, and data sources. Response is server-cached for ~1 hour.

## Response `200`

Coverage stats

- object
  - `data` Coverage
    - `countries` object[]
      - `code` string
      - `name` string
      - `total_companies` integer
      - `total_events` integer
      - `total_persons` integer
      - `total_appointments` integer
      - `total_contacts` integer
      - `latest_filing` string, date
      - `earliest_filing` string, date
      - `sources` string[]
      - `update_frequency` string
      - `data_as_of` string, date, nullable: Latest source publication date the pipeline has processed for this country, stamped by daily_pipeline.py after each successful sync (public.ingest_heartbeat, migration 220) — never a request-time MAX() over the physical tables. Null until a pipeline run first stamps it.
      - `last_synced_at` string, date-time, nullable: When the pipeline last completed a successful sync for this country. Same source as data_as_of; null until first written.
    - `total_records` integer
    - `last_updated` string, date-time
    - `risk_datasets` object: Per-dataset live counts. Always present in the response.
      - `tax_debt` object
      - `corporate_insolvency` object
      - `pep` object
  - `meta` object
    - `cached` boolean

## Other responses

- `401`: Missing, invalid, or expired API key
- `429`: Rate limit exceeded — see `Retry-After` header for seconds until reset

---

[API](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api.md) · [All operations](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api/revisions/fb8b4de5b18d?raw)