GLEIF | Apiosk Gateway

Method	Path	Description	Cost
GET	/api/v1/lei-records	Search and retrieve official GLEIF LEI records. Without a path LEI this is the LEI-record collection and supports entity-name, country, status and mapped-identifier filters. With a 20-character LEI appended as a path segment it returns the canonical record for that legal entity. The response is JSON:API and includes the LEI, primary legal name, other names, legal and headquarters addresses, jurisdiction, legal form, entity status, registration authority, LEI registration status and registration/renewal dates; mapped identifiers and relationship links may also be present.	Free default	View details
GET	/autocompletions	Autocomplete/typeahead search over LEI Data fields — matches on the start of a value, with a related link back to the full LEI record.	$0.02 default	View details
GET	/countries	ISO country code reference table used by LEI Data's address and jurisdiction fields. List all, or supply code for one country's name, e.g. DE.	$0.02 default	View details
GET	/entity-legal-forms	ELF (Entity Legal Form) code reference table used by LEI Data's entity.legalForm field — e.g. what legal form code "T91T" means. List all, or supply code for one ELF code's detail.	$0.02 default	View details
GET	/fields	Machine-readable metadata for every LEI/Relationship/Reporting-Exception data field GLEIF's API exposes: label, data type, allowed enum values, which resource it lives on, and whether it is sortable/filterable. Useful for building a query against lei-records without guessing field names.	$0.02 default	View details
GET	/fuzzycompletions	Fuzzy/statistical name matching against LEI Record data — the way to find a legal entity when its exact registered name is not known. Returns matched values with a related link back to the full LEI record, not the record itself.	$0.04 default	View details
GET	/jurisdictions	Jurisdiction code reference table used by LEI Data's entity.jurisdiction field. List all, or supply code for one jurisdiction's name.	$0.02 default	View details
GET	/lei-issuers	List accredited LEI Issuing Organizations (Local Operating Units / LOUs), or supply id for one issuer's detail — name, marketing name, website, accreditation date.	$0.03 default	View details
GET	/lei-records	Search or look up Legal Entity Identifier (LEI) records. Search with query filters — filter[fulltext] (any field), filter[entity.legalName], filter[lei] (comma-separated LEIs), filter[bic], filter[isin], filter[entity.legalAddress.country], filter[entity.category] (e.g. FUND), filter[registration.status] (e.g. LAPSED), filter[owns]/filter[ownedBy] (find parents/children of an LEI) — or supply lei for one record's full detail. A caller building the raw request path directly (not through structured parameters) can also append further segments after the LEI for related data at the same price: /direct-parent, /direct-parent-relationship, /ultimate-parent, /ultimate-parent-relationship, /isins, /lei-issuer, /managing-lou, /field-modifications. Results over 15 are paginated with page[number]/page[size].	$0.05 default	View details
GET	/official-organizational-roles	Official organizational role code reference table (e.g. director, officer roles used in some LEI-adjacent filings). List all, or supply code for one role.	$0.02 default	View details
GET	/regions	ISO 3166-2 region/subdivision code reference table (e.g. state or province codes) used by LEI Data address fields. List all, or supply code for one region.	$0.02 default	View details
GET	/registration-agents	List registration agents — third parties that register and manage LEIs on behalf of legal entities.	$0.02 default	View details
GET	/registration-authorities	Registration Authority (RA) code reference table — the official business registries LEI records point to via registration.registeredAt (e.g. "RA000602" -> Delaware Division of Corporations). List all, or supply code for one RA's detail.	$0.02 default	View details
GET	/vlei-issuers	List GLEIF-qualified vLEI (verifiable LEI) Issuers — organizations authorized to issue the cryptographically verifiable credential form of the LEI.	$0.02 default	View details

Endpoint documentation

GET/api/v1/lei-records

Free default

Description

Search and retrieve official GLEIF LEI records. Without a path LEI this is the LEI-record collection and supports entity-name, country, status and mapped-identifier filters. With a 20-character LEI appended as a path segment it returns the canonical record for that legal entity. The response is JSON:API and includes the LEI, primary legal name, other names, legal and headquarters addresses, jurisdiction, legal form, entity status, registration authority, LEI registration status and registration/renewal dates; mapped identifiers and relationship links may also be present.

Pricing

Free default

Parameters

{
  "filter[bic]": {
    "description": "BIC mapped to an LEI. Used to resolve a bank/business identifier to legal entities.",
    "required": false,
    "type": "string"
  },
  "filter[entity.legalAddress.country]": {
    "description": "ISO 3166-1 alpha-2 country code used to narrow entity results, for example NL or DE.",
    "pattern": "^[A-Z]{2}$",
    "required": false,
    "type": "string"
  },
  "filter[entity.names]": {
    "description": "Legal entity/company name search term. Used by Apiosk company-name search and LEI resolution.",
    "required": false,
    "type": "string"
  },
  "filter[entity.status]": {
    "description": "Entity status filter, for example ACTIVE.",
    "required": false,
    "type": "string"
  },
  "lei": {
    "description": "20-character Legal Entity Identifier. When supplied, retrieve that single LEI record.",
    "pattern": "^[A-Z0-9]{20}$",
    "required": false,
    "type": "string",
    "x-parameter-location": "path"
  },
  "page[size]": {
    "description": "Requested result page size.",
    "required": false,
    "type": "integer"
  }
}

Response schema

{
  "properties": {
    "data": {
      "description": "JSON:API resource object for a single LEI lookup or array of resource objects for collection search.",
      "oneOf": [
        {
          "type": "object"
        },
        {
          "items": {
            "type": "object"
          },
          "type": "array"
        }
      ]
    },
    "included": {
      "items": {
        "type": "object"
      },
      "type": "array"
    },
    "links": {
      "type": "object"
    },
    "meta": {
      "type": "object"
    }
  },
  "type": "object"
}

Example response

{
  "data": [
    {
      "attributes": {
        "entity": {
          "legalAddress": {
            "country": "NL"
          },
          "legalName": {
            "name": "Example Legal Entity"
          },
          "status": "ACTIVE"
        },
        "lei": "HWUPKR0MPOU8FGXBT394",
        "registration": {
          "status": "ISSUED"
        }
      },
      "id": "HWUPKR0MPOU8FGXBT394",
      "type": "lei-records"
    }
  ]
}

GET/autocompletions

$0.02 default

Description

Autocomplete/typeahead search over LEI Data fields — matches on the start of a value, with a related link back to the full LEI record.

Pricing

$0.02 default

Parameters

{
  "field": {
    "description": "LEI Data field to search, e.g. fulltext.",
    "enum": [
      "entity.legalName",
      "fulltext"
    ],
    "required": true,
    "type": "string"
  },
  "q": {
    "description": "Partial search term to autocomplete.",
    "required": true,
    "type": "string"
  }
}

Example response

{
  "data": [
    {
      "attributes": {
        "highlighting": "<b>BANK</b>",
        "value": "BANK"
      },
      "relationships": {
        "lei-records": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/2549000C5KZ15Q2U9V68"
          }
        }
      },
      "type": "autocompletions"
    }
  ]
}

GET/countries

$0.02 default

Description

ISO country code reference table used by LEI Data's address and jurisdiction fields. List all, or supply code for one country's name, e.g. DE.

Pricing

$0.02 default

Parameters

{
  "code": {
    "description": "ISO country code, e.g. DE. Omit to list all countries.",
    "required": false,
    "type": "string",
    "x-parameter-location": "path"
  }
}

Example response

{
  "data": {
    "attributes": {
      "code": "DE",
      "name": "Germany"
    },
    "id": "DE",
    "type": "countries"
  }
}

GET/entity-legal-forms

$0.02 default

Description

ELF (Entity Legal Form) code reference table used by LEI Data's entity.legalForm field — e.g. what legal form code "T91T" means. List all, or supply code for one ELF code's detail.

Pricing

$0.02 default

Parameters

{
  "code": {
    "description": "ELF code, e.g. T91T. Omit to list all legal forms.",
    "required": false,
    "type": "string",
    "x-parameter-location": "path"
  }
}

Example response

{
  "data": {
    "attributes": {
      "code": "T91T",
      "country": "United States of America",
      "jurisdiction": "Delaware",
      "names": [
        {
          "language": "English",
          "localName": "Limited Partnership"
        }
      ]
    },
    "id": "T91T",
    "type": "entity-legal-forms"
  }
}

GET/fields

$0.02 default

Description

Machine-readable metadata for every LEI/Relationship/Reporting-Exception data field GLEIF's API exposes: label, data type, allowed enum values, which resource it lives on, and whether it is sortable/filterable. Useful for building a query against lei-records without guessing field names.

Pricing

$0.02 default

Parameters

{}

GET/fuzzycompletions

$0.04 default

Description

Fuzzy/statistical name matching against LEI Record data — the way to find a legal entity when its exact registered name is not known. Returns matched values with a related link back to the full LEI record, not the record itself.

Pricing

$0.04 default

Parameters

{
  "field": {
    "description": "LEI Data field to search, e.g. entity.legalName (name only) or fulltext (all fields including address).",
    "enum": [
      "entity.legalName",
      "fulltext",
      "owns",
      "ownedBy"
    ],
    "required": true,
    "type": "string"
  },
  "q": {
    "description": "Search term, e.g. a company name fragment.",
    "required": true,
    "type": "string"
  }
}

Example response

{
  "data": [
    {
      "attributes": {
        "value": "Bank of America"
      },
      "relationships": {
        "lei-records": {
          "links": {
            "related": "https://api.gleif.org/api/v1/lei-records/9DJT3UXIJIZJI4WXO774"
          }
        }
      },
      "type": "fuzzycompletions"
    }
  ]
}

GET/jurisdictions

$0.02 default

Description

Jurisdiction code reference table used by LEI Data's entity.jurisdiction field. List all, or supply code for one jurisdiction's name.

Pricing

$0.02 default

Parameters

{
  "code": {
    "description": "Jurisdiction code. Omit to list all jurisdictions.",
    "required": false,
    "type": "string",
    "x-parameter-location": "path"
  }
}

GET/lei-issuers

$0.03 default

Description

List accredited LEI Issuing Organizations (Local Operating Units / LOUs), or supply id for one issuer's detail — name, marketing name, website, accreditation date.

Pricing

$0.03 default

Parameters

{
  "id": {
    "description": "A known issuer id (usually the issuer's own LEI) to fetch that issuer's detail directly. Omit to list all issuers.",
    "required": false,
    "type": "string",
    "x-parameter-location": "path"
  }
}

Example response

{
  "data": {
    "attributes": {
      "marketingName": "Bloomberg",
      "name": "Bloomberg Finance L.P.",
      "website": "http://lei.bloomberg.com"
    },
    "id": "5493001KJTIIGC8Y1R12",
    "type": "lei-issuers"
  }
}

GET/lei-records

$0.05 default

Description

Search or look up Legal Entity Identifier (LEI) records. Search with query filters — filter[fulltext] (any field), filter[entity.legalName], filter[lei] (comma-separated LEIs), filter[bic], filter[isin], filter[entity.legalAddress.country], filter[entity.category] (e.g. FUND), filter[registration.status] (e.g. LAPSED), filter[owns]/filter[ownedBy] (find parents/children of an LEI) — or supply lei for one record's full detail. A caller building the raw request path directly (not through structured parameters) can also append further segments after the LEI for related data at the same price: /direct-parent, /direct-parent-relationship, /ultimate-parent, /ultimate-parent-relationship, /isins, /lei-issuer, /managing-lou, /field-modifications. Results over 15 are paginated with page[number]/page[size].

Pricing

$0.05 default

Parameters

{
  "filter[bic]": {
    "description": "Find the LEI record for a BIC/SWIFT code.",
    "required": false,
    "type": "string"
  },
  "filter[entity.legalAddress.country]": {
    "description": "ISO country code, e.g. DE.",
    "required": false,
    "type": "string"
  },
  "filter[entity.legalName]": {
    "description": "Search only the entity's registered legal name.",
    "required": false,
    "type": "string"
  },
  "filter[fulltext]": {
    "description": "Full-text search across all LEI record fields.",
    "required": false,
    "type": "string"
  },
  "filter[isin]": {
    "description": "Find the LEI record for an ISIN.",
    "required": false,
    "type": "string"
  },
  "lei": {
    "description": "A known 20-character LEI to fetch that record directly, e.g. 5493001KJTIIGC8Y1R12. Omit to search instead using the filter[...] query parameters described above.",
    "required": false,
    "type": "string",
    "x-parameter-location": "path"
  },
  "page[number]": {
    "description": "Page number for paginated results.",
    "required": false,
    "type": "integer"
  },
  "page[size]": {
    "description": "Results per page (default 15).",
    "required": false,
    "type": "integer"
  }
}

Example response

{
  "data": {
    "attributes": {
      "entity": {
        "legalAddress": {
          "city": "Wilmington",
          "country": "US"
        },
        "legalName": {
          "name": "Bloomberg Finance L.P."
        },
        "status": "ACTIVE"
      },
      "lei": "5493001KJTIIGC8Y1R12",
      "registration": {
        "status": "ISSUED"
      }
    },
    "id": "5493001KJTIIGC8Y1R12",
    "type": "lei-records"
  }
}

GET/official-organizational-roles

$0.02 default

Description

Official organizational role code reference table (e.g. director, officer roles used in some LEI-adjacent filings). List all, or supply code for one role.

Pricing

$0.02 default

Parameters

{
  "code": {
    "description": "Role code. Omit to list all roles.",
    "required": false,
    "type": "string",
    "x-parameter-location": "path"
  }
}

GET/regions

$0.02 default

Description

ISO 3166-2 region/subdivision code reference table (e.g. state or province codes) used by LEI Data address fields. List all, or supply code for one region.

Pricing

$0.02 default

Parameters

{
  "code": {
    "description": "ISO 3166-2 region code, e.g. AD-02. Omit to list all regions.",
    "required": false,
    "type": "string",
    "x-parameter-location": "path"
  }
}

Example response

{
  "data": {
    "attributes": {
      "code": "AD-02",
      "names": [
        {
          "language": "ca",
          "name": "Canillo"
        }
      ]
    },
    "id": "AD-02",
    "type": "regions"
  }
}

GET/registration-agents

$0.02 default

Description

List registration agents — third parties that register and manage LEIs on behalf of legal entities.

Pricing

$0.02 default

Parameters

{}

GET/registration-authorities

$0.02 default

Description

Registration Authority (RA) code reference table — the official business registries LEI records point to via registration.registeredAt (e.g. "RA000602" -> Delaware Division of Corporations). List all, or supply code for one RA's detail.

Pricing

$0.02 default

Parameters

{
  "code": {
    "description": "RA code, e.g. RA000602. Omit to list all registration authorities.",
    "required": false,
    "type": "string",
    "x-parameter-location": "path"
  }
}

Example response

{
  "data": {
    "attributes": {
      "code": "RA000001",
      "internationalName": "Afghanistan Central Business Registry (Ministry of Commerce and Industries)",
      "website": "http://www.acbr.gov.af/"
    },
    "id": "RA000001",
    "type": "registration-authorities"
  }
}

GET/vlei-issuers

$0.02 default

Description

List GLEIF-qualified vLEI (verifiable LEI) Issuers — organizations authorized to issue the cryptographically verifiable credential form of the LEI.

Pricing

$0.02 default

Parameters

{}