Skip to main content
POST
GLEIF companies search

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
keyword
string
required

Company name or LEI. e.g. Apple

max_items
integer
default:25

Max items (up to 250)

Required range: 1 <= x <= 250
start_page
integer

Starting page

Required range: x >= 1
status
enum<string>

Active or inactive LEI. Options: active = Active, inactive = Inactive / dissolved

Available options:
active,
inactive
reg_status
enum<string>

LEI status (exact). Options: ISSUED = Issued, LAPSED = Lapsed, ANNULLED = Annulled, RETIRED = Retired, MERGED = Merged, DUPLICATE = Duplicate, PENDING_TRANSFER = Pending transfer, PENDING_ARCHIVAL = Pending archival, PENDING_NAME_TRANSFER = Pending name transfer, PENDING_NAME_TRANSFER_MERGER = Pending name transfer (merger), PENDING_VALIDATION = Pending validation

Available options:
ISSUED,
LAPSED,
ANNULLED,
RETIRED,
MERGED,
DUPLICATE,
PENDING_TRANSFER,
PENDING_ARCHIVAL,
PENDING_NAME_TRANSFER,
PENDING_NAME_TRANSFER_MERGER,
PENDING_VALIDATION
category
enum<string>

Entity category. Options: GENERAL = General, FUND = Fund, BRANCH = Branch, SOLE_PROPRIETOR = Sole proprietor, INTERNATIONAL_ORGANIZATION = International organization, RESPONSIBLE_ENTITY = Responsible entity

Available options:
GENERAL,
FUND,
BRANCH,
SOLE_PROPRIETOR,
INTERNATIONAL_ORGANIZATION,
RESPONSIBLE_ENTITY
country
string

Country (2-letter code). e.g. DE

Response

Run completed.

session_id
string

Session identifier for this run.

kind
string

Data source identifier for this endpoint.

keyword
string
max_items
integer
start_page
integer
partial
boolean

True when the scrape stopped early and returned the records collected so far.

human
string

Markdown summary of the result, for display.

machine
object

Structured result payload.

total_points
integer

Points charged for this run.