---
title: "Request an identification"
method: PATCH
path: "/v1/persons/{person_id}/identifications/{id}/request"
tags: ["Person identifications"]
---

# Request an identification

`PATCH /v1/persons/{person_id}/identifications/{id}/request`

This endpoint requests Solaris to begin the process for the person identification specified in the URL. The status of the identification will change to `pending`.  Once the identification process finishes, you will receive a notification from the `IDENTIFICATION` webhook and the status will change to `completed` or `failed` depending on the outcome.

## Path parameters

- `person_id` string, required — The unique ID of the person resource created for a customer.
- `id` string, required — The unique ID of the identification resource created for a customer.

## Request body

- object
  - `secret` string — Identification secret.
  - `device_data` string — Encoded device fingerprint generated using the [Seon SDK](https://seon.io). See the [device monitoring guide](https://docs.solarisgroup.com/guides/kyc/device-monitoring) for more information about generating this value.

## Response `200`

The operation was successful.

- SolarisServerDecoratorsIdentificationWithWaitingTime
  - `id` string — ID of the person identification.
  - `reference` string — Reference generated by the identification provider.
  - `url` string — (IDnow only) Redirect URL used to start the identification process.
  - `status` 'aborted' | 'authorization_required' | 'confirmation_required' | 'confirmed' | 'created' | 'canceled' | 'expired' | 'failed' | 'identification_data_required' | 'pending' | 'pending_successful' | 'pending_failed' | 'processed' | 'rejected' | 'successful' | 'signed' — The current status of the identification. **Note** The status value depends on the identification method, check the [KYC guides](https://docs.solarisgroup.com/guides/kyc) for more information.
  - `completed_at` string — Date and time when the identification was completed.
  - `method` 'bank' | 'bank_id' | 'bank_plus' | 'fourthline' | 'idnow' | 'idnow_autoident' | 'idnow_custom' | 'manual' | 'postident' — The method used for the identification.
  - `proof_of_address_type` 'BANK_ACCOUNT_STATEMENT' | 'CERTIFICATE_OF_REGISTRATION' | 'ELECTRICITY_BILL' | 'GAS_BILL' | 'HEATING_BILL' | 'INTERNET_BILL' | 'TELEPHONE_BILL' | 'WATER_BILL' — The type of document submitted by the customer as a proof of address if their identification document did not include their address.
  - `proof_of_address_issued_at` string — The date when the proof of address document was issued.
  - `iban` string — Optional IBAN provided for `bank` and `bank_id` identifications.
  - `authorization_expires_at` string, nullable — The date and time by which the authorization for the end customer must be requested.
  - `confirmation_expires_at` string, nullable — The date and time by which the customer must input the OTP sent to their mobile number for the QES process.
  - `terms_and_conditions_signed_at` string — The date and time when the customer signed the terms and conditions.

## Other responses

- `400` — IDnow error
- `403` — You are not authorized to perform this action.
- `404` — Model not found.
- `412` — There are more than 19 unsuccessful identification attempts for this customer.
- `422` — Client error.
- `500` — Internal server error.

---

[API](https://skmtc.net/solarisgroup/apis/customer-identification-kyc.md) · [All operations](https://skmtc.net/solarisgroup/apis/customer-identification-kyc/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/customer-identification-kyc/revisions/c481fa2414f9/schema)