---
title: "Create an identification session"
method: POST
path: "/v1/persons/{person_id}/identification_sessions"
tags: ["Identification sessions"]
---

# Create an identification session

`POST /v1/persons/{person_id}/identification_sessions`

-> "Creates an identification session for the person specified in the request URL based on the identification method(s) supplied in the request. Note that if the customer is not eligible for one of the identification methods, then this endpoint will return an error. Use the eligibility checking endpoint to verify this beforehand:" + `GET /v1/persons/{person_id}/identification_eligibility_checks`

## Path parameters

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

## Request body

- object
  - `callback_url` string — The callback URL to call when the identification session is completed.
  - `identification_methods` string[] — Identification methods to use to identify the customer.

## Response `201`

Successful result of the operation

- SolarisServerDecoratorsIdentificationSession
  - `id` string — ID of the identification session.
  - `url` string — The URL of the identification session.
  - `callback_url` string — The callback URL of the identification session.
  - `identification_methods` string[] — The allowed identification methods for the session.
  - `status` 'authorization_required' | 'confirmation_required' | 'confirmed' | 'created' | 'expired' | 'identification_data_required' | 'pending' | 'pending_successful' | 'rejected' | 'successful' — The current status of the identification session.

## Other responses

- `400` — An error occurred on the client side.
- `403` — You are not authorized to perform this action.
- `500` — Internal server error.
- `default` — Unexpected 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)