# IBGE Brazil Municipalities by Macro-Region

> IBGE Brazil Municipalities by Macro-Region is a paid API for AI agents from clonecho.builda.company, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns all Brazilian municipalities within a specified IBGE macro-region code (1–5) as JSON.

## Facts

- Endpoint: POST https://clonecho.builda.company/x402/s/ibge-br-municipios-por-regiao
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ibge-brazil-municipalities-by-macro-region-4092e632
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__X7BN-JbHc_IzjKwFTeG3

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 ibge-brazil-municipalities-by-macro-region-4092e632 -d '<json body>'
```

Example prompt: Can you give me a list of all municipalities in IBGE macro-region 3 (Southeast Brazil)?

## When to prefer this

Use this endpoint when you need a complete list of Brazilian municipalities filtered by IBGE macro-region code (1=Norte, 2=Nordeste, 3=Sudeste, 4=Sul, 5=Centro-Oeste). Prefer this over general geographic databases when IBGE-authoritative Brazilian municipal data is needed for a specific macro-region.

## Known failure modes

- Missing or invalid ?q= parameter returns an error or empty result
- Region code outside 1–5 returns no data or an error
- Service unavailable returns HTTP 402 or 5xx
- Malformed query returns unexpected JSON structure

## How this service works

Brazil (IBGE): all municipalities within a macro-region code (1-5). Query: ?q= Returns JSON.

## Output

A JSON array of Brazilian municipalities that belong to the specified macro-region code (1–5), sourced from IBGE data, including municipality names and relevant identifiers.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ibge-brazil-municipalities-by-macro-region-4092e632/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clonecho.builda.company](https://www.zero.xyz/host/clonecho.builda.company/llms.txt)