# latamref - Latin American Government Reference Data History

> latamref - Latin American Government Reference Data History is a paid API for AI agents from latamref.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns the historical time series of a specific government reference data series (e.g. policy rate, VAT, minimum wage) for a given Latin American country

## Facts

- Endpoint: GET https://latamref.dev/v1/:country/:series/history
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/latamref-latin-american-government-reference-data-history-f974979e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_I83-B32cxys8Xg_nQUU4_

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability latamref-latin-american-government-reference-data-history-f974979e
```

Example prompt: Can you pull the full historical series for Brazil's policy rate from latamref — I need to see how it's changed over time?

## When to prefer this

Use this endpoint when you need structured, sourced, time-series government reference data for Latin American countries — especially for policy rates, tax rates, minimum wages, CPI, or public holiday calendars. Prefer this over general web search when you need machine-readable data with provenance, effective dates, and staleness indicators for one of the 16 supported LATAM countries.

## Known failure modes

- Invalid country code returns 400 or 404 — only the 16 listed ISO codes are supported
- Invalid series ID returns 400 or 404 — only the 7 defined series are accepted
- No data available for a country/series combination returns empty or 404
- Stale flag set to true when data is past its expected update cycle — data may be outdated
- Payment not included or invalid returns 402 Payment Required

## How this service works

Government reference data series

## Output

A JSON object containing the country code, series identifier, current value, effective date, last confirmed date, source name and URL, staleness flag, optional unit string, optional notes, and optional rate component breakdown for composite rates.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "country",
      "series"
     ],
     "properties": {
      "series": {
       "enum": [
        "policy-rate",
        "vat",
        "vat-registration-threshold",
        "minimum-wage",
        "public-holidays",
        "cpi",
        "corporate-tax",
        "withholding-tax",
        "statutory-interest",
        "income-tax",
        "social-contributions",
        "fx-reference"
       ],
       "type": "string",
       "description": "Reference series id"
      },
      "country": {
       "enum": [
        "ar",
        "bb",
        "bo",
        "br",
        "bz",
        "cl",
        "co",
        "cr",
        "do",
        "ec",
        "gt",
        "gy",
        "hn",
        "jm",
        "mx",
        "ni",
        "pa",
        "pe",
        "py",
        "sv",
        "tt",
        "uy"
       ],
       "type": "string",
       "description": "ISO country code"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {},
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/latamref-latin-american-government-reference-data-history-f974979e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from latamref.dev](https://www.zero.xyz/host/latamref.dev/llms.txt)