---
title: "Create an identification"
method: POST
path: "/v1/persons/{person_id}/identifications"
tags: ["Person identifications"]
---

# Create an identification

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

Creates an identification for the person specified in the request URL. Note that this endpoint does **not** send a request to the identification provider to start the identification process.

## Path parameters

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

## Request body

- SolarisRequestParamsIdentification
  - `method` 'bank' | 'bank_id' | 'bank_plus' | 'fourthline' | 'idnow' | 'idnow_autoident' | 'idnow_custom' | 'manual' | 'postident' — The identification method to use for the person identification.
  - `language` 'DE' | 'EN' — (IDnow only) The customer's preferred language for the identification process.
  - `reference` string — A reference supplied by the identification provider.
  - `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. This field is **mandatory** if the customer's identification document does not include their address.
  - `proof_of_address_issued_at` string, date — The date when the proof of address document was issued. This field is **mandatory** if the customer's identification document does not include their address.
  - `iban` string — The customer's IBAN. This field is mandatory if the identification method is `bank` or `bank_id`. Please note that Solaris only accepts certain banks for the Bankident KYC flow. See the full list [here](https://docs.solarisgroup.com/guides/kyc/bankident/#allowed-banks).
  - `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.
  - `product_name` 'CURRENT_ACCOUNT_BUSINESS_FRANCE' | 'CURRENT_ACCOUNT_BUSINESS_GERMANY' | 'CURRENT_ACCOUNT_BUSINESS_ITALY' | 'CURRENT_ACCOUNT_BUSINESS_SPAIN' | 'CURRENT_ACCOUNT_CONSUMER_FRANCE' | 'CURRENT_ACCOUNT_CONSUMER_GERMANY' | 'CURRENT_ACCOUNT_CONSUMER_ITALY' | 'CURRENT_ACCOUNT_CONSUMER_SPAIN' | 'CURRENT_ACCOUNT_FREELANCER_FRANCE' | 'CURRENT_ACCOUNT_FREELANCER_GERMANY' | 'CURRENT_ACCOUNT_FREELANCER_ITALY' | 'CURRENT_ACCOUNT_FREELANCER_SPAIN' | 'CUSTOMER_CARD_SETTLEMENT' | 'DECOUPLED_CARD_CONSUMER_GERMANY' | 'EMONEY_ACCOUNT_BUSINESS_GERMANY' | 'EMONEY_ACCOUNT_CONSUMER_GERMANY' | 'EMONEY_ACCOUNT_FREELANCER_GERMANY' | 'RESTRICTED_ACCOUNT_BUSINESS_GERMANY' | 'RESTRICTED_ACCOUNT_CONSUMER_GERMANY' | 'RESTRICTED_ACCOUNT_CONSUMER_ITALY' | 'SAVINGS_ACCOUNT_CONSUMER_FRANCE' | 'SAVINGS_ACCOUNT_BUSINESS_FRANCE' | 'SAVINGS_ACCOUNT_FREELANCER_FRANCE' | 'SAVINGS_ACCOUNT_CONSUMER_GERMANY' | 'SAVINGS_ACCOUNT_BUSINESS_GERMANY' | 'SAVINGS_ACCOUNT_FREELANCER_GERMANY' | 'SAVINGS_ACCOUNT_CONSUMER_ITALY' | 'SAVINGS_ACCOUNT_BUSINESS_ITALY' | 'SAVINGS_ACCOUNT_FREELANCER_ITALY' | 'SAVINGS_ACCOUNT_CONSUMER_SPAIN' | 'SAVINGS_ACCOUNT_BUSINESS_SPAIN' | 'SAVINGS_ACCOUNT_FREELANCER_SPAIN' | 'SAVINGS_ACCOUNT_EXTERNAL_REFERENCE_CONSUMER_GERMANY' | 'SOFT_CURRENCY_ACCOUNT' | 'SUBACCOUNT_CONSUMER_FRANCE' | 'SUBACCOUNT_CONSUMER_GERMANY' | 'SUBACCOUNT_CONSUMER_ITALY' | 'SUBACCOUNT_CONSUMER_SPAIN' | 'SUBACCOUNT_BUSINESS_FRANCE' | 'SUBACCOUNT_BUSINESS_GERMANY' | 'SUBACCOUNT_BUSINESS_ITALY' | 'SUBACCOUNT_BUSINESS_SPAIN' | 'SUBACCOUNT_FREELANCER_FRANCE' | 'SUBACCOUNT_FREELANCER_GERMANY' | 'SUBACCOUNT_FREELANCER_ITALY' | 'SUBACCOUNT_FREELANCER_SPAIN' — The product name for which you want to open an account. Check the [account opening guide](https://docs.solarisgroup.com/guides/digital-banking/account-opening/#fields-mapping) for more information about this field.
  - `account_type` 'CALL_MONEY' | 'CARD_SETTLEMENT_PARTNER' | 'CHECKING_BUSINESS' | 'CHECKING_PERSONAL' | 'CHECKING_PERSONAL_OVERDRAFT' | 'CHECKING_SOLE_PROPRIETOR' | 'CHECKING_SUBACCOUNT' | 'CUSTOMER_CURRENCY_ACCOUNT' | 'DECOUPLED_CARD_BUSINESS' | 'DECOUPLED_CARD_PERSONAL' | 'EMONEY_PARKING' | 'EMONEY_PREPAID' | 'SAVINGS_BUSINESS' | 'SAVINGS_PERSONAL' | 'SAVINGS_PERSONAL_EXTERNAL_REFERENCE' | 'SAVINGS_SOLE_PROPRIETOR' | 'WALLET_BUSINESS' | 'WALLET_INSTITUTIONAL' | 'WALLET_LIQUIDITY_PROVIDER' | 'WALLET_PERSONAL' | 'WALLET_PERSONAL_PAYMENT_ACC' — The type of account you want to open. Must correspond to the `product_name` and `customer_type`. Check the [account opening guide](https://docs.solarisgroup.com/guides/digital-banking/account-opening/#fields-mapping) for more information about this field.
  - `account_purpose` string — (bank_plus only) The purpose of the account. Use primary unless otherwise instructed.
  - `account_bic` string — (bank_plus only) The BIC to apply to the account. Choose the BIC that corresponds with the branch in which you want to open the account.
  - `account_currency` 'CAD' | 'CHF' | 'CNY' | 'DKK' | 'EUR' | 'GBP' | 'HKD' | 'JPY' | 'NOK' | 'SEK' | 'SGD' | 'USD' | 'AED' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BMD' | 'BND' | 'BOB' | 'BRL' | 'BTN' | 'BZD' | 'CLP' | 'COP' | 'CRC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DOP' | 'DZD' | 'ETB' | 'FJD' | 'GEL' | 'GTQ' | 'GYD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'JMD' | 'JOD' | 'KES' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LKR' | 'LRD' | 'LSL' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MOP' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NPR' | 'NZD' | 'OMR' | 'PEN' | 'PGK' | 'PHP' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SCR' | 'SLL' | 'SRD' | 'STN' | 'SVC' | 'SZL' | 'THB' | 'TJS' | 'TRY' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'UYU' | 'UZS' | 'VND' | 'XPF' | 'ZAR' | 'ZMW' | 'EMONEY_EUR' — (bank_plus only) The currency of the account.

## Response `200`

Successful result of the operation

- SolarisServerDecoratorsIdentification
  - `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_account_creation' | 'pending_successful' | 'pending_failed' | 'pending_ref_transfer' | 'pre_successful' | '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.
  - `language` 'DE' | 'EN' — (IDnow only) The customer's preferred language for the identification process.
  - `person_id` string — ID of the person for whom the identification was initiated.
  - `address` object — The customer's address.
    - `line_1` string — Address line 1.
    - `line_2` string — Address line 2.
    - `postal_code` string — Customer's postal code.
    - `city` string — Customer's city.
    - `country` string — Customer's country.
    - `state` string — Customer's state.
  - `documents` object[] — Documents provided by the customer during the identification process.
    - `id` string — ID of the document.
    - `name` string — The filename of the document.
    - `content_type` string — Formatting type of the document.
    - `document_type` 'ID_DOCUMENT' | 'KYC_REPORT' | 'OTHER' | 'PICTURE' | 'SIGNATURE' | 'SIGNED_CONTRACT' | 'QES_DOCUMENT' | 'SIGNED_QES_DOCUMENT' — The type of document submitted.
    - `size` integer — The file size (in bytes).
  - `failure_reason` string, nullable — Additional context around why the identification failed. Value depends on the identification method.
  - `iban` string — Optional IBAN provided for `bank` and `bank_id` identifications. Please note that Solaris only accepts certain banks for the Bankident KYC flow. See the full list [here](https://docs.solarisgroup.com/guides/kyc/bankident/#allowed-banks).
  - `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.
  - `provider_status_code` 1000 | 1001 | 1002 | 1003 | 1004 | 1005 | 1006 | 1007 | 1008 | 1009 | 1010 | 1011 | 1012 | 1013 | 1014 | 1015 | 1016 | 1017 | 1018 | 1019 | 1020 | 1021 | 1022 | 1023 | 1024 | 1030 | 1031 | 1032 | 1033 | 1034 | 1035 | 1036 | 1037 | 1038 | 1100 | 2001 | 2002 | 2003 | 3001 | 3002 | 3003 | 3004 | 3005 | 3100 | 3101 | 3102 | 3103 | 3104 | 3105 | 3106 | 3107 | 3200 | 3201 | 3202 | 3203 | 3204 | 3205 | 3206 | 3207 | 3208 | 3209 | 3210 | 3211 | 3250 | 3300 | 3304 | 3305 | 3306 | 3307 | 3308 | 3400 | 3401 | 3402 | 3403 | 3404 | 3405 | 3406 | 3407 | 3408 | 3500 | 3510 | 3520 | 3540 | 3600 | 3601 | 3602 | 3603 | 3610 | 3620, nullable — (Fourthline only) Status code returned by the identification provider.
  - `account_verification_error` 'accounts_failed' | 'client_aborted' | 'init_failed' | 'login_failed' | 'login_next_failed' | 'max_login_tries' | 'max_tan_tries' | 'no_compatible_accounts' | 'pinned_iban_not_found' | 'security_setting_rejection' | 'session_expired' | 'tech_error' | 'transaction_failed' | 'turnovers_failed' | 'validation_failed', nullable — Session Error returned by Tink in the account verification process. Will only be populated when failure_reason is account_snaphot_failed or account_snapshot_expired. Only present for identifications within identification session.
  - `idnow_process_type` string — When method idnow is selected, the process type will reflect which idnow process was chosen.

## Other responses

- `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)