Submit Additional Details Nationality
Submit Additional Details Nationality is an authenticated API call that submits an EEA user’s employment status and nationality as part of the KYC verification process.
Call it when the Get Additional Requirements API returns the ADDITIONAL_DETAILS_NATIONALITY form. Use the options returned in that form’s metadata. See MiCA Changes for EEA Users.
Authentication: use either Transak Auth, which sends the user’s authorization token, or Partner Auth (Auth Reliance), which sends x-access-token and x-user-identifier. Do not send both. See the headers below.
Headers
End user’s originating IP. More details here
Partner Auth (Auth Reliance). Your Partner Access Token, valid for 7 days. Send it with x-user-identifier, and do not send authorization. See Auth Reliance Flows and how to create a Partner Access Token.
Partner Auth (Auth Reliance). The email address of the user you authenticated. Send it with x-access-token.
Request
The user’s employment status. Take the value from employmentStatusOptions in the ADDITIONAL_DETAILS_NATIONALITY form returned by the Get Additional Requirements API.
The user’s nationality as declared by the user, as an ISO 3166-1 alpha-2 code. Take the value from countryOfCitizenshipOptions in the ADDITIONAL_DETAILS_NATIONALITY form returned by the Get Additional Requirements API.
Response
200 - Success