---
title: "GLEIF Relationships Search"
method: POST
path: "/global/gleif/relationships-search/v1"
tags: ["Global", "GLEIF (LEI)"]
---

# GLEIF Relationships Search

`POST /global/gleif/relationships-search/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/global/gleif/relationships-search/v1`
- Auth: HTTP bearer

Page through the parent relationships reported to GLEIF by child, by parent or by type: every subsidiary, fund or branch that reports an entity as its parent, or every parent an entity reports. Current relationships only unless asked. By child LEI, pages of up to 50. Served by Croma, brought up to date three times a day.

**Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `child_lei` string: LEI de 20 caracteres (opcional).
  - `parent_lei` string: LEI de 20 caracteres (opcional).
  - `relationship_type` '' | 'IS_DIRECTLY_CONSOLIDATED_BY' | 'IS_ULTIMATELY_CONSOLIDATED_BY' | 'IS_INTERNATIONAL_BRANCH_OF' | 'IS_FUND-MANAGED_BY' | 'IS_SUBFUND_OF' | 'IS_FEEDER_TO': Tipo de relación, p. ej. `IS_DIRECTLY_CONSOLIDATED_BY` (opcional).
  - `include_inactive` boolean: `true` para incluir también las relaciones que GLEIF retiró (opcional).
  - `page` integer: 1-based page number for paginated results.
  - `per_page` integer: Resultados por página (1-50).

## Response `200`

Successful response

- GleifRelationshipsSearchResponse
  - `data` GleifRelationshipsSearchData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `child_lei` string, nullable, required
    - `parent_lei` string, nullable, required
    - `relationship_type` string, nullable, required
    - `include_inactive` boolean, required
    - `total` number, required: Matches, counted up to 1000.
    - `total_is_exact` boolean, required: False when more than 1000 match: `total` is then 1000, and the pages go on.
    - `page` number, required
    - `per_page` number, required
    - `total_pages` number, required: Pages over `total`; there are more when `total_is_exact` is false.
    - `count` number, required
    - `relationships` object[], required
      - `id` string, required: The child's LEI and the relationship type, joined by a colon. The key: a child reports one parent per type.
      - `child_lei` string, required: The LEI of the entity that reports the relationship (the subsidiary, the fund, the branch).
      - `parent_lei` string, required: The LEI of the parent: the consolidating entity, the fund manager, the umbrella fund, the head office.
      - `relationship_type` string, required: `IS_DIRECTLY_CONSOLIDATED_BY`, `IS_ULTIMATELY_CONSOLIDATED_BY`, `IS_INTERNATIONAL_BRANCH_OF`, `IS_FUND-MANAGED_BY`, `IS_SUBFUND_OF` or `IS_FEEDER_TO`.
      - `relationship_status` string, nullable, required: `ACTIVE` or `INACTIVE`.
      - `periods` object[], required: `RELATIONSHIP_PERIOD`, `ACCOUNTING_PERIOD`, `DOCUMENT_FILING_PERIOD`.
        - `start_date` string, nullable, required
        - `end_date` string, nullable, required
        - `type` string, nullable, required
      - `qualifiers` object[], required: e.g. the accounting standard, `IFRS` or `US_GAAP`.
        - `dimension` string, nullable, required
        - `category` string, nullable, required
      - `quantifiers` object[], required: e.g. the percentage of consolidation.
        - `method` string, nullable, required
        - `amount` string, nullable, required
        - `units` string, nullable, required
      - `initial_registration_date` string, nullable, required
      - `last_update_date` string, nullable, required
      - `registration_status` string, nullable, required: `PUBLISHED`, `LAPSED`, `PENDING_ARCHIVAL`…
      - `next_renewal_date` string, nullable, required
      - `managing_lou` string, nullable, required
      - `validation_sources` string, nullable, required
      - `validation_documents` string, nullable, required
      - `validation_reference` string, nullable, required
      - `current` boolean, required: False once GLEIF has withdrawn the relationship.
      - `withdrawn_at` string, nullable, required: When GLEIF withdrew the relationship, if it has.

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)