# getLegalEntity

**Identifier:** `gleif_getLegalEntity`

**Provider:** [GLEIF](https://kirha.com/providers/gleif.md)

Reference record of one legal entity by its LEI: legal name and other names, legal and headquarters addresses, jurisdiction, legal form, national registration number, entity status, LEI registration status and renewal date, BIC codes and the ISINs it issued. Use it to verify a counterparty's identity.

## Run it with the CLI

```bash
kirha tools run gleif_getLegalEntity \
  --input '{
    "lei": "<lei>"
  }'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "gleif_getLegalEntity",
  "input": {
    "lei": "<lei>"
  }
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "lei": {
      "description": "20-character LEI",
      "pattern": "^[A-Za-z0-9]{20}$",
      "type": "string"
    }
  },
  "required": [
    "lei"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "bicCodes": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "category": {
      "type": "string"
    },
    "context": {
      "type": "string"
    },
    "corroborationLevel": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "entityCreatedOn": {
      "type": "string"
    },
    "entityStatus": {
      "type": "string"
    },
    "headquartersAddress": {
      "type": "string"
    },
    "isins": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "jurisdiction": {
      "type": "string"
    },
    "legalAddress": {
      "type": "string"
    },
    "legalFormCode": {
      "type": "string"
    },
    "legalName": {
      "type": "string"
    },
    "lei": {
      "type": "string"
    },
    "leiFirstRegisteredOn": {
      "type": "string"
    },
    "leiLastUpdatedOn": {
      "type": "string"
    },
    "leiNextRenewalOn": {
      "type": "string"
    },
    "leiStatus": {
      "type": "string"
    },
    "otherNames": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "registrationNumber": {
      "type": "string"
    },
    "totalIsins": {
      "type": "number"
    },
    "url": {
      "type": "string"
    }
  },
  "required": [
    "context",
    "lei",
    "url",
    "otherNames",
    "bicCodes",
    "totalIsins",
    "isins"
  ],
  "type": "object"
}
```

-----

[All GLEIF tools](https://kirha.com/providers/gleif.md) · [< Back to tools list](https://kirha.com/tools.md)