# PontoFato CNPJ Lookup

> PontoFato CNPJ Lookup is a paid API for AI agents from pontofato.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns Brazilian company registry data, sanctions, tax standing, and address for a given CNPJ number.

## Facts

- Endpoint: GET https://pontofato.com/api/x402/cnpj/:cnpj?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pontofato-cnpj-lookup-da390411
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WfWo1oVkmxgJDGGHF9ZS3

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 pontofato-cnpj-lookup-da390411
```

Example prompt: Can you look up the Brazilian company registered under CNPJ 11.222.333/0001-81 and tell me their legal name, address, registration status, and whether they have any sanctions?

## When to prefer this

Use this endpoint when you need authoritative Brazilian company data directly from Receita Federal sources, including sanctions screening and government contract data in a single call. Prefer this over generic company search APIs when the CNPJ is already known and you need structured compliance-grade data (registry status, sanctions, tax standing) rather than just basic firmographic information. The per-call micropayment model (x402) makes it suitable for on-demand lookups in automated agent workflows without subscription overhead.

## Known failure modes

- Invalid or malformed CNPJ returns an error (CNPJ must be 14 digits, with or without punctuation)
- CNPJ not found in the Receita Federal registry returns a not-found response
- Payment failure or insufficient balance results in HTTP 402 and no data returned
- Temporary unavailability of upstream Brazilian government data sources may cause incomplete results
- Rate limiting or quota exceeded may block repeated rapid calls

## How this service works

Company lookup for CNPJ 00000000000191: registry, sanctions, tax standing and address. One payment for this call.

## Output

A structured JSON object containing: company legal name (razão social) and trade name, formatted and raw CNPJ, full address (street, neighborhood, city, state, zip), CNAE primary activity code and description, company size classification, legal nature code and description, registration status with date and reason, start date, social capital, headquarters vs. branch flag, sanctions data (with indicator of more records), and government contract/spending data including source, value, count, and reference period.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "pathParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [],
     "properties": {
      "cnpj": {
       "type": "string",
       "description": "CNPJ com ou sem pontuação (14 caracteres)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "uso": {
       "type": "object",
       "properties": {
        "via": {
         "type": "string"
        },
        "repetido": {
         "type": "boolean"
        },
        "preco_usd": {
         "type": "string"
        }
       }
      },
      "cnpj": {
       "type": "string"
      },
      "empresa": {
       "type": "object",
       "properties": {
        "cnae": {
         "type": "object",
         "properties": {
          "codigo": {
           "type": "number"
          },
          "descricao": {
           "type": "string"
          }
         }
        },
        "cnpj": {
         "type": "string"
        },
        "porte": {
         "type": "object",
         "properties": {
          "label": {
           "type": "string"
          },
          "codigo": {
           "type": "number"
          }
         }
        },
        "endereco": {
         "type": "object",
         "properties": {
          "uf": {
           "type": "string"
          },
          "cep": {
           "type": "string"
          },
          "bairro": {
           "type": "string"
          },
          "numero": {
           "type": "string"
          },
          "municipio": {
           "type": "string"
          },
          "logradouro": {
           "type": "string"
          },
          "tipoLogradouro": {
           "type": "string"
          }
         }
        },
        "situacao": {
         "type": "object",
         "properties": {
          "data": {
           "type": "string"
          },
          "label": {
           "type": "string"
          },
          "codigo": {
           "type": "number"
      
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pontofato-cnpj-lookup-da390411/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pontofato.com](https://www.zero.xyz/host/pontofato.com/llms.txt)
