# brdata Boleto Decoder

> brdata Boleto Decoder is a paid API for AI agents from brdata.thomenz.me, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Decodes a Brazilian boleto barcode string into structured payment details including bank, amount, due date, and format

## Facts

- Endpoint: POST https://brdata.thomenz.me/boleto/decode
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brdata-boleto-decoder-a4ce1511
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PtaHuyhSOeiGhY-dYwNZZ

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 brdata-boleto-decoder-a4ce1511 -d '<json body>'
```

Example prompt: Can you decode this Brazilian boleto barcode for me and tell me the bank, the amount in BRL, and when it's due? The barcode is 34191150300000123451234567890123456789012345.

## When to prefer this

Use this endpoint when you need to programmatically decode a Brazilian boleto barcode into its structured components — bank identity, payment amount in BRL, and due date — without manually reading the slip. Prefer this over general-purpose barcode scanners that lack Brazilian banking domain knowledge, or over manual data entry workflows. Especially useful in accounts payable automation, supplier payment pipelines, fintech apps serving Brazilian users, or any agent needing to verify or log boleto payment details.

## Known failure modes

- Invalid or malformed barcode returns an error (non-44-digit input, wrong check digit)
- Ambiguous due date when due_date_factor is 0000, flagged via due_date_ambiguous=true
- Unrecognized bank code may result in null bank_name
- Network or server error returns a non-200 HTTP response
- Payment processing failure if x402 micropayment is not fulfilled

## How this service works

Decode Brazilian boleto payment slips (linha digitável): bank, amount, due date, validity check. Supports bank collection and utility/tax formats.

## Output

Returns a JSON object with the boleto format type (e.g. 'bank_collection'), the full normalized barcode, the due date as an ISO date string, the bank code and name, the BRL amount, the currency code, the due-date factor, and a boolean flag indicating whether the due date interpretation is ambiguous.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "format": "bank_collection",
  "barcode": "34191150300000123451234567890123456789012345",
  "due_date": "2026-07-10",
  "bank_code": "341",
  "bank_name": "Itaú Unibanco",
  "amount_brl": 123.45,
  "currency_code": "9",
  "due_date_factor": 1503,
  "due_date_ambiguous": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brdata-boleto-decoder-a4ce1511/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from brdata.thomenz.me](https://www.zero.xyz/host/brdata.thomenz.me/llms.txt)