{ "openapi": "3.0.1", "info": { "title": "GLEIF LEI Search — Legal Entities, Owners, Subsidiaries", "description": "Search the global LEI register by company name, country, national company number or LEI, and get back the legal entity behind the identifier: registered name, legal and headquarters address, legal form, registration status, plus its declared parent and subsidiaries. Official GLEIF data, no key.", "version": "0.1", "x-build-id": "6wrC871DlaNjVyLQQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dalbian~gleif-lei-register-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dalbian-gleif-lei-register-search", "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/dalbian~gleif-lei-register-search/runs": { "post": { "operationId": "runs-sync-dalbian-gleif-lei-register-search", "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/dalbian~gleif-lei-register-search/run-sync": { "post": { "operationId": "run-sync-dalbian-gleif-lei-register-search", "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": { "names": { "title": "Entity names", "type": "array", "description": "Legal entity names to search, one per line — for example Airbus, Deutsche Bank. Matching is whole-word and case-insensitive: every word you type must appear as a complete word somewhere in the name, in any order. 'Airbus' returns 99 entities including AIRBUS IFC and AIRBUS OPERATIONS LIMITED; 'AIRBUS SE' returns exactly 1. Partial words do not match — 'airbu' returns nothing. Add words to narrow, remove words to widen.", "default": [ "Airbus" ], "items": { "type": "string" } }, "leis": { "title": "Or: LEI codes", "type": "array", "description": "20-character LEI codes to look up directly, one per line — for example MINO79WLOO247M1IL051. Faster and exact where you already have the identifier, and the only way to be certain which of several similarly named entities you got. Codes are fetched in batches, so a few thousand is one run. Direct lookups ignore the country, city and status filters below: you asked for that exact identifier, so you get it.", "items": { "type": "string" } }, "country": { "title": "Country of legal address", "type": "string", "description": "ISO 3166-1 alpha-2 code of the legal address — DE, FR, US, GB. Combines with the name search: 'Airbus' alone returns 99 entities, 'Airbus' plus DE returns 25. This is the registered legal address, not the headquarters.", "default": "FR" }, "city": { "title": "City of legal address", "type": "string", "description": "City of the legal address — Suresnes, Frankfurt am Main. The GLEIF API has no city filter, so this Actor applies it to the rows it has already fetched. That means it narrows the results but does not reach deeper into the register: pair it with a country and a reasonably specific name, and raise the result cap. Matching is case-insensitive and ignores accents." }, "entityStatus": { "title": "Entity status", "enum": [ "ANY", "ACTIVE", "INACTIVE" ], "type": "string", "description": "Whether the legal entity itself is still in existence. This is about the company, not about its LEI: an ACTIVE company can hold a LAPSED identifier and vice versa.", "default": "ANY" }, "registrationStatus": { "title": "LEI registration status", "enum": [ "ANY", "ISSUED", "LAPSED", "RETIRED", "ANNULLED", "MERGED", "DUPLICATE", "PENDING_TRANSFER", "PENDING_ARCHIVAL" ], "type": "string", "description": "State of the identifier itself. ISSUED is the only status that means the record was revalidated within the last twelve months, which is what most counterparty checks require. LAPSED records stay in the register and are still returned here.", "default": "ANY" }, "registeredAs": { "title": "National company number", "type": "string", "description": "The company's number in its home business register — SIREN in France, Handelsregisternummer in Germany, Companies House number in the UK. 775724792 returns AIRBUS GROUP. This is the cleanest way to attach a LEI to a record you already hold, because the number is exact where a name is not." }, "includeParents": { "title": "Include parent companies", "type": "boolean", "description": "Add a row for the direct parent and the ultimate parent of every entity found. Where an entity declares that it has no parent, the row carries GLEIF's own reason instead — NO_KNOWN_PERSON, NON_CONSOLIDATING, NATURAL_PERSONS — which is information, not a failure.", "default": false }, "includeChildren": { "title": "Include subsidiaries", "type": "boolean", "description": "Add a row for every entity that names one of your results as its direct parent. AIRBUS SE returns 31. Large groups have hundreds, so this is the setting that drives run time.", "default": false }, "maxResultsPerSearch": { "title": "Maximum results per search", "minimum": 1, "maximum": 6000, "type": "integer", "description": "Cap on entities returned for each name you search. The register holds 2.7 million entities and a common word such as 'Bank' matches tens of thousands, so this is what stops a broad search becoming a long run.", "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 } } } } } } } } } }