{ "openapi": "3.0.1", "info": { "title": "Corporate KYC Intelligence (LEI ownership & risk)", "description": "Look up any company's GLEIF Legal Entity Identifier (LEI) record and get its full ownership tree (direct/ultimate parent, direct children) plus a registration-status compliance flag (LAPSED/RETIRED). Uses only GLEIF's free, keyless, official API.", "version": "0.1", "x-build-id": "TA9JF8lIUKe4mXyib" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hllerdgn80~corporate-kyc-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hllerdgn80-corporate-kyc-intelligence", "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/hllerdgn80~corporate-kyc-intelligence/runs": { "post": { "operationId": "runs-sync-hllerdgn80-corporate-kyc-intelligence", "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/hllerdgn80~corporate-kyc-intelligence/run-sync": { "post": { "operationId": "run-sync-hllerdgn80-corporate-kyc-intelligence", "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": { "companies": { "title": "Companies (name or LEI code)", "type": "array", "description": "One per line: a company legal name (e.g. Google Ireland Limited) or a 20-character LEI code (e.g. HWUPKR0MPOU8FGXBT394). Duplicates are removed.", "default": [ "Apple Inc", "Google Ireland Limited", "Lehman Brothers Limited" ], "items": { "type": "string" } }, "companiesText": { "title": "Or paste a list", "type": "string", "description": "Paste many companies at once: one per line (commas and semicolons also separate entries). Combined with the list above." }, "jurisdiction": { "title": "Limit name search to jurisdiction (optional)", "type": "string", "description": "Two-letter country code, e.g. GB, US, DE. Only used when searching by name (not by LEI) and only when a company name matches several entities — narrows the match. Leave empty to search worldwide." }, "includeHierarchy": { "title": "Include ownership tree (direct + ultimate parent, direct children)", "type": "boolean", "description": "The Actor's core feature: for each company, also fetches its direct parent, ultimate parent, and up to 'Children per company' direct subsidiaries from GLEIF's official relationship data — free, no extra charge. Turn off for a faster run if you only need the base record.", "default": true }, "childrenLimit": { "title": "Direct children to list per company", "minimum": 0, "maximum": 100, "type": "integer", "description": "Maximum number of direct subsidiaries to return per company (GLEIF paginates; most companies have few or none). Capped at 100 to keep runs predictable.", "default": 25 }, "opencorporatesApiToken": { "title": "OpenCorporates API token (optional, your own)", "type": "string", "description": "OpenCorporates' free tier is rate-limited and most useful fields (officers, filings) need a paid token. If you paste your own OpenCorporates API token here, the Actor adds an 'opencorporates' enrichment block per company (company number, incorporation date, current status, source URL) using OpenCorporates' official /companies/search endpoint. Leave empty to skip — GLEIF data alone still gives the full ownership tree and compliance flag." }, "maxConcurrency": { "title": "Companies checked in parallel", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many companies to look up in parallel.", "default": 5 } } }, "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 } } } } } } } } } }