Complete docs
Linebras API Documentation
Prefer Authorization: Bearer YOUR_KEY. We also support X-API-Key: YOUR_KEY for compatible tools. Secret keys are for backend. Public keys are for widgets/frontend with limited scopes.
Use Brazilian datasets through a single REST API. Keep secret keys on your backend and use public keys only for widgets or browser-safe flows.
Real data: public documentation lists services tested with real sources, cache or validated local snapshots.
Authentication
curl -H "Authorization: Bearer YOUR_KEY" https://linebras.com/v1/cep/01001000
Available services
| CEP | /v1/cep/{cep} — cached CEP lookup. |
| CPF validation | /v1/cpf/validate/{cpf} — mathematical validation. |
| CNPJ validation | /v1/cnpj/validate/{cnpj} — mathematical validation. |
| CNPJ lookup | /v1/cnpj/{cnpj} — public company data with cache/fallback. |
| Pix validation | /v1/pix/validate/{key} — syntactic validation, no ownership lookup. |
| IBGE, banks, holidays | Brazilian auxiliary datasets for onboarding and operations. |
| Batch | JSON/CSV validation workflows. |
| Widgets | CEP widget for frontend with public keys. |
| OpenAPI | Automatic spec at /v1/openapi.json. |
Sensitive data policy: Linebras API does not sell CPF ownership lookup or Pix ownership lookup.