# Create an identification

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

Endpoint: POST /v1/persons/{person_id}/identifications
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):

  - `method` (string)
    The identification method to use for the person identification.
    Enum: "bank", "bank_id", "bank_plus", "fourthline", "idnow", "idnow_autoident", "idnow_custom", "manual", "postident"

  - `language` (string)
    (IDnow only) The customer's preferred language for the identification process.
    Enum: "DE", "EN"

  - `reference` (string)
    A reference supplied by the identification provider.

  - `proof_of_address_type` (string)
    The type of document submitted by the customer as a proof of address. This field is  if the customer's identification document does not include their address.
    Enum: "BANK_ACCOUNT_STATEMENT", "CERTIFICATE_OF_REGISTRATION", "ELECTRICITY_BILL", "GAS_BILL", "HEATING_BILL", "INTERNET_BILL", "TELEPHONE_BILL", "WATER_BILL"

  - `proof_of_address_issued_at` (string)
    The date when the proof of address document was issued. This field is  if the customer's identification document does not include their address.
    Example: "2021-12-03"

  - `iban` (string)
    The customer's IBAN. This field is mandatory if the identification method is  or . 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.
    Example: "Web;179ac83968ab42f79e960c1753a4078fdcon;jVl14emA+OcyALb9F+CMFg==;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"

  - `product_name` (string)
    (bank_plus only) 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.
    Enum: "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"

  - `account_type` (string)
    (bank_plus only) The type of account you want to open. Must correspond to the  and . Check the [account opening guide](https://docs.solarisgroup.com/guides/digital-banking/account-opening/#fields-mapping) for more information about this field.
    Enum: "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"

  - `account_purpose` (string)
    (bank_plus only) The purpose of the account. Use primary unless otherwise instructed.
    Example: "primary"

  - `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.
    Example: "SOBKDEB2XXX"

  - `account_currency` (string)
    (bank_plus only) The currency of the account.
    Enum: "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"

## Response 200 fields (application/json):

  - `id` (string)
    ID of the person identification.
    Example: "9dfe2f4edaa67138be0c0c1cd3a7d849cidt"

  - `reference` (string)
    Reference generated by the identification provider.
    Example: "TST-ELCCJ"

  - `url` (string)
    (IDnow only) Redirect URL used to start the identification process.
    Example: "https://go.test.idnow.de/company_id/identifications/identification_id"

  - `status` (string)
    The current status of the identification.  The status value depends on the identification method, check the [KYC guides](https://docs.solarisgroup.com/guides/kyc) for more information.
    Enum: "aborted", "authorization_required", "confirmation_required", "confirmed", "created", "canceled", "expired", "failed", "identification_data_required", "pending", "pending_successful", "pending_failed", "processed", "rejected", "successful", "signed"

  - `completed_at` (string)
    Date and time when the identification was completed.
    Example: "2021-09-14T18:18:28.000Z"

  - `method` (string)
    The method used for the identification.
    Enum: "bank", "bank_id", "bank_plus", "fourthline", "idnow", "idnow_autoident", "idnow_custom", "manual", "postident"

  - `proof_of_address_type` (string)
    The type of document submitted by the customer as a proof of address if their identification document did not include their address.
    Enum: "BANK_ACCOUNT_STATEMENT", "CERTIFICATE_OF_REGISTRATION", "ELECTRICITY_BILL", "GAS_BILL", "HEATING_BILL", "INTERNET_BILL", "TELEPHONE_BILL", "WATER_BILL"

  - `proof_of_address_issued_at` (string)
    The date when the proof of address document was issued.
    Example: "2021-12-03"

  - `language` (string)
    (IDnow only) The customer's preferred language for the identification process.
    Enum: "DE", "EN"

  - `person_id` (string)
    ID of the person for whom the identification was initiated.
    Example: "992de312a545bb24a88ddbf57ae8b1ffcper"

  - `address` (object)
    The customer's address.

  - `address.line_1` (string)
    Address line 1.
    Example: "BERLINER STR. 45"

  - `address.line_2` (string)
    Address line 2.
    Example: "Erste Etage"

  - `address.postal_code` (string)
    Customer's postal code.
    Example: "14169"

  - `address.city` (string)
    Customer's city.
    Example: "Berlin"

  - `address.country` (string)
    Customer's country.
    Example: "DE"

  - `address.state` (string)
    Customer's state.
    Example: "BE"

  - `documents` (array)
    Documents provided by the customer during the identification process.
    Example: [{"id":"448b75fa1c57eecda41d91c66c22faa6cdoc","name":"file1.pdf","content_type":"application/json","document_type":"KYC_REPORT","size":803580},{"id":"94eb22a9311be9a1fbb698c448b0b337cdoc","name":"file2.jpg","content_type":"image/jpeg","document_type":"SIGNATURE","size":25349}]

  - `documents.id` (string)
    ID of the document.

  - `documents.name` (string)
    The filename of the document.

  - `documents.content_type` (string)
    Formatting type of the document.

  - `documents.document_type` (string)
    The type of document submitted.
    Enum: "ID_DOCUMENT", "KYC_REPORT", "OTHER", "PICTURE", "SIGNATURE", "SIGNED_CONTRACT", "QES_DOCUMENT", "SIGNED_QES_DOCUMENT"

  - `documents.size` (integer)
    The file size (in bytes).

  - `failure_reason` (string,null)
    Additional context around why the identification failed. Value depends on the identification method.

  - `iban` (string)
    Optional IBAN provided for  and  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).
    Example: "DE11010101010101010100"

  - `authorization_expires_at` (string,null)
    The date and time by which the authorization for the end customer must be requested.

  - `confirmation_expires_at` (string,null)
    The date and time by which the customer must input the OTP sent to their mobile number for the QES process.

  - `provider_status_code` (integer,null)
    (Fourthline only) Status code returned by the identification provider.
    Enum: 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

  - `account_verification_error` (string,null)
    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.
    Enum: "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"

  - `idnow_process_type` (string)
    When method idnow is selected, the process type will reflect which idnow process was chosen.
    Example: "eid"