Skip to main content
Clara operates in three markets, each with its own base URL and a distinct set of available features. Use this page to determine what’s available before building your integration.

Base URLs

CountryBase URL
Mexicohttps://public-api.mx.clara.com
Brazilhttps://public-api.br.clara.com
Colombiahttps://public-api.co.clara.com

Feature Availability

FeatureMexicoBrazilColombia
Corporate cards (physical)
Corporate cards (virtual)
Card spending configurations
Card lock / unlock
Transactions API v3
User management (v3)
Billing statements
Reimbursements
Labels
VCN (Virtual Card Numbers)
Clara MCP
CFDI fiscal invoices
Digital Account (PIX / TED)
Boleto payments
DDA (Authorized Direct Debit)

Currency

CountryCurrencyCode
MexicoMexican PesoMXN
BrazilBrazilian RealBRL
ColombiaColombian PesoCOP
All amount fields in API responses are in currency units (not cents). Use BigDecimal or equivalent in typed languages to avoid floating-point errors.

Country-Specific Endpoints

Mexico only

CFDI Fiscal Invoices — Retrieve SAT-registered XML invoices linked to transactions:
  • GET /api/v3/transactions/{uuid}/invoices — CFDI invoices for a specific transaction
  • GET /api/v3/invoices — Query invoices by issuer RFC, date range, or folio fiscal UUID
  • GET /api/v2/invoices — v2 invoice retrieval

Brazil only

Digital Account — PIX, TED, and bill payment transactions for your Clara digital account:
  • GET /api/v3/digital-accounts — Filter by date range and transactionTypeName (PIX | TED | BILL | TRANSACTION)
Boleto Payments — Bank slip (boleto bancário) payments:
  • POST /api/v2/payments — Create a boleto payment with barcodeDigitableLine
  • GET /api/v2/payments — List all boleto payments
  • GET /api/v2/payments/dda — List DDA (pre-authorized) invoices
DDA (Débito Direto Autorizado) — Pre-authorized invoices retrieved automatically from financial institutions:
  • GET /api/v2/dda — List available DDA invoices

Tax Identifier Formats

Tax identifiers are used in user management and multi-entity requests:
CountryFieldFormat
MexicoRFC11 or 13 characters
BrazilCNPJ / CPF14 digits (CNPJ) or 11 digits (CPF)
ColombiaNIT7, 8, 9, or 10 digits
Pass the company tax ID in the X-Tax-Identifier header to operate on behalf of a specific subsidiary in a multi-entity setup.

Clara MCP Server URLs

CountryMCP Server URL
Mexicohttps://api.clara.team/mcp
Brazilhttps://api-prod.br.clara.com/mcp
Colombiahttps://api-gw-co-prod.clara.com/mcp