{
  "openapi": "3.0.1",
  "info": {
    "title": "GLEIF LEI Records Scraper (Global Entities)",
    "description": "Every LEI record from the official GLEIF API: legal name, legal and HQ address, jurisdiction, legal form, national register number, LEI status, renewal dates.",
    "version": "0.1",
    "x-build-id": "Zr6lT0Oe6gt8KfK89"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/knotty_mistveil~gleif-lei-records/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-knotty_mistveil-gleif-lei-records",
        "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/knotty_mistveil~gleif-lei-records/runs": {
      "post": {
        "operationId": "runs-sync-knotty_mistveil-gleif-lei-records",
        "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/knotty_mistveil~gleif-lei-records/run-sync": {
      "post": {
        "operationId": "run-sync-knotty_mistveil-gleif-lei-records",
        "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": {
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Two-letter ISO 3166 codes matched against the entity's LEGAL address country, e.g. SG, US, GB, DE. Several codes are ORed. Empty = every country. Note that this is the legal address, not the headquarters address, and not the jurisdiction of formation.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "daysBack": {
            "title": "Days back (initial LEI registration)",
            "minimum": 1,
            "maximum": 6000,
            "type": "integer",
            "description": "Look-back window in days on the LEI's initial registration date, ending now. Ignored when Registered from / Registered to are set. The Global LEI System started issuing in 2012, so 5000 reaches the first record.",
            "default": 30
          },
          "registeredFrom": {
            "title": "Registered from",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "Start of the initial-registration window, YYYY-MM-DD (inclusive, from 00:00:00 UTC). Overrides Days back. When Updated within days is set this becomes an extra filter on top of the update window."
          },
          "registeredTo": {
            "title": "Registered to",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string",
            "description": "End of the initial-registration window, YYYY-MM-DD (inclusive, to 23:59:59 UTC). Defaults to now."
          },
          "updatedWithinDays": {
            "title": "Updated within days (turns the run into a change feed)",
            "minimum": 1,
            "maximum": 6000,
            "type": "integer",
            "description": "Set this to watch records that CHANGED rather than records that are new: the run then windows and sorts on the LEI registration's last-update date instead of its initial registration date, and Days back is ignored. Registered from / Registered to still apply, as an extra filter. Empty = a new-registrations run."
          },
          "entityStatus": {
            "title": "Entity status",
            "enum": [
              "ACTIVE",
              "INACTIVE",
              "any"
            ],
            "type": "string",
            "description": "The legal entity's own status. ACTIVE = the entity still exists; INACTIVE = it has been dissolved or merged away.",
            "default": "ACTIVE"
          },
          "registrationStatus": {
            "title": "LEI registration status",
            "enum": [
              "ISSUED",
              "LAPSED",
              "ANNULLED",
              "PENDING_TRANSFER",
              "PENDING_ARCHIVAL",
              "DUPLICATE",
              "RETIRED",
              "MERGED",
              "any"
            ],
            "type": "string",
            "description": "The status of the LEI registration itself. ISSUED = current and renewed on time; LAPSED = not renewed by its due date but still published; the rest are administrative end states.",
            "default": "ISSUED"
          },
          "categories": {
            "title": "Entity categories",
            "type": "array",
            "description": "GLEIF entity categories. Empty = all categories.",
            "items": {
              "type": "string",
              "enum": [
                "GENERAL",
                "FUND",
                "BRANCH",
                "SOLE_PROPRIETOR",
                "RESIDENT_GOVERNMENT_ENTITY",
                "INTERNATIONAL_ORGANIZATION"
              ],
              "enumTitles": [
                "General (ordinary companies)",
                "Fund",
                "Branch of a foreign entity",
                "Sole proprietor",
                "Resident government entity",
                "International organization"
              ]
            },
            "default": []
          },
          "legalForms": {
            "title": "ELF legal-form codes",
            "type": "array",
            "description": "ISO 20275 Entity Legal Form codes, four characters each, e.g. Y8W9 (Singapore exempt private company), IWZF (Singapore private company limited by shares), XTIQ (US Delaware corporation). Several codes are ORed. Empty = all legal forms. The full list is at https://www.gleif.org/en/about-lei/code-lists/iso-20275-entity-legal-forms-code-list",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Terms passed to GLEIF's full-text search, which covers every field of the LEI record including the legal name, other names and the addresses. Terms are ORed by running one newest-first pass per term and skipping LEIs already delivered. A term containing spaces is matched as all of its words. Empty = no keyword filter.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "resolveCodes": {
            "title": "Resolve legal-form and registration-authority codes to names",
            "type": "boolean",
            "description": "Look the ELF legal-form code and the RA registration-authority code up in GLEIF's own code lists, so `legalForm` reads \"Private Company Limited by Shares\" instead of \"IWZF\" and `registrationAuthority` reads \"Accounting and Corporate Regulatory Authority (ACRA)\" instead of \"RA000523\". Codes are cached for the run and the whole list is downloaded once a run needs many of them. Turn this off to spend every request on records instead.",
            "default": true
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Stop after this many LEI records. You are charged per record delivered, so this is also the cost cap. Newest first, so a value below the window's volume drops the OLDEST records in the window. Measured 8 September 2026: 30 days of new registrations is about 25,600 worldwide, 2,249 for US, 1,675 for DE, 1,216 for GB and 121 for SG.",
            "default": 500
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}