Brazil Receita WS API

Free to Use Varies (check documentation)

Overview

Brazil Receita WS lets you look up official information about Brazilian companies using their CNPJ (tax registration number). You get data like company name, address, status, and registration details from Brazil s federal revenue authority. No API key is required for basic lookups, making it easy to get started.

💡

Beginner Tip

The CNPJ must be exactly 14 digits with no dots, slashes, or dashes; strip all formatting before sending the request.

Available Data

Brazil Receita WS data via REST API
JSON-formatted response data
Freely accessible without authentication

Example Response

JSON Response
{
  "status": "success",
  "data": {
    "result": "Data from Brazil Receita WS",
    "description": "Consult companies by CNPJ for Brazilian companies",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

cnpj The 14-digit CNPJ number of the company that was queried
nome Official registered name of the company
fantasia Trade name or brand name of the company, if different from the registered name
situacao Current registration status of the company (e.g. ATIVA means active)
municipio City where the company is registered
uf Two-letter Brazilian state abbreviation where the company is registered

Implementation Example

const url = "https://www.receitaws.com.br/";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

Too Many Requests (429) The free tier only allows one request per minute per IP
Add a delay of at least 60 seconds between requests on the free plan, or consider a paid plan for higher throughput
CNPJ invalido (invalid CNPJ) The CNPJ number failed the checksum validation before being queried
Validate the CNPJ format—14 digits, no punctuation—and use a CNPJ validator library to catch typos early
404 Not Found The CNPJ does not match any registered company in the Receita Federal database
Verify the CNPJ number directly on the official Receita Federal website to confirm it exists

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 15/20
🔒 Security 15/15
🛠 Developer XP 15/20
✓ Reliability 7/15
Response Time 214ms

Fully tested on Apr 5, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS UNKNOWN
Category Government
Difficulty Beginner
Verified: 2026-04-04

Similar APIs

View All →