Legal Entities
GLEIF Legal Entity Identifier profiles and accounting-consolidation relationships from the Level-1 and Level-2 golden copies.
Paths are relative to https://api.agentdatasets.com. Every endpoint mirrors an MCP tool over the same service layer — the tool catalog documents the same operations for MCP clients.
GET/v1/entities/ownership
Entity Ownership
Return bounded current GLEIF Level-2 ownership evidence.
Parameters
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| lei | string | Yes | — | — | Exact uppercase 20-character Legal Entity Identifier |
| direction | "parents" | "children" | No | "parents" | — | Traverse toward parents or toward children |
| depth | integer | No | 1 | min 1, max 2 | Relationship hops to traverse |
| limit | integer | No | 50 | min 1, max 100 | Ownership links to return |
| cursor | string | null | No | — | — | Opaque cursor from pagination.next_cursor |
Example request
Required parameters only, with values taken from the schema. Optional parameters are in the table above.
[ BASH ]
curl --fail --silent --show-error \
--header "X-API-KEY: adk_..." \
"https://api.agentdatasets.com/v1/entities/ownership?lei=LEI"Response
200 Successful Response · expand a branch to see its fields.
dataEntityOwnershipDatarequiredApplied traversal and its bounded links plus reporting exceptions.
- leistringrequired
- legal_namestringrequirednullable
- direction"parents" | "children"required
- depthintegerrequired
linksarray<OwnershipLink>required
- hopintegerrequired
- child_leistringrequired
- child_namestringrequirednullable
- parent_leistringrequired
- parent_namestringrequirednullable
- relationship_typestringrequired
- relationship_statusstringrequired
- validity_startstring (date-time)requirednullable
- validity_endstring (date-time)requirednullable
- registration_statusstringrequired
- initial_registration_datestring (date-time)requirednullable
- last_update_datestring (date-time)requirednullable
- validation_sourcesstringrequirednullable
- validation_documentsstringrequirednullable
- validation_referencestringrequirednullable
- sourcestringrequired
- license_tagstringrequired
- as_ofstring (date-time)required
exceptionsarray<OwnershipException>required
- hopintegerrequired
- leistringrequired
- legal_namestringrequirednullable
- categorystringrequired
- reasonstringrequired
- reasonsarray<string>required
- exception_referencesarray<string>required
- sourcestringrequired
- license_tagstringrequired
- as_ofstring (date-time)required
metaEntitiesMetarequiredGLEIF provenance and interpretation shared by entity results.
- sourcestringrequired
- as_ofstring (date-time) | string (date)nullable
- unit"entity_record"default "entity_record"
- period"current"default "current"
paginationPaginationnullable
- limitintegerrequired
- has_morebooleanrequired
- next_cursorstringnullable
GET/v1/entities/profile
Entity
Return one current GLEIF Level-1 legal-entity profile.
Parameters
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| lei | string | Yes | — | — | Exact uppercase 20-character Legal Entity Identifier |
Example request
Required parameters only, with values taken from the schema. Optional parameters are in the table above.
[ BASH ]
curl --fail --silent --show-error \
--header "X-API-KEY: adk_..." \
"https://api.agentdatasets.com/v1/entities/profile?lei=LEI"Response
200 Successful Response · expand a branch to see its fields.
dataEntityProfileDatarequiredOne current GLEIF Level-1 legal-entity profile.
- leistringrequiredJoin key for funds_get_holdings data.holdings[].issuer_lei and any other record that carries the same 20-character LEI.
- legal_namestringrequired
- other_namesarray<string>required
- previous_namesarray<string>required
- legal_jurisdictionstringrequired
- entity_statusstringrequired
- registration_statusstringrequired
- registration_authority_idstringrequirednullable
- registration_authority_entity_idstringrequirednullable
legal_addressEntityAddressrequiredThe country and subdivision retained from a GLEIF address.
- countrystringrequirednullable
- regionstringrequirednullable
headquarters_addressEntityAddressrequiredThe country and subdivision retained from a GLEIF address.
- countrystringrequirednullable
- regionstringrequirednullable
- sourcestringrequired
- license_tagstringrequired
- as_ofstring (date-time)required
metaEntitiesMetarequiredGLEIF provenance and interpretation shared by entity results.
- sourcestringrequired
- as_ofstring (date-time) | string (date)nullable
- unit"entity_record"default "entity_record"
- period"current"default "current"
paginationPaginationnullable
- limitintegerrequired
- has_morebooleanrequired
- next_cursorstringnullable
GET/v1/entities/search
Entities Search
Search current GLEIF Level-1 legal-entity records.
Parameters
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| query | string | Yes | — | — | Legal name, alias, previous name, or 20-character LEI |
| country | string | null | No | — | — | Optional 2-letter legal-address country code |
| status | "ACTIVE" | "INACTIVE" | null | No | — | — | Optional GLEIF entity status |
| limit | integer | No | 10 | min 1, max 50 | Entity matches to return |
| cursor | string | null | No | — | — | Opaque cursor from pagination.next_cursor |
Example request
Required parameters only, with values taken from the schema. Optional parameters are in the table above.
[ BASH ]
curl --fail --silent --show-error \
--header "X-API-KEY: adk_..." \
"https://api.agentdatasets.com/v1/entities/search?query=QUERY"Response
200 Successful Response · expand a branch to see its fields.
dataEntitySearchDatarequiredEchoed filters and a bounded best-first page of entity matches.
- querystringrequired
- countrystringrequirednullable
- status"ACTIVE" | "INACTIVE"requirednullable
matchesarray<EntitySearchMatch>required
- leistringrequired20-character Legal Entity Identifier used by detail tools.
- legal_namestringrequired
- legal_jurisdictionstringrequired
- entity_statusstringrequired
- registration_statusstringrequired
- legal_address_countrystringrequirednullable
- scoreintegerrequired
- match_reasonstringrequired
- sourcestringrequired
- as_ofstring (date-time)required
metaEntitiesMetarequiredGLEIF provenance and interpretation shared by entity results.
- sourcestringrequired
- as_ofstring (date-time) | string (date)nullable
- unit"entity_record"default "entity_record"
- period"current"default "current"
paginationPaginationnullable
- limitintegerrequired
- has_morebooleanrequired
- next_cursorstringnullable