ViaCEP API
ViaCEP is a free web service for looking up Brazilian postal codes (CEP) and searching addresses by state, city and street.
API products
-
ViaCEP Web Service
CEP lookup and address search returning JSON, JSONP or XML.
- Type
- Address validation API
- Pricing unit
- Free
- Access
- Self-service
- Carrier account
- Not applicable
- Sandbox
- ? Unknown
Docs ↗Checked 2026-11-12
Capabilities
- ✓ Yes documented
- ? Unknown not confirmed, not a “no”
- Contract depends on your agreement
- — No documented as unsupported
| Operation | Status | Detail |
|---|---|---|
| Address validation | ✓ Yes | Valid CEP returns address; nonexistent CEP returns erro: true↗ |
Operations not listed are unconfirmed, not unsupported.
Pricing
API fees and carrier postage are separate costs. Amounts are shown only when the provider publishes them; “Custom quote” or “Unknown” means no public amount was found, not that the product is free.
Pricing unit: Free
Free web service; donation button on page.
Free tier: Free
Source: viacep.com.br · checked 2026-11-12
Carrier and country coverage
Brazil; database listed with 1,619,614 CEPs; sources IBGE, GIA/ICMS (SP), Anatel, SIAFI.
Regions named by the provider: BR
Carrier account: Not applicable
Source: viacep.com.br · checked 2026-11-12
Coverage statements are the provider's own. Tracking coverage and label coverage differ; confirm your carrier, operation and origin country in the official list.
For developers
| Product | Protocol | Auth | Sandbox | Webhooks | SDKs | Rate limits |
|---|---|---|---|---|---|---|
| ViaCEP Web Service | REST | Not documented | ? Unknown | — No | Not documented | Not documented |
“Not documented” means we did not find it in the pages checked. It is not a “no”.
Strengths and trade-offs
Documented strengths
- Free
- No key described
Trade-offs
- Brazil only
- No numeric rate limit stated; mass use may be blocked
Official sources
| Type | Source | Last successful check |
|---|---|---|
| Docs | https://viacep.com.br/ | 2026-11-12 |
Facts come from the provider's public pages; no live API calls were made. Research depth for this profile: full. Spotted an error? See how we verify.
Alternatives
| Compare | Company | Comparable product | Pricing unit | API access | Carrier account |
|---|---|---|---|---|---|
| Postcodes.io | Postcodes.io API | Free | Self-service | Not applicable | |
| Lob | Lob Address Verification API | Usage tiers | Self-service | Not applicable | |
| getAddress() | getAddress() API | Monthly subscription | Self-service | Not applicable | |
| Smarty | Smarty Address Verification (US and International Street Address APIs) | Usage tiers | Self-service | Not applicable | |
| Geocodio | Geocodio Geocoding API | Usage tiers | Self-service | Not applicable |
Alternatives are chosen by product family, not by commission. Unknown values are not a disadvantage.
Videos
Videos found on YouTube on 2026-11-12. Third-party videos are not produced or verified by us; “Official” marks the provider's own channel. The player loads only when you press play.


