PontoFato

PontoFato Empresas API

The Empresas API from PontoFato — 1 operation(s) for empresas.

Documentation GitHub OpenAPI

Operations 1

GET /api/empresas Estabelecimentos da Receita neste CEP (join no c3, teto 50) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/pontofato-empresas-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: PontoFato Empresas API
  version: 2d690e87
  description: 'Ponto e fato de um lugar no Brasil. Índice: GET /api/.'
servers:
- url: https://pontofato.com
tags:
- name: Empresas
paths:
  /api/empresas:
    get:
      operationId: empresas
      summary: Estabelecimentos da Receita neste CEP (join no c3, teto 50)
      description: 'Devolve: { items[{cnpj,cnpjFormatted,razaoSocial,nomeFantasia,situacao,uf,municipio,bairro,cnae}], total, hasMore, page }'
      parameters:
      - name: cep
        in: query
        required: true
        schema:
          type: string
        description: 8 dígitos, com ou sem hífen.
        example: '01310100'
      - name: page
        in: query
        required: false
        schema:
          type: integer
          default: 0
        description: Página 0-based da origem CNPJ (50 por página).
      responses:
        '200':
          description: '{ items[{cnpj,cnpjFormatted,razaoSocial,nomeFantasia,situacao,uf,municipio,bairro,cnae}], total, hasMore, page }'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Empresas'
        '400':
          description: CEP inválido.
        '503':
          description: API de CNPJ indisponível.
      tags:
      - Empresas
components:
  schemas:
    Empresas:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/Empresa'
          description: Cards da origem CNPJ (teto 50 por página).
        total:
          type: integer
          description: Tamanho desta página, ou total se a origem mandar.
        hasMore:
          type: boolean
          description: '`true` quando a origem tem mais estabelecimentos além do teto.'
        page:
          type: integer
          description: Página 0-based pedida à origem.
      required:
      - items
      - total
      - hasMore
      - page
      description: Estabelecimentos da Receita neste CEP, via api-cnpj no c3.
    Empresa:
      type: object
      properties:
        cnpj:
          type: string
          description: 14 dígitos, sem máscara.
        cnpjFormatted:
          type: string
          description: CNPJ com pontuação.
        razaoSocial:
          type: string
          description: Razão social na Receita.
          nullable: true
        nomeFantasia:
          type: string
          description: Nome fantasia, se houver.
          nullable: true
        situacao:
          type: object
          description: '`codigo` numérico e `label` (Ativa, Inapta, Baixada…).'
          nullable: true
        uf:
          type: string
          description: UF do estabelecimento.
          nullable: true
        municipio:
          type: string
          description: Município da Receita.
          nullable: true
        bairro:
          type: string
          description: Bairro do estabelecimento.
          nullable: true
        cnae:
          type: object
          description: '`codigo` e `descricao` da atividade principal.'
          nullable: true
      required:
      - cnpj
      - cnpjFormatted
      - razaoSocial
      - nomeFantasia
      - situacao
      - uf
      - municipio
      - bairro
      - cnae
      description: Card da busca por CEP na origem CNPJ — não é a ficha completa do Radar.