Public Data

Citable country answer for fetching agents

Changed on

A short, dated, citable answer for one country: the censorship index score with its data time, the latest citable incidents (up to 5, newest first by start time) with readable IDs and links, and what the answer does not know. Plain text by default; add ?format=json for JSON (schema voidly.answer.country.v1). It includes no per-domain check and no risk score (where Voidly publishes one, it is an experimental current-regime score; shutdown-onset timing is unproven). A complete answer is cached at the edge for up to 300 seconds, and Cache-Control max-age counts down from its build time; an answer with one source unavailable is served with no-store. Only a cold build (an edge-cache miss) counts toward the per-IP limit of 30 per minute. Send If-None-Match with a prior ETag to get 304.

get/v1/answers/country/{country}

Request

  • Base URL
    https://api.voidly.ai
  • URL
    https://api.voidly.ai/v1/answers/country/{country}
  • Auth
    none required

Path parameters

countrystring required

ISO 3166-1 alpha-2 country code (case-insensitive).

Query parameters

format'text' | 'json'

text (default) or json. Any other value, or more than one, returns 400 INVALID_FORMAT.

Headers

If-None-Matchstring

A prior ETag; a match returns 304.

Response

Country answer.

schema'voidly.answer.country.v1' required
answeredAtstring date-time required

When this answer was built.

permalinkstring required
notKnownstring[] required
citationstring required
howToUsestring required

Changes