{ "openapi": "3.0.1", "info": { "title": "LEI Company Search & New Registrations (GLEIF data)", "description": "Search 3M+ companies in the global LEI registry by name, country, legal form or status, get newly registered companies, or look up LEI codes in bulk. Parent companies optional. Fast, no API key, no personal data.", "version": "0.1", "x-build-id": "UXkAbA5KkPu9rIhsT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bircolabots~lei-company-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bircolabots-lei-company-data", "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/bircolabots~lei-company-data/runs": { "post": { "operationId": "runs-sync-bircolabots-lei-company-data", "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/bircolabots~lei-company-data/run-sync": { "post": { "operationId": "run-sync-bircolabots-lei-company-data", "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": { "companyName": { "title": "Company name", "type": "string", "description": "Words of the legal name, e.g. \"siemens\" or \"deutsche bank\". Leave empty to list companies by the filters below." }, "fullText": { "title": "Any text (name, address, city, registration number...)", "type": "string", "description": "Free-text search over every field of the record, e.g. a city like \"Rotterdam\" or a national registration number." }, "countries": { "title": "Countries (legal address)", "type": "array", "description": "Two-letter ISO country codes of the legal address, e.g. \"DE\", \"GB\", \"US\". Leave empty for all countries.", "items": { "type": "string" } }, "registeredWithinDays": { "title": "Only companies that got their LEI in the last N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "New-registrations feed: only companies whose LEI was first issued in the last N days. Schedule the Actor daily with 1 or 2 days to get new companies every day. Leave empty for no date filter." }, "entityStatus": { "title": "Company status", "enum": [ "ACTIVE", "INACTIVE", "ANY" ], "type": "string", "description": "Legal status of the company itself.", "default": "ACTIVE" }, "registrationStatus": { "title": "LEI registration status", "enum": [ "ANY", "ISSUED", "LAPSED", "RETIRED", "ANNULLED", "PENDING_TRANSFER", "PENDING_ARCHIVAL", "DUPLICATE" ], "type": "string", "description": "Status of the LEI registration. \"Lapsed\" means the company did not renew its LEI - useful for compliance and outreach.", "default": "ANY" }, "categories": { "title": "Entity category", "type": "array", "description": "Leave empty for all categories. Sole proprietors are never returned (personal data).", "items": { "type": "string", "enum": [ "GENERAL", "FUND", "BRANCH", "INTERNATIONAL_ORGANIZATION", "RESIDENT_GOVERNMENT_ENTITY" ], "enumTitles": [ "Companies and other legal entities", "Funds", "Branches", "International organizations", "Government entities" ] } }, "legalForms": { "title": "Legal form codes (ELF)", "type": "array", "description": "ISO 20275 Entity Legal Form codes (4 characters), e.g. \"2HBR\" for German GmbH. The code list is published by GLEIF. Leave empty for all legal forms.", "items": { "type": "string" } }, "leiCodes": { "title": "LEI codes to look up", "type": "array", "description": "Bulk lookup: paste up to 10,000 LEI codes (20 characters each). When this list is filled, the search fields and filters above are ignored and every valid code is looked up.", "items": { "type": "string" } }, "includeParents": { "title": "Include parent companies", "type": "boolean", "description": "Add the direct and ultimate parent company (name and LEI) to each result. Needs 2 extra requests per company, so runs with this option are limited to 500 companies and take longer.", "default": false }, "maxItems": { "title": "Maximum number of companies", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many companies. You pay per company saved, so this also caps the cost. Not used in bulk lookup mode.", "default": 100 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }