This guide dives into the most common HTTP error codes related to the verification endpoints of KYC API V2, offering insights into what they mean, why they occur, and how to effectively address them.
/verification/ein
Error code and message
Description
400ERR_EIN_INVALID_PARAM
Invalid parameter detected. Please check the documentation.
400ERR_EIN_VERIFICATION_BAD_REQUEST
Bad request for EIN verification.
500ERR_EIN_CHECK_SERVER_ERROR
An unexpected error appeared during request execution. Please retry the request or get in contact with Customer Support team if the error persists.
503ERR_EIN_VERIFICATION_PROVIDER_ERROR
The data provider, to which the enhanced order was forwarded, failed to respond correctly. Please try your request again.
/verification/iban
Error code and message
Description
400ERR_IBAN_INVALID_PARAM
Invalid parameter detected. Please check the documentation.
400ERR_IBAN_VERIFICATION_BAD_REQUEST
Bad request for IBAN verification.
401ERR_IBAN_VERIFICATION_UNAUTHORIZED
Unauthorized attempt at IBAN verification.
500ERR_IBAN_SERVER_ERROR
Server error during IBAN processing.
503ERR_IBAN_VERIFICATION_PROVIDER_ERROR
This IBAN does not exist.
/verification/isin
Error code and message
Description
400ERR_ISIN_VERIFICATION_BAD_REQUEST
Bad request for ISIN verification.
400ERR_ISIN_INVALID_PARAM
Invalid parameter detected. Please check the documentation.
500ERR_ISIN_SERVER_ERROR
Server error during ISIN processing.
503ERR_ISIN_VERIFICATION_PROVIDER_ERROR
The data provider, from which the dataset was queried, failed to respond correctly. Please try your request again.
/api/v2/verification/leiValidation
Error code and message
Description
400ERR_LEI_VERIFICATION_BAD_REQUEST
Bad request for LEI verification.
400ERR_LEI_INVALID_PARAM
Invalid parameter detected. Please check the documentation.
404ERR_LEI_VERIFICATION_NOT_FOUND
LEI verification not found.
/api/v2/verification/tin
Error code and message
Description
400ERR_TIN_VERIFICATION_BAD_REQUEST
Bad request for TIN verification.
400ERR_TIN_INVALID_PARAM
Invalid parameter detected. Please check the documentation.
429ERR_TIN_CHECK_PROVIDER_LIMITS_REACHED
We have reached our current limits with the provider. Please try again later!
500ERR_TIN_CHECK_SERVER_ERROR
An unexpected error appeared during request execution. Please retry the request or get in contact with Customer Support team if the error persists.
503ERR_TIN_CHECK_PROVIDER_ERROR
The data provider, to which the enhanced order was forwarded, failed to respond correctly. Please try your request again.
503IRS_TIN_MATCHING_UNVAVAILABLE
IRS Tin Matching Service temporarily unavailable
/verification/vat
Error code and message
Description
400ERR_VAT_INVALID_PARAM
Invalid parameter detected. Please check the documentation.
400ERR_VAT_VERIFICATION_BAD_REQUEST
Bad request for VAT verification.
400ERR_VAT_LOOKUP_INVALID_PARAMS
Either `name` or `number` should be provided in the request!
503ERR_VAT_PROVIDER_ERROR
The data provider, to which the request was forwarded, failed to respond correctly. Please try your request again.
