{
"openapi": "3.0.1",
"info": {
"title": "GLEIF LEI Lookup & Validator API – KYB Company Registry",
"description": "GLEIF API lookup for the global LEI registry: search by company name, validate LEI lists in bulk, filter by country, category, status or last update. Legal name, addresses, LEI status, renewal date, BIC, direct and ultimate parent. Daily change monitoring for KYB. No API key. From $1 per 1,000.",
"version": "0.1",
"x-build-id": "U1hsXAcg973kyvw30"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/opentenders~gleif-lei-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-opentenders-gleif-lei-scraper",
"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/opentenders~gleif-lei-scraper/runs": {
"post": {
"operationId": "runs-sync-opentenders-gleif-lei-scraper",
"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/opentenders~gleif-lei-scraper/run-sync": {
"post": {
"operationId": "run-sync-opentenders-gleif-lei-scraper",
"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": {
"query": {
"title": "Company name (full-text)",
"type": "string",
"description": "Full-text search over legal and other names (GLEIF filter[fulltext]), e.g. siemens, banco do brasil. Combine with country/category to narrow."
},
"leis": {
"title": "LEIs to look up",
"type": "array",
"description": "Exact 20-character LEIs, one per line, up to thousands. Each is fetched in batches of 200; LEIs not found are reported in one error row (not charged).",
"items": {
"type": "string"
}
},
"country": {
"title": "Legal address country (ISO-2)",
"type": "string",
"description": "Two-letter country code of the legal address, e.g. BR, DE, US."
},
"category": {
"title": "Entity category",
"enum": [
"",
"GENERAL",
"FUND",
"BRANCH",
"SOLE_PROPRIETOR",
"RESIDENT_GOVERNMENT_ENTITY",
"INTERNATIONAL_ORGANIZATION"
],
"type": "string",
"description": "GLEIF entity category.",
"default": ""
},
"entityStatus": {
"title": "Entity status",
"enum": [
"",
"ACTIVE",
"INACTIVE"
],
"type": "string",
"description": "Whether the legal entity itself is active or inactive (merged, dissolved). Empty = any.",
"default": ""
},
"registrationStatus": {
"title": "LEI registration status",
"type": "array",
"description": "Empty = any. ISSUED = valid and renewed; LAPSED = not renewed (a KYB red flag).",
"items": {
"type": "string",
"enum": [
"ISSUED",
"LAPSED",
"PENDING_TRANSFER",
"PENDING_ARCHIVAL",
"RETIRED",
"ANNULLED",
"MERGED",
"DUPLICATE",
"CANCELLED",
"TRANSFERRED"
]
},
"default": []
},
"updatedAfter": {
"title": "Updated after (YYYY-MM-DD)",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
"type": "string",
"description": "Only records whose LEI registration was updated on or after this date (status changes, renewals, address or name changes). Set it to yesterday in a daily schedule, together with a country or query, to monitor changes."
},
"includeParents": {
"title": "Include direct and ultimate parent",
"type": "boolean",
"description": "Also fetch the direct parent and ultimate parent entity (LEI and name) from GLEIF relationship data. Two extra requests per entity; charged as a separate, higher-priced event.",
"default": false
},
"maxItems": {
"title": "Max entities",
"minimum": 1,
"type": "integer",
"description": "Stop after this many entities. Caps your cost.",
"default": 100
},
"minResults": {
"title": "Minimum results (monitoring)",
"minimum": 0,
"type": "integer",
"description": "Optional. Fail the run if fewer entities are returned."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}