Adds a consent on processing personal applicant data to the specified applicant profile.
Overview
Use this method to add a consent on processing personal applicant data to the specified applicant profile.
A standard use of this method is when you are practising exclusively the API integration, so you can submit a consent the applicant has agreed to via the API.
The method can also be beneficial, for example, if your applicant has already given all the necessary consents, and you no longer need the consent text to be displayed in the SDKs for this applicant.
Request example
curl --request POST \
--url https://api.sumsub.com/resources/applicants/656a2722ea802f0f724e00e7/agreement \
--header 'content-type: application/json'
--data '{
"records": [
{
"content": "some_consent_content"
},
{
"content": "some_agreement_content"
}
],
"acceptedAt": "2022-01-01 01:01:01",
"residenceCountry": "USA"
}'
Response explained
Upon successful execution, the response will have a status code of 200
and include the applicant information in the JSON format, as described in Get applicant data.
Mind the agreement
field to see the details of the consent acceptance. Each recordId
corresponds to an individual consent provided in the request.
Response example
{
"id": "654a2724ea803f0f724e00e7",
"createdAt": "2023-11-07 12:01:40",
"key": "EJBDYWTFWAQXSH",
"clientId": "my_key_name",
"inspectionId": "654a2734ea802f0f724e00e8",
"externalUserId": "myapp",
"fixedInfo": {
"firstName": "John",
"firstNameEn": "John",
"middleName": "Timothy",
"middleNameEn": "Timothy",
"lastName": "Doe",
"lastNameEn": "Doe",
"residenceCountry": "USA"
},
"applicantPlatform": "API",
"agreement": {
"createdAt": "2024-03-25 06:56:47",
"acceptedAt": "2024-03-25 06:56:47",
"source": "API",
"recordIds": [
"6401202f39c56ebefd4497b9"
]
},
"requiredIdDocs": {
"videoIdent": true,
"videoIdentUploadTypes": [
"ID_CARD",
"PASSPORT"
],
"docSets": [
{
"idDocSetType": "IDENTITY",
"types": [
"ID_CARD",
"PASSPORT",
"RESIDENCE_PERMIT",
"DRIVERS"
],
"subTypes": [
"FRONT_SIDE",
"BACK_SIDE"
],
"videoRequired": "disabled",
"captureMode": "manualAndAuto",
"uploaderMode": "always"
},
{
"idDocSetType": "IDENTITY2",
"types": [
"VISA"
]
}
]
},
"review": {
"reviewId": "zUUXB",
"attemptId": "OpBfU",
"attemptCnt": 0,
"levelName": "basic-kyc-level",
"createDate": "2023-11-07 12:01:40+0000",
"reviewStatus": "init",
"priority": 0
},
"type": "individual"
}