# Create an identification session

-> "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:" + 

Endpoint: POST /v1/persons/{person_id}/identification_sessions
Version: 1.0

## Path parameters:

  - `person_id` (string, required)
    The unique ID of the person resource created for a customer.
    Example: "dc1a6812a14f6cc338cd084208535bcdcper"

## Request fields (application/json):

  - `callback_url` (string)
    The callback URL to call when the identification session is completed.
    Example: "someurl.com"

  - `identification_methods` (array)
    Identification methods to use to identify the customer.
    Enum: "bank", "bank_id", "fourthline", "idnow"

## Response 201 fields (application/json):

  - `id` (string)
    ID of the identification session.
    Example: "acdede097f821bd8037465d691f69506ises"

  - `url` (string)
    The URL of the identification session.
    Example: "https://person-onboarding.solaris-staging.de/9AXlUH0ptsZoFef2n8LKiqpEAizdJTjVQ4tzZeu1LpvqbK201REXFG_EBwiGTw0PLlHWCaA7NLOOcUh1u_a7HUpp7wYMNlGnzALka-v_9MVOxOIfN73lFjFg7JMtBdJO"

  - `callback_url` (string)
    The callback URL of the identification session.
    Example: "https://www.callbackurl.com"

  - `identification_methods` (array)
    The allowed identification methods for the session.
    Enum: "bank", "bank_id", "fourthline", "idnow", "manual", "postident"

  - `status` (string)
    The current status of the identification session.
    Enum: "authorization_required", "confirmation_required", "confirmed", "created", "expired", "identification_data_required", "pending", "pending_successful", "rejected", "successful"

## Response 400 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "400"

  - `code` (string)
    Example: "build_pagination_headers_failure"

  - `title` (string)
    Example: "Failed to build pagination headers."

  - `detail` (string)
    Example: "Cannot connect to database."

## Response 403 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "403"

  - `code` (string)
    Example: "unauthorized_action"

  - `title` (string)
    Example: "Unauthorized Action"

  - `detail` (string)
    Example: "Unauthorized action is not allowed."

## Response 500 fields (application/json):

  - `id` (string)
    Example: "e8915041-9d8c-4d96-9dd1-04e8522ecdbf"

  - `status` (string)
    Example: "500"

  - `code` (string)
    Example: "generic_error"

  - `title` (string)
    Example: "Generic Error"

  - `detail` (string)
    Example: "There was an error."