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

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

Request
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

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

Technical Specifications

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

Related Tags

Similar APIs

View All →