{ "openapi": "3.0.1", "info": { "title": "CNPJ Lookup — Consulta CNPJ Receita Federal (Brazil)", "description": "Brazil CNPJ lookup and company data from Receita Federal open data: legal name, trade name, registration status, CNAE activities, legal nature, share capital, size, address, contacts and the full list of partners. Batch input, two official mirrors with automatic failover.", "version": "0.1", "x-build-id": "aDvkIIy50SbbtMgOU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/publicdata~cnpj-lookup-receita-federal/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-publicdata-cnpj-lookup-receita-federal", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/publicdata~cnpj-lookup-receita-federal/runs": { "post": { "operationId": "runs-sync-publicdata-cnpj-lookup-receita-federal", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/publicdata~cnpj-lookup-receita-federal/run-sync": { "post": { "operationId": "run-sync-publicdata-cnpj-lookup-receita-federal", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "cnpjList": { "title": "CNPJ numbers", "type": "array", "description": "Brazilian company tax IDs to look up. With or without punctuation — 14 digits each. Head office CNPJs end in 0001-XX.", "items": { "type": "string" } }, "cnpjText": { "title": "Or paste a list", "type": "string", "description": "Alternative to the field above: paste many CNPJs separated by commas, spaces or new lines (e.g. straight from a spreadsheet column)." }, "includePartners": { "title": "Include partners", "type": "boolean", "description": "Include the quadro societário (partners and officers). Names come from the public Receita Federal register.", "default": true }, "includeContacts": { "title": "Include phone and e-mail", "type": "boolean", "description": "Include the registered phone number and e-mail address. The primary mirror publishes the e-mail key but never fills it (0 of 205 companies in a live random sample on 2026-08-21), so with this on the Actor spends one extra lookup per company on the OpenCNPJ mirror, which does publish it. Measured on that same sample of 205: phone on 182 rows, e-mail on 149. Leave it off for large runs that do not need contacts - it halves the number of requests.", "default": true }, "skipInactive": { "title": "Skip inactive companies", "type": "boolean", "description": "Drop companies whose registration is not ATIVA. Dropped companies are not exported and not charged; with a Max results cap set, the run reads further down your list to replace them.", "default": false }, "maxItems": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Hard cap on rows exported (0 = unlimited). The run keeps reading down your list until this many rows are exported or the list runs out, so companies dropped by 'Skip inactive companies' are backfilled from the rest of the input.", "default": 0 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }