# TCU Brazilian Public Registry Lookup

> TCU Brazilian Public Registry Lookup is a paid API for AI agents from x402.spectro.sh, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-20).

Looks up a Brazilian legal entity (CNPJ) against TCU registers of ineligible bidders and entities with irregular accounts, paid per call via x402/USDC.

## Facts

- Endpoint: POST https://x402.spectro.sh/v1/tcu?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tcu-brazilian-public-registry-lookup-f45c5ccd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZCJPdQk_8hQosv4ElbJ-A

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tcu-brazilian-public-registry-lookup-f45c5ccd -d '<json body>'
```

Example prompt: Can you check if the Brazilian company with CNPJ 11.144.477/0001-35 is listed on any TCU sanction registers — either as an inidôneo or as having irregular accounts?

## When to prefer this

Use this endpoint when you need to verify a Brazilian legal entity's (CNPJ) standing against official TCU sanction registers — specifically for procurement compliance, vendor due diligence, or anti-corruption audits in the Brazilian public sector context. Prefer this over generic web search when you need structured, machine-readable, source-verified data with provenance hashes and dataset freshness metadata directly from the Tribunal de Contas da União.

## Known failure modes

- Invalid CNPJ format — fewer than 14 or more than 18 characters returns a validation error
- CPF (individual taxpayer number) submitted instead of CNPJ — explicitly rejected; only legal entities are accepted
- CNPJ not found in TCU datasets — returns empty lists with total 0 (not an error)
- Upstream TCU portal unavailable — may cause retrieval failure or stale data
- Payment not processed via x402 — request rejected with HTTP 402 before lookup executes

## How this service works

Consultas a dados públicos brasileiros, pagas por chamada em USDC via x402.

## Output

Returns a JSON object with two datasets from TCU: (1) 'inidoneos' — a list of entities declared ineligible to bid on public contracts, with totals; (2) 'contasIrregulares' — a list of entities whose accounts were judged irregular, including acordão number, process number, judgment date, municipality, UF, and links to full deliberations and case tracking. Also includes provenance metadata with source URL, SHA256 hash, dataset freshness timestamps, and a unique requestId.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "document": {
   "type": "string",
   "maxLength": 18,
   "minLength": 14,
   "description": "CNPJ, com ou sem pontuação (o alfanumérico também). CPF não é aceito: este serviço consulta apenas pessoas jurídicas."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "inidoneos": {
    "list": [],
    "total": 0
   },
   "totalCount": 3,
   "contasIrregulares": {
    "uf": "MG",
    "list": [
     {
      "nome": "MARIA APARECIDA DE EXEMPLO",
      "numeroAcordao": "1386/2022-PL",
      "codigoProcesso": "70000002",
      "numeroProcesso": "015.398/2019-5",
      "processoGestao": "S",
      "linkDeliberacoes": "https://contas.tcu.gov.br/pesquisaJurisprudencia/#/resultado/acordao-completo/01539820195.PROC",
      "linkAcompanhamento": "https://conecta-tcu.apps.tcu.gov.br/tvp/70000002",
      "dataTransitoJulgado": "10/12/2022"
     }
    ],
    "total": 1,
    "documento": "11144477735",
    "municipio": "CIDADE EXEMPLO",
    "tipoRegistro": "CPF"
   }
  },
  "error": false,
  "product": "tcu",
  "requestId": "3f2b7c1e-8a4d-4c9f-b0e6-1d5a9c7e2b40",
  "provenance": {
   "url": "https://certidoes.apps.tcu.gov.br/",
   "sha256": "ab223db4f5554071e16e692d01fe9defcd45256f955dbe0fa20bedcc93472a61",
   "source": "Tribunal de Contas da União: responsáveis inidôneos e com contas julgadas irregulares",
   "datasets": [
    {
     "id": "tcu_inidoneos",
     "fields": [
      "inidoneos"
     ],
     "period": null,
     "checkedAt": "2026-01-06T07:04:00Z",
     "updatedAt": "2026-01-05T07:04:00Z"
    },
    {
     "id": "tcu_contas_irregulares",
     "fields": [
      "contasIrregulares"
     ],
     "period": null,
     "checkedAt": "2026-01-06T07:04:00Z",
     "updatedAt": "2026-01-05T07:04:00Z"
    }
   ],
   "retrievedAt": "2026-01-01T00:00:00Z"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tcu-brazilian-public-registry-lookup-f45c5ccd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.spectro.sh](https://www.zero.xyz/host/x402.spectro.sh/llms.txt)