> This page is for BaaS.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://en.docs.api.corpx.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://en.docs.api.corpx.com/_mcp/server.

# Bank catalog

Directory of participants for TED and PIX-by-bank-account dropdowns. This is
not the credentialed account — that remains
`GET /v1/accounts/{accountId}/bank-account` (your own COMPE, branch and number).

TED (`POST .../ted/out`) requires a 3-digit COMPE. An 8-digit ISPB returns
`400 invalid_bank_code`. PIX by bank details prefers ISPB and also accepts
COMPE in the same field.

The UI needs both codes: the user picks “Itaú”, the integrator sends
`bankCode: "341"` on TED and `bankIspb: "60701190"` on PIX.

`ted` / `pix` matter because not every SPI participant does STR, and the
reverse is also true.

`GET /v1/banks` returns one row per participant. `GET /v1/banks/{code}`
accepts `341` or `60701190` and returns the same row (`404 bank_not_found`
if missing).

Source: [STR participants — Banco Central](https://www.bcb.gov.br/content/estabilidadefinanceira/str1/ParticipantesSTR.csv).
Payments do **not** validate against this catalog.