Skip to navigation

Submit Additional Details Nationality

View as Markdown

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

x-user-ipstringRequired

End user’s originating IP. More details here

x-api-keystringRequired
Partner API Key present in Transak Dashboard.
authorizationstringOptional

Transak Auth. The user’s accessToken from Transak’s OTP login, returned by the Verify User OTP API (/api/v2/auth/verify). Send the token on its own, with no Bearer prefix. It is valid for 30 days. Call the Refresh User Access Token API before it expires. Do not send x-access-token or x-user-identifier with it.

x-access-tokenstringOptional

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.

x-user-identifierstringOptional

Partner Auth (Auth Reliance). The email address of the user you authenticated. Send it with x-access-token.

Request

This endpoint expects an object.
employmentStatusstringRequired

The user’s employment status. Take the value from employmentStatusOptions in the ADDITIONAL_DETAILS_NATIONALITY form returned by the Get Additional Requirements API.

countryOfCitizenshipstringRequired

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

dataobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error