Feel free to reach techsupport@surepass.io for any technical support or guidance.
Country List
Developing
Production
https://kyc-api.surepass.app
Production
https://kyc-api.surepass.app
GET
https://kyc-api.surepass.app
Description
Key Benefits
Use Cases
Travel & Immigration
Banking & Fintech
Education & EdTech
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 Different authentication tokens are used for sandbox and production environments: Sandbox: Production:
1.
2.
3.
Authorization header as Bearer TOKEN.https://sandbox.surepass.iohttps://kyc-api.surepass.ioRequest Parameters
Request Headers
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer token obtained via JWT |
Request Body
Example Request
Process Response
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| data.country | array of strings | List of supported countries (snake_case format) |
| status_code | integer | HTTP status code (e.g. 200) |
| message_code | string | Success or error code |
| message | string | Human-readable status message |
| success | boolean | Indicates success of the API call |
Example Successful Response
{
"data": {
"country": [
"afghanistan",
"aland_islands",
"albania",
"algeria",
"amirican_samoa",
...
]
},
"status_code": 200,
"message_code": "success",
"message": "Success",
"success": true
}Possible Error Responses
Invalid Token
Internal Server Error
{
"status_code": 401,
"message_code": "unauthorized",
"message": "Invalid or expired token",
"success": false
}Integration Best Practices
Security Recommendations
User Experience Guidelines
Code Samples
cURL
Python
Node.js
Related APIs
Compliance and Legal Considerations
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://kyc-api.surepass.app/api/v1/global/qa/visa-verification/country-list'Response Response Example
{
"data": {
"country": [
"afghanistan",
"aland_islands",
"albania",
"algeria",
"amirican_samoa",
"andorra",
"angola",
"anguilla",
"antigua_and_barbuda",
"argentina",
"armenia",
"aruba",
"australia",
"austria",
"azerbaijan",
"belarus",
"bahamas",
"bahrain",
"bangladesh",
"barbados",
"belgium",
"belize",
"benin",
"bermuda",
"bhutan",
"bolivia",
"bosnia_herzegovina",
"botswana",
"bouvet_island",
"brazil",
"british_indian_ocean",
"british_virgin_islnd",
"brunei_darussalam",
"bulgaria",
"burkina_faso",
"burundi",
"congo",
"curacao",
"cambodia",
"cameroon",
"canada",
"cape_verde",
"caymen_islands",
"central_african",
"chad",
"channel_ialsnd",
"chile",
"china",
"chrisimas_island",
"cocos_keeling_island",
"colombia",
"comoros",
"cook_island",
"costa_rica",
"cote_divoire",
"croatia",
"cuba",
"cyprus",
"czecho",
"democratic_congo",
"denmark",
"djibouti",
"dominica",
"dominican_republic",
"ecuador",
"egypt",
"el_salvador",
"equatorial_guinea",
"eritrea",
"estonia",
"ethiopia",
"faeroe_islands",
"falkland_islands",
"fiji",
"finland",
"france",
"french_guiana",
"french_polynesia",
"guinea_bissau",
"gabon",
"gambia",
"georgia",
"germany",
"ghana",
"gibrltar",
"greece",
"greenland",
"grenada",
"guadeloupe",
"guader",
"guam",
"guatemala",
"guernesey",
"guinea",
"guyana",
"haiti",
"heard_and_mc_donald",
"honduras",
"hungary",
"iceland",
"india",
"indonesia",
"interpol",
"iran",
"iraq",
"ireland",
"isle_of_man",
"israel",
"italy",
"jamaica",
"japan",
"jersey",
"johnston",
"jordan",
"kazakhstan",
"kenya",
"kiribati",
"korea_st",
"kuwait",
"kyrgyzstan",
"lao",
"latvia",
"lebanon",
"lesotho",
"liberia",
"libya",
"liechtenstein",
"lithuania",
"luxembourg",
"mauritania",
"madagascar",
"malawi",
"malaysia",
"maldives",
"mali",
"malta",
"marshall_islands",
"martinique",
"mauritius",
"mayotte",
"mexico",
"micronesia",
"midway",
"moldova",
"monaco",
"mongolia",
"montenegro",
"montserrat",
"morocco",
"mozambique",
"myanmar",
"namibia",
"nauru",
"nepal",
"netherlands",
"netherlands_antilles",
"new_caledonia",
"new_zealand",
"nicargua",
"niger",
"nigeria",
"niue",
"norfolk_island",
"north_korea",
"northen_cyprus",
"northern_mariana_isl",
"norway",
"oman",
"pacfc_il",
"pakistan",
"palau",
"palestin",
"panama",
"papua_ng",
"paraguay",
"peru",
"philippines",
"pitcairn",
"poland",
"portugal",
"puerto_rico",
"qatar",
"r__north_macedonia",
"r_o_c_hong_kong",
"r_o_c_macao",
"r_o_c_taiwan",
"republic_of_turkiye",
"republic_of_kosovo",
"reunion",
"romania",
"russia",
"rwanda",
"st_chris",
"saint_barthelemy",
"saint_helena",
"st_kitts_nevis",
"saint_lucia",
"sait_martin",
"samoa",
"san_marino",
"sao_tome_and_principe",
"saudi_arabia",
"senegal",
"serbia",
"serbia_montenegro",
"seychelles",
"sierra_leone",
"singapore",
"slovakia",
"slovenia",
"solomon_islands",
"somalia",
"south_africa",
"south_sudan",
"spain",
"srilanka",
"st_pierre_mq",
"svg",
"sudan",
"suriname",
"svalbard_and_jan",
"swaziland",
"sweden",
"switzerland",
"syria",
"travel_document",
"travel_document_eng",
"tajikistan",
"tanzania",
"thailand",
"timor_es",
"turks_caicos",
"togo",
"tokelau",
"tonga",
"trinidad_and_tobago",
"tunisia",
"turkmenist",
"tuvalu",
"uk",
"uae",
"un",
"uganda",
"ukraine",
"uruguay",
"usa",
"uzbekistan",
"vanuatu",
"vatican",
"venezuela",
"vg_us",
"vietnam",
"wake_isl",
"wales_finland",
"yemen",
"yugoslva",
"zambia",
"zanibar",
"zimbabwe"
]
},
"status_code": 200,
"message_code": "success",
"message": "Success",
"success": true
}Request
None