Manage applicants
Beta
Last updated: October 22, 2025
The Identities solutions require a profile for each physical person applying to use your services. You can then use this profile to manage the applicant's identity across Identity Verification, AML Screening, and Face Authentication.
Information
To enable Identities, contact your account manager or request support.
- You need a Checkout.com test account, with Identities enabled.
- Set up an authentication mechanism for your API requests, using OAuth 2.0 or API keys.
You create a profile for the applicant, which you can later retrieve or update.
You can also delete the applicant's personal data from the profile if necessary. For example, to comply with a GDPR request.
Call the Create an applicant endpoint.
Optionally, provide the following fields in the request body:
external_applicant_name– The applicant's nameexternal_applicant_id– Your identifier for the applicantemail– The applicant's email address
post
https://identity-verification.sandbox.checkout.com/applicants
1{2"external_applicant_name": "Hannah Bret",3"external_applicant_id": "ext_osdfdfdb4hryu5cei5vwoabrk5k",4"email": "[email protected]"5}
1{2"id": "aplt_tkoi5db4hryu5cei5vwoabr7we",3"created_on": "2025-07-21T17:32:28Z",4"modified_on": "2025-08-21T17:40:32Z",5"external_applicant_name": "Hannah Bret",6"external_applicant_id": "ext_osdfdfdb4hryu5cei5vwoabrk5k",7"email": "[email protected]",8"_links": {9"self": {10"href": "https://identity-verification.sandbox.checkout.com/applicants/aplt_tkoi5db4hryu5cei5vwoabr7we"11}12}13}
The response returns the applicant ID in the id field, prefixed with aplt_. You need this to create verifications, screenings, and authentications for the applicant.
Call the Get an applicant endpoint, and provide the applicant ID as the {applicant_id} path parameter.
get
https://identity-verification.sandbox.checkout.com/applicants/{applicant_id}
1{2"id": "aplt_tkoi5db4hryu5cei5vwoabr7we",3"created_on": "2025-07-21T17:32:28Z",4"modified_on": "2025-08-21T17:40:32Z",5"external_applicant_name": "Hannah Bret",6"external_applicant_id": "ext_osdfdfdb4hryu5cei5vwoabrk5k",7"email": "[email protected]",8"_links": {9"self": {10"href": "https://identity-verification.checkout.com/applicants/aplt_tkoi5db4hryu5cei5vwoabr7we"11}12}13}
Call the Update an applicant endpoint, and provide the applicant ID as the {applicant_id} path parameter.
patch
https://identity-verification.sandbox.checkout.com/applicants/{applicant_id}
1{2"id": "aplt_tkoi5db4hryu5cei5vwoabr7we",3"created_on": "2025-07-21T17:32:28Z",4"modified_on": "2025-08-21T17:40:32Z",5"external_applicant_name": "Hannah Bret",6"external_applicant_id": "ext_osdfdfdb4hryu5cei5vwoabrk5k",7"email": "[email protected]",8"_links": {9"self": {10"href": "https://identity-verification.checkout.com/applicants/aplt_tkoi5db4hryu5cei5vwoabr7we"11}12}13}
Call the Anonymize an applicant endpoint, and provide the applicant ID as the {applicant_id} path parameter.
post
https://identity-verification.sandbox.checkout.com/applicants/{applicant_id}/anonymize
1{2"id": "aplt_tkoi5db4hryu5cei5vwoabr7we",3"created_on": "2025-07-21T17:32:28Z",4"modified_on": "2025-08-21T17:40:32Z",5"external_applicant_id": "ext_osdfdfdb4hryu5cei5vwoabrk5k",6"_links": {7"self": {8"href": "https://identity-verification.checkout.com/applicants/aplt_tkoi5db4hryu5cei5vwoabr7we"9}10}11}