Latamref Free API
No payment and no key. Public holidays for every country, the catalog, the change/freshness feed, the re-verification calendar (GET /v1/calendar), the business-day tools (GET /v1/business-days/*), and the provenance ledger.
No payment and no key. Public holidays for every country, the catalog, the change/freshness feed, the re-verification calendar (GET /v1/calendar), the business-day tools (GET /v1/business-days/*), and the provenance ledger.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/latamref-dev:latamref-dev-free-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: latamref — Latin American government reference data Free API
version: 1.0.0
description: 'Latin American government reference data for 22 countries as cited JSON: central-bank policy rates, VAT/GST and VAT registration thresholds, CPI, corporate, personal and withholding tax, social contributions, minimum wages, statutory interest, official FX rates, filing deadlines and public holidays (coverage varies by country). Every value carries its official source URL and last-confirmed date. Single facts $0.003; country brief (every series for one country) $0.01; cross-country compare (one series, up to 10 countries) $0.02; tax-ID and VAT-number checks $0.003; computed answers (VAT, income tax, working days, minimum-wage check) $0.01-$0.02. Pay per call in USDC on Base via x402 or MPP, no signup, or by card with credit packs or monthly plans on one key valid across all 7 regional services. Free tier: GET /catalog, plus a free email key with 50 answer calls a day, commercial use allowed. Finished answers, one cited dossier per call (supported countries vary per job; others are refused free): cost this hire (wage-floor verdict, contributions, employer cost) $0.50; charge this sale (which VAT applies, net/VAT/gross) $0.50; charge this sale certified (plus a signed VAT-rate extract) $0.75; invoice due date and statutory late interest $0.40; country evidence pack (brief plus signed extracts) $0.25; hire compare $0.75 for 2 countries, $1.00 for 3-5; next filings (VAT, PAYE, corporate-tax due dates rolled for holidays) $0.35; invoice check (VAT right or wrong, overdue interest, tax-ID format) $0.60.
Free trial: 3 successful calls per day per IP, shared across POST /v1/answers/* and POST /v1/jobs/*. No header needed (X-Free-Trial: 1 is accepted but not required); an empty-body POST gets the normal x402 402 and does not use the trial; a CoinbaseBazaarDiscovery user-agent also gets that 402 and does not use the trial (the user-agent is not a credential); once used up, the 402 carries free_trial_resets_at. MCP answer tools use the trial automatically when no api_key is passed. Every series of the evaluation country is free. Card credit (same per-call price as x402): /pricing.'
x-guidance: 'GET /v1/{country}/{series} returns the current value of a reference series — e.g. GET /v1/br/policy-rate. Countries: ar, bb, bo, br, bz, cl, co, cr, do, ec, gt, gy, hn, jm, mx, ni, pa, pe, py, sv, tt, uy. Series: policy-rate, vat, vat-registration-threshold, minimum-wage, public-holidays, cpi, corporate-tax, withholding-tax, statutory-interest, income-tax, social-contributions, fx-reference, filing-deadlines. Append /history for past values. GET /v1/all returns every series for every country in one call. GET /catalog (free) lists all available series with freshness metadata, each with the official source it is cited to. If you are an x402/API seller making a cross-border digital sale, POST /v1/vat/determine tells you which jurisdiction''s VAT applies, who accounts for it, and the registration trigger — cited to the statute (EU, UK, South Africa), and it handles the wallet-only unidentified-buyer case. Payment is x402 (USDC on Base) per call; no signup or API keys needed. Retention: GET /v1/changes (free; past moves and freshness), GET /v1/calendar (free; reverify_by is derived from last_confirmed + update_cycle_days; next_effective_known only when current.effective_to is set; status unknown omits any next date; notes are never parsed; not an MPC, budget, or wage-review date), and POST /alerts (register free) are how a paying agent watches a value after the first paid call. Do not re-buy a series to find out whether it moved. GET /v1/calendar is not a promised future gazette.'
contact:
name: afriref API support
email: api@3l-groupconsulting.co.za
url: https://latamref.dev/pricing
x-agentcash-owner: fou53506
termsOfService: https://latamref.dev/terms
servers:
- url: https://latamref.dev
security:
- x402Payment: []
- apiKey: []
tags:
- name: Free
description: No payment and no key. Public holidays for every country, the catalog, the change/freshness feed, the re-verification calendar (GET /v1/calendar), the business-day tools (GET /v1/business-days/*), and the provenance ledger.
paths:
/catalog:
get:
operationId: getCatalog
summary: Catalog of all countries and series with freshness metadata (free)
tags:
- Free
security: []
parameters:
- name: confidence
in: query
required: false
schema:
type: string
example: primary
description: Filter to series at the given verification confidence (comma-separated). `primary` = no verification limitation recorded — the absence of a known problem, not a fresh re-verification. `secondary` = corroborated but the primary instrument was not read, usually because the publishing host blocks automated access. `attested` = no primary source is publicly available to anyone. `derived` = computed from another series. Unknown levels return 400 with the valid set.
responses:
'200':
description: Catalog. Every series carries `confidence`, and `confidence_note` where it is not primary.
content:
application/json:
schema:
type: object
'400':
description: Unknown confidence level, returned with the valid set and what each means
/v1/{country}/public-holidays:
get:
operationId: getPublicHolidaysV1
summary: Public holiday calendar for a country, with sub-national calendars (free)
description: 'National public holidays in `value`; regional extra days are under `subdivisions` (ISO 3166-2). For a regional calendar applied for you, POST /v1/answers/working-days. `date: null` + `pending_window` marks a day not yet gazetted (never invented); `name` is stable.'
tags:
- Free
security: []
parameters:
- name: country
in: path
required: true
schema:
type: string
enum:
- ar
- bb
- bo
- br
- bz
- cl
- co
- cr
- do
- ec
- gt
- gy
- hn
- jm
- mx
- ni
- pa
- pe
- py
- sv
- tt
- uy
example: br
example: br
responses:
'200':
description: Holiday calendar, plus `subdivisions` where the country has regions
content:
application/json:
schema:
type: object
properties:
country:
type: string
description: ISO 3166-1 alpha-2 country code
series:
type: string
value:
description: Number for rates/wages; array of {date,name} for holiday calendars
unit:
type: string
effective_from:
type:
- string
- 'null'
format: date
effective_from_basis:
type: string
enum:
- restatement
description: 'Optional. Absent: effective_from is the date the value became the law (a genuine change point). ''restatement'': effective_from is the date the value''s CURRENT LEGAL BASIS took effect (a new tax code, an annual finance law) while the value itself is older and its true origin is not primary-verifiable — a verified floor, not a change. Do not read a restatement row as the value having changed on that date.'
last_confirmed:
type: string
format: date
description: When this value was last verified against the official source
source:
type: object
properties:
name:
type: string
url:
type: string
format: uri
required:
- name
- url
stale:
type: boolean
description: True when past the expected update cycle — treat with caution
notes:
type: string
effective_rate:
type: number
description: Optional. Combined effective rate where statutory levies stack on top of the standard rate (e.g. Ghana VAT 15% + NHIL 2.5% + GETFund 2.5% = 20%). Present only where it differs from value.
components:
type: array
description: Optional. Breakdown of a composite rate into its named statutory components (present only where applicable, e.g. Ghana VAT).
items:
type: object
properties:
name:
type: string
rate:
type: number
required:
- name
- rate
confidence_label:
type: string
enum:
- high
- medium
- low
description: 'Derived from source type, verification age, stale. Rules: /label-rules'
coverage_label:
type: string
enum:
- ready
- partial
- gap
description: 'ready=complete, partial=limited, gap=no number. Rules: /label-rules'
label_basis:
type: object
description: Inputs and rule ids behind both labels
required:
- country
- series
- value
- effective_from
- last_confirmed
- source
- stale
'404':
description: Unknown country
x-description-full: 'The canonical holidays endpoint, and the one the catalog and llms.txt advertise. Returns the NATIONAL days in `value`, and — where a country has regions that set their own days — every region inline under `subdivisions`, keyed by ISO 3166-2 with the scheme named in `subdivisions_standard`. Each region''s list contains only that region''s ADDITIONAL days, so a full regional calendar is `value` plus that region''s entries, not the region''s entries alone. This endpoint does NOT take a `subdivision` parameter and ignores one if sent; to have a regional calendar applied for you, POST /v1/answers/working-days with `subdivision`. Some entries carry `date: null` with a `pending_window` where a holiday is statutory but its date is not yet gazetted — we publish the placeholder rather than invent a date — and entries may carry a `note` describing how that day behaves in that specific year, while `name` stays stable across years and is safe to match on.'
/public/{country}/holidays:
get:
operationId: getPublicHolidays
deprecated: true
summary: Public holiday calendar for a country (free) — deprecated legacy alias
description: Serves the same payload as GET /v1/{country}/public-holidays, which is canonical. Kept working because it is published and in use — no removal is planned — but responses carry a Deprecation header and a Link rel=successor-version pointing at the /v1 form; use that in new clients.
tags:
- Free
security: []
parameters:
- name: country
in: path
required: true
schema:
type: string
enum:
- ar
- bb
- bo
- br
- bz
- cl
- co
- cr
- do
- ec
- gt
- gy
- hn
- jm
- mx
- ni
- pa
- pe
- py
- sv
- tt
- uy
example: br
example: br
responses:
'200':
description: Holiday calendar
content:
application/json:
schema:
type: object
properties:
country:
type: string
description: ISO 3166-1 alpha-2 country code
series:
type: string
value:
description: Number for rates/wages; array of {date,name} for holiday calendars
unit:
type: string
effective_from:
type:
- string
- 'null'
format: date
effective_from_basis:
type: string
enum:
- restatement
description: 'Optional. Absent: effective_from is the date the value became the law (a genuine change point). ''restatement'': effective_from is the date the value''s CURRENT LEGAL BASIS took effect (a new tax code, an annual finance law) while the value itself is older and its true origin is not primary-verifiable — a verified floor, not a change. Do not read a restatement row as the value having changed on that date.'
last_confirmed:
type: string
format: date
description: When this value was last verified against the official source
source:
type: object
properties:
name:
type: string
url:
type: string
format: uri
required:
- name
- url
stale:
type: boolean
description: True when past the expected update cycle — treat with caution
notes:
type: string
effective_rate:
type: number
description: Optional. Combined effective rate where statutory levies stack on top of the standard rate (e.g. Ghana VAT 15% + NHIL 2.5% + GETFund 2.5% = 20%). Present only where it differs from value.
components:
type: array
description: Optional. Breakdown of a composite rate into its named statutory components (present only where applicable, e.g. Ghana VAT).
items:
type: object
properties:
name:
type: string
rate:
type: number
required:
- name
- rate
confidence_label:
type: string
enum:
- high
- medium
- low
description: 'Derived from source type, verification age, stale. Rules: /label-rules'
coverage_label:
type: string
enum:
- ready
- partial
- gap
description: 'ready=complete, partial=limited, gap=no number. Rules: /label-rules'
label_basis:
type: object
description: Inputs and rule ids behind both labels
required:
- country
- series
- value
- effective_from
- last_confirmed
- source
- stale
'404':
description: Unknown country
/provenance:
get:
operationId: getProvenance
summary: Source-provenance snapshot coverage (free)
description: 'The evidence behind our citations: each official source is fetched, sha256-fingerprinted and re-checked, so you can see when we verified it and whether it changed. Distinguishes `gone` from `blocked_to_automation`. Fingerprints are published, not the documents.'
tags:
- Free
security: []
responses:
'200':
description: Coverage summary and status definitions
'503':
description: Snapshot not yet available
x-description-full: Every value cites an official source; this is the evidence behind those citations. Each cited document is fetched, fingerprinted with a sha256 over the exact bytes, and re-checked, so a consumer can see when we verified against it and whether it has changed since. Distinguishes `gone` (404/410) from `blocked_to_automation` (the host refuses bots but a person can still open it) — we do not report a live source as dead. The fingerprint is published, not the mirrored document.
/provenance/{country}/{series}:
get:
operationId: getProvenanceForSeries
summary: Cited sources behind one series, with fingerprints (free)
tags:
- Free
security: []
parameters:
- name: country
in: path
required: true
schema:
type: string
enum:
- ar
- bb
- bo
- br
- bz
- cl
- co
- cr
- do
- ec
- gt
- gy
- hn
- jm
- mx
- ni
- pa
- pe
- py
- sv
- tt
- uy
example: br
example: br
- name: series
in: path
required: true
schema:
type: string
example: vat
responses:
'200':
description: Per-source sha256, size, content type, first-verified, last-changed and current reachability
'404':
description: No cited sources recorded for this country/series
'503':
description: Snapshot not yet available
/certified/public-key:
get:
operationId: getCertifiedPublicKey
summary: Public key and canonicalization rule for a certified extract or an answer…
description: Free. No payment. One Ed25519 key verifies both series certified extracts (GET /v1/certified/{country}/{series}) and answer receipts (kind answer_receipt, embedded in a paid POST /v1/answers/* HTTP 200 when the body sets receipt:true). Same key_id and the same canonical JSON rule (keys sorted recursively, no whitespace). An answer receipt is not a series certified extract.
tags:
- Free
security: []
responses:
'200':
description: Ed25519 public key (PEM), key id, canonicalization rule and verify snippets. Covers certified extracts and answer receipts; no second key.
'503':
description: Signing key not provisioned
/v1/business-days/is-business-day:
get:
operationId: isBusinessDay
summary: FREE — is this date a business day in this country?
description: 'Unmetered and unpriced; every country on every brand. Applies the country''s national public-holiday calendar and its statutory weekend rule. Returns the verdict, the reason (business_day, weekend, public_holiday, weekend_and_public_holiday, makeup_workday), the holiday names, the next and previous business day, the weekend rule with its basis, and the cited calendar. Refusals are free JSON: 400 for a malformed country, date or n; 404 for an unknown country; 422 year_not_held when a date falls...'
tags:
- Free
security: []
parameters:
- name: country
in: query
required: true
schema:
type: string
pattern: ^[a-zA-Z]{2}$
example: za
description: ISO 3166-1 alpha-2. Any country in GET /catalog of any brand.
- name: date
in: query
required: true
schema:
type: string
format: date
example: '2026-12-24'
description: The date to classify. YYYY-MM-DD.
responses:
'200':
description: Free. Verdict, reason, holiday names, next/previous business day, weekend rule and calendar provenance.
content:
application/json:
schema:
type: object
'400':
description: Free. Malformed country, date or n.
'404':
description: Free. Unknown country.
'422':
description: Free. year_not_held, holiday_date_pending or no_national_calendar — see the body's explanation and what_you_can_do.
x-description-full: 'Unmetered and unpriced; every country on every brand. Applies the country''s national public-holiday calendar and its statutory weekend rule. Returns the verdict, the reason (business_day, weekend, public_holiday, weekend_and_public_holiday, makeup_workday), the holiday names, the next and previous business day, the weekend rule with its basis, and the cited calendar. Refusals are free JSON: 400 for a malformed country, date or n; 404 for an unknown country; 422 year_not_held when a date falls in a year whose holidays we do not hold (the body lists years_held and, where the calendar is moon-sighted or instrument-pending, why); 422 holiday_date_pending when a statutory holiday''s date is not yet fixed; 422 no_national_calendar for ''eu''. A 402 on this route is a gate bug — do not pay.'
/v1/business-days/add:
get:
operationId: addBusinessDays
summary: FREE — add n business days to a date (negative n walks backward)
description: 'Unmetered and unpriced; every country on every brand. The start date is day 0 and is never counted. n = 0 returns the date itself if it is a business day, otherwise the next business day. Returns result_date with every non-business day skipped and why. Refusals are free JSON: 400 for a malformed country, date or n; 404 for an unknown country; 422 year_not_held when a date falls in a year whose holidays we do not hold (the body lists years_held and, where the calendar is moon-sighted or instru...'
tags:
- Free
security: []
parameters:
- name: country
in: query
required: true
schema:
type: string
pattern: ^[a-zA-Z]{2}$
example: za
description: ISO 3166-1 alpha-2. Any country in GET /catalog of any brand.
- name: date
in: query
required: true
schema:
type: string
format: date
example: '2026-12-24'
description: Start date (day 0). YYYY-MM-DD.
- name: n
in: query
required: true
schema:
type: integer
minimum: -500
maximum: 500
example: 5
description: Business days to add. Negative walks backward.
responses:
'200':
description: Free. result_date plus the non-business days skipped, weekend rule and calendar provenance.
content:
application/json:
schema:
type: object
'400':
description: Free. Malformed country, date or n.
'404':
description: Free. Unknown country.
'422':
description: Free. year_not_held, holiday_date_pending or no_national_calendar — see the body's explanation and what_you_can_do.
x-description-full: 'Unmetered and unpriced; every country on every brand. The start date is day 0 and is never counted. n = 0 returns the date itself if it is a business day, otherwise the next business day. Returns result_date with every non-business day skipped and why. Refusals are free JSON: 400 for a malformed country, date or n; 404 for an unknown country; 422 year_not_held when a date falls in a year whose holidays we do not hold (the body lists years_held and, where the calendar is moon-sighted or instrument-pending, why); 422 holiday_date_pending when a statutory holiday''s date is not yet fixed; 422 no_national_calendar for ''eu''. A 402 on this route is a gate bug — do not pay.'
/v1/business-days/between:
get:
operationId: businessDaysBetween
summary: FREE — count business days between two dates
description: 'Unmetered and unpriced; every country on every brand. business_days counts (from, to] and is negative when to is before from, so add(from, business_days) lands on to whenever to is a business day. business_days_inclusive counts both ends. Also returns weekend days and the public holidays in range. Range at most 1096 calendar days. Refusals are free JSON: 400 for a malformed country, date or n; 404 for an unknown country; 422 year_not_held when a date falls in a year whose holidays we do not h...'
tags:
- Free
security: []
parameters:
- name: country
in: query
required: true
schema:
type: string
pattern: ^[a-zA-Z]{2}$
example: za
description: ISO 3166-1 alpha-2. Any country in GET /catalog of any brand.
- name: from
in: query
required: true
schema:
type: string
format: date
example: '2026-12-24'
description: Range start. YYYY-MM-DD.
- name: to
in: query
required: true
schema:
type: string
format: date
example: '2026-12-24'
description: Range end. YYYY-MM-DD.
responses:
'200':
description: Free. Signed and inclusive business-day counts, weekend days, holidays in range, weekend rule and calendar provenance.
content:
application/json:
schema:
type: object
'400':
description: Free. Malformed country, date or n.
'404':
description: Free. Unknown country.
'422':
description: Free. year_not_held, holiday_date_pending or no_national_calendar — see the body's explanation and what_you_can_do.
x-description-full: 'Unmetered and unpriced; every country on every brand. business_days counts (from, to] and is negative when to is before from, so add(from, business_days) lands on to whenever to is a business day. business_days_inclusive counts both ends. Also returns weekend days and the public holidays in range. Range at most 1096 calendar days. Refusals are free JSON: 400 for a malformed country, date or n; 404 for an unknown country; 422 year_not_held when a date falls in a year whose holidays we do not hold (the body lists years_held and, where the calendar is moon-sighted or instrument-pending, why); 422 holiday_date_pending when a statutory holiday''s date is not yet fixed; 422 no_national_calendar for ''eu''. A 402 on this route is a gate bug — do not pay.'
components:
securitySchemes:
x402Payment:
type: apiKey
in: header
name: X-PAYMENT
description: x402 (USDC on Base). Call without this header, receive HTTP 402 carrying the price and payment details, then retry with the signed payment payload in X-PAYMENT. No signup, no account, no key. Per-operation prices are in the x-payment-info extension and at https://latamref.dev/pricing.
apiKey:
type: apiKey
in: header
name: X-API-Key
description: 'Prepaid credit bought by card (from $10) at https://latamref.dev/pricing, or a free key by email at https://latamref.dev/free-key (50 calls a day on answer endpoints, commercial use allowed). Send the key on every call. How the two payment rails charge: both rails charge the same US-dollar price per call. By card, prepaid credit is worth $0.001 per credit on the $10, $25 and $100 packs and each successful call debits its endpoint price in credits (a $0.003 value is 3 credits, a $0.002 holidays call is 2, an alert delivery after the free trial is 50, a $0.10 certified extract is 100); over x402, every call pays the price quoted in its own 402 challenge, $0.002 to $1.00 depending on the endpoint (listed at https://latamref.dev/pricing). Failed or refused calls are not charged on either rail. Keys bought before 12 October 2026 keep their original one-credit-per-call terms, and keys bought from 12 to 16 October keep $0.005 credits. Use this instead of x402 if you want an invoice.'
x402:
type: apiKey
in: header
name: PAYMENT-SIGNATURE
description: 'x402 v2 (USDC on Base, network eip155:8453): call without payment, receive HTTP 402 with the v2 PAYMENT-REQUIRED challenge, retry with the signed payload in PAYMENT-SIGNATURE. The challenge is v2 only, so a client must read v2; X-PAYMENT is also accepted as the payment header. No signup, no key.'
x-example-urls:
- https://latamref.dev/catalog
- https://latamref.dev/v1/calendar
- https://latamref.dev/public/br/holidays
- https://latamref.dev/v1/br/policy-rate
- https://latamref.dev/v1/br/policy-rate/history
- https://latamref.dev/v1/all