canonical: https://jentic.com/apis/swaggerhub.consumidor.gov.br/api-do-consumidorgovbr

# Consumidor API do consumidor.gov.br

Brazilian consumer protection platform API. How to request API access: 1. Register your CPF (Brazilian tax ID) in the system; 2. Email the supplier CNPJ (business ID) to be linked to the registered CPF. To generate a JWT token, you need the client credentials. The API exposes 16 endpoints secured with bearer authentication.

## For AI agents

Programmatically access API do consumidor.gov.br resources. Covers 16 operations with bearer authentication.

## Scope

Does not handle payments, communications, or crm - use for identity and authentication only.

## Capabilities

- Access API do consumidor.gov.br resources via REST API
- Manage identity auth data programmatically
- Integrate API do consumidor.gov.br into automated workflows
- Query and filter API do consumidor.gov.br records by parameters
- Monitor API do consumidor.gov.br operational status and events

## Use cases

### Identity and Authentication Operations

The API provides 16 endpoints for identity auth operations.

Example prompt: Execute a primary operation against the API do consumidor.gov.br

### Data Retrieval and Monitoring

Query API do consumidor.gov.br resources on a schedule to track changes, generate alerts, or feed downstream dashboards. Agents poll relevant endpoints, compare against previous state, and trigger actions when thresholds are crossed.

Example prompt: Poll the primary API do consumidor.gov.br endpoint, compare response to last known state, and alert if changed

### AI Agent Integration via Jentic

AI agents discover and call API do consumidor.gov.br endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle bearer tokens manually.

Example prompt: Search Jentic for 'API do consumidor.gov.br', load the operation schema, and execute with Jentic-managed credentials

## Key resources

- **Cadastros** — Operations for cadastros
- **Orgao** — Operations for orgao
- **Reclamacao** — Operations for reclamacao
- **Reclamacoes** — Operations for reclamacoes
- **Seguranca** — Operations for seguranca

## Why Jentic

- **Setup:** Wiring the API do consumidor.gov.br by hand means obtaining a company token, sending it as a bearer credential, and threading the protocol number through each complaint call yourself. Through Jentic you install once, import the API do consumidor.gov.br from the API Directory, store the bearer token once, and your agent calls it.
- **Permission scoping:** This API puts the complaint protocol number in the URL path (/reclamacao/{numeroProtocolo}/...), so a rule can pin your agent to listing and reading complaint detail: you choose the operations it may call, so state-changing ones like responding to, redirecting, or refusing a complaint are not included unless you add them.
- **Credential handling:** Your consumidor.gov.br bearer token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'list complaints' or 'download a complaint by protocol', and Jentic returns the matching consumidor.gov.br operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Auth0** — Alternative identity auth API
- **Okta** — Alternative identity auth API

## FAQ

### What authentication does the API do consumidor.gov.br use?

The API do consumidor.gov.br uses a Bearer token in the Authorization header. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### What are the rate limits for the API do consumidor.gov.br?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I use API do consumidor.gov.br through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'use API do consumidor.gov.br'. Jentic returns the matching API do consumidor.gov.br operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the API do consumidor.gov.br have?

The API do consumidor.gov.br exposes 16 endpoints covering cadastros, orgao, reclamacao operations.

### Does the API do consumidor.gov.br support pagination?

Pagination support depends on the specific endpoint. Check the endpoint parameters for page, limit, or offset fields. Through Jentic, the operation schema exposes all available parameters so agents can paginate automatically.

### Can I limit what my agent is allowed to do with the API do consumidor.gov.br?

Yes. Jentic One is self-hosted, so you run it and your own rules decide which operations and credentials the agent may use. Because this API keeps the complaint protocol number in the URL path (/reclamacao/{numeroProtocolo}/...), you can pin the agent to read-only work like listing complaints and reading complaint detail. State-changing operations such as responding to, redirecting, or refusing a complaint are excluded unless you explicitly add them.