---
title: "LEI Verification"
method: GET
path: "/lei"
---

# LEI Verification

`GET /lei`

A Legal Entity Identifier (LEI) is a unique 20-character alphanumeric code used to identify distinct legal entities that engage in financial transactions. The LEI is part of a global initiative to improve the transparency and stability of the financial system by enabling clear and precise identification of parties involved in financial transactions.

## Headers

- `X-Ipay-Auth-Code` string
- `X-Ipay-Client-Id` string
- `X-Ipay-Client-Secret` string
- `X-Ipay-Endpoint-Ip` string

## Request body

- object
  - `value` string
  - `latitude` string — End Customer Latitude.
  - `longitude` string — End Customer Longitude.
  - `externalRef` string — Your Unique Transaction id
  - `consent` string — Consent should be accepted by customer
  - `type` string
  - `pagination` object
    - `pageNumber` string
    - `recordsPerPage` string

## Response `200`

200

- object
  - `statuscode` string
  - `actcode` unknown
  - `status` string
  - `data` object
    - `poolReferenceId` string
    - `pool` object
      - `openingBal` string
      - `mode` string
      - `amount` string
      - `closingBal` string
    - `meta` object
      - `totalPages` integer
      - `currentPage` integer
      - `totalRecords` integer
      - `recordsOnCurrentPage` integer
      - `recordFrom` integer
      - `recordTo` integer
    - `record` object[]
      - `lei` string
      - `entity` object
        - `legalName` object
          - `name` string
          - `language` string
        - `otherNames` unknown[]
          - unknown
        - `transliteratedOtherNames` unknown[]
          - unknown
        - `legalAddress` object
          - `language` string
          - `addressLines` string[]
          - `addressNumber` unknown
          - `addressNumberWithinBuilding` unknown
          - `mailRouting` unknown
          - `city` string
          - `region` string
          - `country` string
          - `postalCode` string
        - `headquartersAddress` object
          - `language` string
          - `addressLines` string[]
          - `addressNumber` unknown
          - `addressNumberWithinBuilding` unknown
          - `mailRouting` unknown
          - `city` string
          - `region` string
          - `country` string
          - `postalCode` string
        - `registeredAt` object
          - `id` string
          - `other` unknown
        - `registeredAs` string
        - `jurisdiction` string
        - `category` string
        - `legalForm` object
          - `id` string
          - `other` unknown
        - `associatedEntity` object
          - `lei` unknown
          - `name` unknown
        - `status` string
        - `expiration` object
          - `date` unknown
          - `reason` unknown
        - `successorEntity` object
          - `lei` string
          - `name` unknown
        - `successorEntities` object[]
          - `lei` string
        - `creationDate` unknown
        - `subCategory` unknown
        - `otherAddresses` unknown[]
          - unknown
        - `eventGroups` object[]
          - `groupType` string
          - `events` object[]
            - `validationDocuments` string
            - `effectiveDate` string
            - `recordedDate` string
            - `type` string
            - `status` string
            - `affectedFields` object[]
              - …
      - `registration` object
        - `initialRegistrationDate` string
        - `lastUpdateDate` string
        - `status` string
        - `nextRenewalDate` string
        - `managingLou` string
        - `corroborationLevel` string
        - `validatedAt` object
          - `id` string
          - `other` unknown
        - `validatedAs` string
        - `otherValidationAuthorities` object[]
          - `validatedAt` object
            - `id` string
          - `validatedAs` string
      - `bic` unknown
      - `mic` unknown
      - `ocid` unknown
      - `spglobal` string[]
      - `conformityFlag` string
  - `timestamp` string
  - `ipay_uuid` string
  - `orderid` string
  - `environment` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/instantpay/apis/identity.md) · [All operations](https://skmtc.net/instantpay/apis/identity/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instantpay/identity/versions/1d0672797b14/schema)