# IBGE Brazil States by Macro-Region

> IBGE Brazil States 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 a list of Brazilian federative units (states) belonging to a specified macro-region code (1–5) from the IBGE national statistics agency.

## Facts

- Endpoint: POST https://clonecho.builda.company/x402/s/ibge-br-estados-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-states-by-macro-region-ad5f2abe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uDDV9oGxL30Jj1Sq3mHkt

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-states-by-macro-region-ad5f2abe -d '<json body>'
```

Example prompt: Can you list all the states (federative units) in Brazil's North macro-region — that's region code 1 according to IBGE?

## When to prefer this

Use this endpoint when you need to look up which Brazilian states belong to a specific IBGE macro-region (1–5), especially when building Brazil-specific geographic filters, populating region-based dropdowns, or enriching data with official government administrative boundaries.

## Known failure modes

- Invalid or out-of-range region code (not 1–5) returns empty or error response
- Missing query parameter ?q= results in a bad request
- Non-numeric region code causes unexpected behavior
- Payment failure (402) if USDC not provided

## How this service works

Brazil (IBGE, national statistics agency): federative units (states) within a given macro-region code (1-5). Query: ?q= Returns JSON.

## Output

A JSON array of Brazilian federative units (states) that belong to the specified macro-region, including state names and related identifiers as provided by IBGE.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ibge-brazil-states-by-macro-region-ad5f2abe/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)