# CPF.CNPJ API Documentation

> API for CPF and CNPJ verification with the Brazilian Federal Revenue Service (Receita Federal).

## About

CPF.CNPJ provides a RESTful API for real-time verification of Brazilian tax identifiers (CPF for individuals, CNPJ for companies). The service offers:

- Real-time data from Receita Federal (D+0 updates)
- No CAPTCHA required
- No birth date required for CPF queries
- ISO/IEC 27001, 27701, and 37301 certified
- 99.9% uptime SLA

## Base URL

```
https://ws.cpfcnpj.com.br/v2/
```

## Authentication

All requests require an API token passed via query parameter:
```
?token=YOUR_API_TOKEN
```

## Main Endpoints

### CPF Query
```
GET /cpf/{cpf_number}?token=YOUR_TOKEN
```

### CNPJ Query
```
GET /cnpj/{cnpj_number}?token=YOUR_TOKEN
```

### CNPJ with Partners (QSA)
```
GET /cnpj-qsa/{cnpj_number}?token=YOUR_TOKEN
```

## Response Format

All responses are in JSON format with UTF-8 encoding.

### Success Response
```json
{
  "erro": "",
  "erroCodigo": 0,
  "data": { ... }
}
```

### Error Response
```json
{
  "erro": "Error description",
  "erroCodigo": 100
}
```

## Error Codes

- 100: Invalid token
- 101: Expired token
- 102: Insufficient credits
- 200: Invalid CPF/CNPJ format
- 201: CPF/CNPJ not found
- 300: Rate limit exceeded
- 500: Internal server error

## Data Fields

### CPF Response Fields
- nome: Full name
- cpf: CPF number
- dataNascimento: Birth date
- situacaoCadastral: Registration status
- dataInscricao: Registration date

### CNPJ Response Fields
- razaoSocial: Company legal name
- nomeFantasia: Trade name
- cnpj: CNPJ number
- dataAbertura: Opening date
- situacaoCadastral: Registration status
- naturezaJuridica: Legal nature
- atividadePrincipal: Main activity (CNAE)
- endereco: Address information
- telefone: Phone number
- email: Email address
- capitalSocial: Share capital
- porte: Company size

## Rate Limits

- Standard plans: 10 requests/second
- Enterprise plans: Custom limits

## Support

- Documentation: https://www.cpfcnpj.com.br/dev/
- Support Portal: https://suporte.cpfcnpj.com.br
- API Status: https://status.cpfcnpj.com.br

## Contact

- Website: https://www.cpfcnpj.com.br
- Email: contato@cpfcnpj.com.br

## Languages

This documentation is available in:
- Portuguese (pt-BR): https://www.cpfcnpj.com.br/dev/
- English (en): https://www.cpfcnpj.com.br/dev/?lang=en
- Spanish (es): https://www.cpfcnpj.com.br/dev/?lang=es
- French (fr): https://www.cpfcnpj.com.br/dev/?lang=fr