---
title: "Submit Identification Payload"
method: POST
path: "/persons/{person_id}/identifications/{identification_id}/submit"
tags: ["Accounts: ID+V"]
---

# Submit Identification Payload

`POST /persons/{person_id}/identifications/{identification_id}/submit`

## Request

- Base URL: `https://sandbox.api.lemon.markets/v1`
- URL: `https://sandbox.api.lemon.markets/v1/persons/{person_id}/identifications/{identification_id}/submit`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/docs/persons/:person_id/identifications/:identification_id/submit/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `identification_id` string, required
- `person_id` string, required

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Request body

- SubmitKycRelianceDataRequest: An object describing a previously completed ID+V process for a person in the context of KYC reliance.
  - `reference` string, required: A reference to the ID+V process previously completed. The string must neither be empty and nor contain only whitespace characters.
  - `completed_at` string, date-time, required: The point in time at which the ID+V process referenced by `reference` has been completed.
  - `id_document` IdentificationDocument, required: An object representing a government issued identity document.
    - `type` 'id_card' | 'passport', required: A category representing a givernment issued identification document. <ul> <li><code>id_card</code> <li><code>passport</code> </ul>
    - `number` string, required: The number used to identify the document, such as the passport number. The string must neither be empty and nor contain only whitespace characters.
    - `expiry_date` string, date, required: The expiry date as indicated on the document. **Note:** For some documents this may be the last day being valid, for others this may indicate the first day of being expired.
    - `issuing_country` string, required: The ISO 3166-1 alpha-2 code representing the issuing government.
  - `politically_exposed_person` boolean: Indicate whether or not the person was identified as a politically exposed person (PEP).

## Response `200`

Successful Response

- IdentificationResponse: An object representing a process for person identification.
  - `id` string, required: The identifier referring to this person identification process.
  - `person` PersonResponse, required: An object representing a person to be verified.
    - `id` string, required: The identifier representing this person.
    - `type` 'customer', required: A category representing the relationship of a person to an account. <ul> <li><code>customer</code> </ul>
  - `method` 'kyc_reliance', required: A category representing the identification method used. <ul> <li><code>kyc_reliance</code>: Use this for KYC reliance implementations. </ul>
  - `status` 'created' | 'failed' | 'started' | 'succeeded', required: A category representing the status on a person identification process. <ul> <li><code>created</code> <li><code>failed</code> <li><code>started</code> <li><code>succeeded</code> </ul>
  - `history` StatusChangePersonIdentificationStatus[]: A history of the status changes for the person identification process.
    - `status` 'created' | 'failed' | 'started' | 'succeeded', required: A category representing the status on a person identification process. <ul> <li><code>created</code> <li><code>failed</code> <li><code>started</code> <li><code>succeeded</code> </ul>
    - `timestamp` string, date-time, required: The timestamp of the event. It represents the point in time at which the onboarding status was updated.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `422`: Unprocessable Entity
- `5XX`: Server Error

---

[API](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api.md) - [All operations](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/revisions/1f1df208c0e4?raw)