# Person identifications

## (Bankident only) Check identification eligibility

 - [POST /v1/persons/{person_id}/identification_eligibility_checks](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identification_eligibility_checks/post.md): Validates whether the person specified in the request URL is eligible to complete a given identification method.

## Create an identification

 - [POST /v1/persons/{person_id}/identifications](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications/post.md): 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.

## Index identifications for a person

 - [GET /v1/persons/{person_id}/identifications](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications/get.md): Returns all identifications for the person specified in the request URL.

## List supported documents for a person identification

 - [GET /v1/persons/{person_id}/identifications/{id}/supported_documents](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1supported_documents/get.md): Returns an array of document types that a customer may use to identify themselves along with a list of allowed issuing countries. The  are provided as ISO country codes (ISO-3166-1 alpha 2). If the customer does not provide a supported document type in the identification process, then their identification will eventually fail.

## List supported documents from Fourthline for a person identification

 - [GET /v1/persons/{person_id}/identifications/{id}/supported_documents_from_fourthline](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1supported_documents_from_fourthline/get.md): Returns an array of document types as returned from Fourthline that a customer may use to identify themselves along with a list of allowed issuing countries. The  is provided as ISO country code (ISO-3166-1 alpha 2). If the customer does not provide a supported document type in the identification process, then their identification will eventually fail.

## Request an identification

 - [PATCH /v1/persons/{person_id}/identifications/{id}/request](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1request/patch.md): This endpoint requests Solaris to begin the process for the person identification specified in the URL. The status of the identification will change to .  Once the identification process finishes, you will receive a notification from the  webhook and the status will change to  or  depending on the outcome.

## Retrieve a person identification

 - [GET /v1/persons/{person_id}/identifications/{id}](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D/get.md): Returns a completed person identification (i.e., the person identification process was successful). If you use the  filter, this method will also return the documents submitted by the customer during the identification process. 

## Index all person identifications

 - [GET /v1/identifications](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1identifications/get.md): Returns all identifications for all of your customers.

## Start e-signing authorization process

 - [PATCH /v1/persons/{person_id}/identifications/{id}/authorize](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1authorize/patch.md): This method begins the authorization process for a person identification via BankIdent. When called, it triggers a Swisscom iframe and it also prompts Swisscom to send an SMS OTP to the customer. Call this endpoint when an identification reaches the  status.

## Confirm QES e-signing

 - [PATCH /v1/persons/{person_id}/identifications/{id}/confirm](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1confirm/patch.md): Use this endpoint to send the SMS OTP from the customer to Swisscom to confirm the e-signing for a person identification via BankIdent. Call this endpoint when the person identification reaches the status .

## (Bankident only) Index person bank identification attempts

 - [GET /v1/persons/{person_id}/bank_identification_attempts](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1bank_identification_attempts/get.md): Returns all bank identifications attempts for the person specified in the request URL.

## (IDnow only) List the IDnow attempts of a person identification

 - [GET /v1/persons/{person_id}/identifications/{id}/idnow_attempts](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1idnow_attempts/get.md): Returns a list of IDnow attempts within a person identification. Each returned attempt includes the result, the reason (if the attempt was aborted), and the payload from the webhook related to that attempt.

## (IDnow only) Get legitimation data

 - [GET /v1/persons/{person_id}/identifications/{id}/legitimation_data](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1legitimation_data/get.md): Returns information about the document that was used for legitimating an identification (e.g., passport, national ID).

## Update legitimation data

 - [PATCH /v1/persons/{person_id}/identifications/{id}/legitimation_data](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1legitimation_data/patch.md): Update the legitimation data of an identification

## (Fourthline only) Upload .zip file with required identification documents

 - [POST /v1/persons/{person_id}/identifications/{id}/zip](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1zip/post.md): Uploads a .zip file to the person identification specified in the request URL (if the identification method requires it). The identification must have already been requested. This method is only relevant for identifications using 

## (PostIdent only) Retrieve PostIdent identification PDF

 - [GET /v1/persons/{person_id}/identifications/{id}/pdf](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1pdf/get.md): Returns the PDF file generated from a PostIdent identification. The identification must have already been requested.

## (AutoIdent only) Create identification that allows for a mobile number change

 - [POST /v1/persons/{person_id}/identifications/for_mobile_change](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1for_mobile_change/post.md): This endpoint creates a new identification for the customer specified in the request URL and returns the . Use this endpoint if the customer has lost access to their existing mobile phone number.  After calling this endpoint, supply the returned  in the URL of the  method.

## (Manual KYC) Set identification to successful

 - [PATCH /v1/persons/{person_id}/identifications/{id}/mark_as_successful](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1mark_as_successful/patch.md): This endpoint sets the  of an identification to . Use this endpoint if you are implementing the manual KYC flow in your solution.

## Set identification to failed

 - [PATCH /v1/persons/{person_id}/identifications/{id}/mark_as_failed](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1mark_as_failed/patch.md): This endpoint sets the  of an identification to . Use this endpoint if the identification is still is in pending status and you want to fail it with a reason.

## (IDnow only) Request person identification with robot testing

 - [PATCH /v1/persons/{person_id}/identifications/{id}/request_with_robot](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1request_with_robot/patch.md): This endpoint requests an identification for the person specified in the URL. You can pass a custom value to the testing robot using the parameter .

## Retrieve person identification account snapshot

 - [GET /v1/persons/{person_id}/identifications/{id}/account_snapshot](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1account_snapshot/get.md): Returns an account snapshot that was added to a person identification.

## (Fourthline only) Whitelist a person identification

 - [POST /v1/persons/{person_id}/identifications/{id}/whitelist](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1whitelist/post.md): This endpoint whitelists a person identification to enable the customer with the  specified in the request URL to identify again for one of your services using Fourthline.  You can only use this endpoint if a person has been previously identified successfully for one of your services using Fourthline and there's a need to identify again. However, you cannot use this endpoint to whitelist a failed identification.

## (Sandbox only) Update Fourthline identification status

 - [POST /v1/persons/{person_id}/identifications/{id}/identify_with_status](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1identify_with_status/post.md): Testing endpoint that updates the status of a Fourthline identification. See the Fourthline guide for a full list of test values.

## (Sandbox only) Assign outcome of a Fourthline identification

 - [POST /v1/persons/{person_id}/identifications/{id}/register_verification_outcome](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1register_verification_outcome/post.md): Testing endpoint to set the outcome of a Fourthline identification once it reaches a specified status. This endpoint forwards the received payload to Fourthline's "Register a Verification Outcome" endpoint. For a full description and specification of the request parameters see Fourthline's online documentation.

## (BankPlus only) Retrieve the identification account for a person identification

 - [GET /v1/persons/{person_id}/identifications/{id}/identification/identification_account](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1identification~1identification_account/get.md): Returns the account details for a bank_plus identification.

## (Sanbox only) Simulate outcome for BankPlusIdent

 - [PATCH /v1/persons/{person_id}/identifications/{id}/simulate_outcome](https://docs.solarisgroup.com/api-reference/identity/identifications/person-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1identifications~1%7Bid%7D~1simulate_outcome/patch.md): This endpoint allows you to easily test different scenarios while integrating BankPlusIdent, such as pre_successful, failed, aborted, or canceled statuses. It requires the identification to be in a pending/aborted/canceled status to simulate the desired scenario.