# latamref.dev Government Reference Data Series

> latamref.dev Government Reference Data Series 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 official government reference data (policy rate, VAT, minimum wage, public holidays, CPI, corporate tax, income tax) for Latin American countries by country code and series ID

## Facts

- Endpoint: GET https://latamref.dev/v1/:country/:series
- 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-dev-government-reference-data-series-225daf4b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pso2Cl1BtykL544wu7BEE

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-dev-government-reference-data-series-225daf4b
```

Example prompt: What's the current VAT rate in Brazil right now — can you pull the official latamref data for the 'vat' series for country code 'br'?

## When to prefer this

Use this endpoint when you need authoritative, structured government reference data for Latin American countries — especially for tax rates, central bank rates, wages, or holiday calendars — and need a single consistent API rather than scraping individual government websites. Ideal for compliance checks, financial modeling, payroll applications, or any workflow requiring up-to-date statutory figures across multiple LatAm jurisdictions.

## Known failure modes

- Unsupported country code returns an error (only ar, br, cl, co, cr, do, ec, gt, mx, pe, py, uy are supported)
- Unsupported series ID returns an error (only policy-rate, vat, minimum-wage, public-holidays, cpi, corporate-tax, income-tax are valid)
- Stale flag set to true when data is past expected update cycle — value may be outdated
- Payment failure (x402 micropayment not processed) results in 402 response and no data returned
- Network timeout or upstream service unavailability

## How this service works

latamref - Latin American government reference data. br eval free. $0.005 Base USDC. Cited.

## Output

Returns a JSON object containing the country code, series identifier, current value (numeric rate or array of holiday objects), effective date, last confirmed date, data source name and URL, staleness flag, and optionally a breakdown of composite rate components and an effective combined rate.

## 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-dev-government-reference-data-series-225daf4b/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)