Get TIN Country List

Endpoint Overview

GET /api/v1/tin/get-country-list

Description

The Get TIN Country List API provides a comprehensive list of countries that support Tax Identification Number (TIN) format verification. This endpoint serves as a prerequisite for TIN validation services, enabling developers to retrieve the complete list of supported countries before performing TIN format verification operations. The API returns an extensive list of over 100 countries, making it essential for applications that need to validate tax identification numbers across multiple international jurisdictions.

Key Benefits

Comprehensive Coverage: Access to 100+ countries supporting TIN verification

Real-time Data: Always up-to-date list of supported countries for TIN validation

Integration Prerequisite: Essential first step for implementing TIN verification workflows

Global Compliance: Supports international tax compliance and verification requirements

Use Cases

Financial Services

E-commerce & Business

Government & Compliance

International banking applications requiring customer TIN verification across multiple countries

Cross-border payment platforms validating tax identification for compliance purposes

Investment platforms conducting due diligence on international clients

Insurance companies verifying policyholder tax information globally

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.io

Production: https://kyc-api.surepass.io

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token for API authentication (JWT)
Content-Type	Yes	application/json

Request Body

This endpoint does not require any request body parameters as it simply returns the list of all supported countries.

Example Request

No request body required for this endpoint

Process Response

Response Parameters

Parameter	Type	Description
data	Array[String]	List of country names that support TIN verification
status_code	Integer	HTTP status code (200 for success)
message_code	String	Internal message code indicating operation result
message	String	Human-readable message describing the operation result
success	Boolean	Indicates whether the operation was successful

Example Successful Response

{
    "data": [
        "Albania",
        "Andorra",
        "Argentina",
        "Armenia",
        "Aruba",
        "Australia",
        "Austria",
        "Azerbaijan",
        "Bangladesh",
        "Bulgaria",
        "Canada",
        "Chile",
        "China",
        "Colombia",
        "Costa Rica",
        "Croatia",
        "Cuba",
        "Curacao",
        "Cyprus",
        "Czech Republic",
        "Denmark",
        "Dominican Rep",
        "Ecuador",
        "Egypt",
        "El Salvador",
        "Estonia",
        "Faroe Islands",
        "Greece",
        "Greenland",
        "Guatemala",
        "Guernsey",
        "Hong Kong",
        "Hungary",
        "Iceland",
        "India",
        "Indonesia",
        "Jamaica",
        "Japan",
        "Jersey",
        "Kazakhstan",
        "Kenya",
        "Kuwait",
        "Kyrgyzstan",
        "Latvia",
        "Liechtenstein",
        "Lithuania",
        "Luxembourg",
        "Macedonia",
        "Morocco",
        "Netherlands",
        "New Zealand",
        "Nicaragua",
        "Nigeria",
        "Northern Ireland",
        "Norway",
        "Pakistan",
        "Panama",
        "Paraguay",
        "Peru",
        "Philippines",
        "Poland",
        "Portugal",
        "Romania",
        "Russia",
        "Samoa",
        "South Korea",
        "Spain",
        "Sri Lanka",
        "St. Vincent and the Grenadines",
        "Sweden",
        "Switzerland",
        "Taiwan",
        "Tajikistan",
        "Thailand",
        "Trinidad",
        "Tunisia",
        "Turkey",
        "Turkmenistan",
        "United States",
        "Uruguay",
        "Uzbekistan",
        "Vanuatu",
        "Venezuela",
        "Vietnam"
    ],
    "status_code": 200,
    "message_code": "success",
    "message": "Success",
    "success": true
}

Possible Error Responses

Invalid Credentials

Server Error

{
    "error": null,
    "message": "Your token is invalid. Please ensure that correct token is being used.",
    "status_code": 401,
    "success": false,
    "message_code": "invalid_token"
}

Occurs when the JWT Bearer token is missing, invalid, or expired.

Integration Best Practices

Security Recommendations

Store JWT tokens securely and implement proper token refresh mechanisms

Use HTTPS for all API communications to ensure data encryption in transit

Implement rate limiting on your application side to avoid overwhelming the API

Validate the response structure before processing to handle any schema changes gracefully

User Experience Guidelines

Cache the country list locally to reduce API calls and improve application performance

Implement search functionality to help users quickly find specific countries

Sort countries alphabetically or by relevance to improve user navigation

Provide clear error messages when country selection is required for TIN verification

Code Samples

cURL

Python

Node.js

Related APIs

TIN Format Verification API: Uses country names from this list to validate TIN formats for specific countries

TIN Validation API: Performs comprehensive TIN verification using country-specific validation rules

Country Code Mapping API: Provides additional country metadata and ISO code mappings for international operations

Compliance and Legal Considerations

This API provides country information for TIN verification purposes only. Ensure compliance with local data protection regulations (GDPR, CCPA, etc.) when processing tax identification numbers. The country list may be updated periodically to reflect changes in international tax compliance requirements. Always verify that your use case aligns with applicable tax laws and regulations in the jurisdictions where you operate.

{ "data": [ "Albania", "Andorra", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bangladesh", "Bulgaria", "Canada", "Chile", "China", "Colombia", "Costa Rica", "Croatia", "Cuba", "Curacao", "Cyprus", "Czech Republic", "Denmark", "Dominican Rep", "Ecuador", "Egypt", "El Salvador", "Estonia", "Faroe Islands", "Greece", "Greenland", "Guatemala", "Guernsey", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Jamaica", "Japan", "Jersey", "Kazakhstan", "Kenya", "Kuwait", "Kyrgyzstan", "Latvia", "Liechtenstein", "Lithuania", "Luxembourg", "Macedonia", "Morocco", "Netherlands", "New Zealand", "Nicaragua", "Nigeria", "Northern Ireland", "Norway", "Pakistan", "Panama", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Romania", "Russia", "Samoa", "South Korea", "Spain", "Sri Lanka", "St. Vincent and the Grenadines", "Sweden", "Switzerland", "Taiwan", "Tajikistan", "Thailand", "Trinidad", "Tunisia", "Turkey", "Turkmenistan", "United States", "Uruguay", "Uzbekistan", "Vanuatu", "Venezuela", "Vietnam" ], "status_code": 200, "message_code": "success", "message": "Success", "success": true }

Get Country List

Get TIN Country List#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses