---
title: "Verify Entity Ownership"
method: POST
path: "/verifications/v2/entity"
tags: ["Entity Verification"]
---

# Verify Entity Ownership

`POST /verifications/v2/entity`

## Request

- Base URL: `https://sandbox.leantech.me`
- URL: `https://sandbox.leantech.me/verifications/v2/entity`
- Auth: HTTP bearer

Verifies the end-user's connected entity ownership by matching identification against bank records for multiple IBANs via EMIRATES_ID or FULL_NAME.

## Request body

- EntityVerificationApiRequest
  - `identifications` EntityIdentificationDto[]: Entity identifications for verification
    - `type` 'EMIRATES_ID' | 'FULL_NAME': `EMIRATES_ID`: Emirates identification number `FULL_NAME`: Complete name of the account holder
    - `value` string: Identification value
  - `entity_id` string, uuid, required: Entity ID as in the Lean's records

## Response `200`

OK

- VerificationResponseEntityVerificationResponsePayload
  - `status` 'OK' | 'PENDING' | 'FAILED' | 'CONSENT_EXPIRED' | 'RECONNECT_REQUIRED' | 'PROCESSING_STARTED', required: The status of the request
  - `results_id` string, uuid, required: The unique identifier for the request
  - `message` string, required: A message describing the status of the request
  - `meta` object, nullable: Meta information about the request
  - `timestamp` string, date-time, required: The datetime of when the request was made
  - `status_detail` StatusDetail, nullable
    - `granular_status_code` string, nullable: Granular status code
    - `status_additional_info` string, nullable: Additional information about the status
  - `verifications` EntityVerificationResponsePayload
    - `entity_ownership_verified` boolean: Whether the entity ownership is verified
    - `verification_method` 'OPEN_FINANCE': The verification method used to verify the entity's ownership
    - `matching` MatchingResult, nullable: Where `iban_ownership_verified` is false the matching attribute will identify whether there is a 'partial' or 'no match'
      - `type` 'PARTIAL' | 'NO_MATCH': Identifies whether there is a partial match or no match
      - `score` number, double: Similarity score on a scale of 0 to 1, with 0 being no similarity and 1 being high similarity.

---

[API](https://skmtc.dev/leantech/apis/lean-api-beneficiary-name-verification.md) - [All operations](https://skmtc.dev/leantech/apis/lean-api-beneficiary-name-verification/llms.txt) - [OpenAPI document](https://skmtc.dev/leantech/apis/lean-api-beneficiary-name-verification/revisions/cdac326821f0?raw)