---
title: "Fetch Country List API"
description: "Retrieve a comprehensive list of countries with currency information, supporting search functionality for dynamic dropdowns and form selections."
url: https://support.agentcis.com/en/articles/397-fetch-country-list-api
collection: "API Documentation"
updated: 2025-10-02
language: en
---

# Fetch Country List API

Retrieve a comprehensive list of countries with currency information, supporting search functionality for dynamic dropdowns and form selections.

<table data-id="a53d0a33-d771-4e7f-b9d7-55a49178a8e8" style="min-width: 25px;"><colgroup><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border-width: 1pt; border-style: solid; border-color: #000000;"><p data-id="b4703b97-4f40-4f45-8220-842476878379"><span style="color: rgb(0, 0, 0);"><strong>Base URL: </strong>https://{tenant-domain}/api/countries</span></p><p data-id="6a8bbf35-07f2-4362-8f45-d391e9d2b491"><br></p><p data-id="1148b19a-6093-428b-a2c9-8ba5e3af5229"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span></p></td></tr></tbody></table>

## List Countries                  

-   Endpoint:/
    
-   Method: GET
    
-   Description:Lists countries and it’s description like currency code and many more
    

###   
Response:

<table data-id="7a720c7a-162d-468a-923d-8744fffd94cc" style="min-width: 25px;"><colgroup><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border-width: 1pt; border-style: solid; border-color: #000000;"><p data-id="39b812f3-2dae-413d-a8f7-207c02f09062"><span style="color: rgb(0, 0, 0);">[</span></p><p data-id="08babf98-df56-4b06-8033-b4e02f7872e7"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;{</span></p><p data-id="523dfcc0-833f-47a1-b28e-f6c83dd768f8"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;"id": 1,</span></p><p data-id="50b3d430-0e80-4587-8fde-e48f3c1b9c72"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;"country_name": "Australia",</span></p><p data-id="6c15c750-2a43-44d7-8438-ea2e49c76472"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;"currency_code": "AUD",</span></p><p data-id="9daa6c0b-4de9-4812-9922-6c7e154f3009"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;"currency_name": "Australian Dollar",</span></p><p data-id="061cece7-dddc-4b21-b07f-d5fec9dbce97"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;"country_dialing_code": "61",</span></p><p data-id="11466468-3f04-4e29-b257-4aeabfd44d58"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;"value": "Australia - AUD [Australian Dollar]"</span></p><p data-id="06e6362f-38cf-43e1-b2a5-ffe581f890e4"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;},</span></p><p data-id="3cfedc6c-499e-46ad-9eed-1cecc6d299b7"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;{</span></p><p data-id="9d60cace-3967-460b-a488-d674779179f6"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;"id": 2,</span></p><p data-id="d2b8305a-4d10-4ad6-94e8-3b3184e66cd0"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;"country_name": "United States",</span></p><p data-id="b1af9ee9-c276-4a68-8188-825398d9eb11"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;"currency_code": "USD",</span></p><p data-id="2c28ba2f-875a-488f-9503-71a3b00bde0a"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;"currency_name": "US Dollar",&nbsp;</span></p><p data-id="69e159de-a1e4-4640-b887-cf80c3373ada"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;"country_dialing_code": "1",</span></p><p data-id="e06b8bb1-f5e0-4102-8d92-b4f8e0175acd"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;"value": "United States - USD [US Dollar]"</span></p><p data-id="39e7557d-c6ed-46c1-8a7b-55eccf57f6b4"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;},</span></p><p data-id="60c58c44-50ee-4b11-879f-3b85642bd007"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;{</span></p><p data-id="ace4c6f6-5a04-4741-b0fe-5fc10d5cfb0e"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;"id": 3,</span></p><p data-id="0c5add30-62d0-469e-8efb-51a19a827801"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;"country_name": "United Kingdom",</span></p><p data-id="427c52be-50dd-43d0-9cd5-fb09c457eb45"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;"currency_code": "GBP",</span></p><p data-id="edbd3a33-5978-4272-84d3-8dde85a96c5c"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;"currency_name": "British Pound Sterling",</span></p><p data-id="b1111b19-c1b9-41c2-909a-1879f4b70f11"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;"country_dialing_code": "44",</span></p><p data-id="4949ccf9-2ac6-4dd1-b58f-dc65f2e12714"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;"value": "United Kingdom - GBP [British Pound Sterling]"</span></p><p data-id="2bf60f95-33c1-44f9-b398-ca90ea01e844"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;}</span></p><p data-id="52641e85-d0c8-42e8-891c-8c7573b5b17f"><span style="color: rgb(0, 0, 0);">….</span></p><p data-id="142d5b7b-599d-4a5e-81e4-8d73a9e9d0ac"><span style="color: rgb(0, 0, 0);">]</span></p></td></tr></tbody></table>

  

## Formatted List of countries Countries                   

-   Endpoint:/list?keyword={character}
    
-   Method: GET
    
-   Description:Lists countries also supports wildcards for searching specific country
    
-   country\_name is a parameter which accepts country name and fetch specific country
    
-   Endpoint:/list?keyword=Austr
    

###   Response:

<table data-id="57dcd245-2611-49a5-a3bd-0160202dd054" style="min-width: 25px;"><colgroup><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1" style="vertical-align: top; padding: 5pt; overflow: hidden; overflow-wrap: break-word; border-width: 1pt; border-style: solid; border-color: #000000;"><p data-id="ad1e2943-eabe-4fa2-a4e5-76437e731bed"><span style="color: rgb(0, 0, 0);">[</span></p><p data-id="9e1bbedf-c952-49c6-a84a-db873fa4d22e"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;{</span></p><p data-id="61cc79ac-b7b7-41ed-a7b0-5278f9420bd5"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id": 11,</span></p><p data-id="03ff534b-3406-4243-bd7a-02eb4b9bac86"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"country_name": "Australia",</span></p><p data-id="ff54ae4d-c3e5-4d0b-8de8-54565a0598e2"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"currency_name": "Australian dollar",</span></p><p data-id="ffbf7c1c-d55d-4694-8d34-68504ced0546"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"currency_code": "AUD",</span></p><p data-id="dad3b704-d18a-4346-a0bd-325a9970b9e7"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"country_code": "AU",</span></p><p data-id="abfee5ce-c9a5-4186-a2f7-86cfb30dc67b"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"country_dialing_code": "61",</span></p><p data-id="4f49835d-68f5-426b-860d-2ebda80ff215"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"country_code_iso_alpha3": "AUS",</span></p><p data-id="3a77cfbe-b0c8-430f-83c3-2389417bbbad"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"value": "Australia"</span></p><p data-id="30ce043f-f54c-48c3-a0a5-10fefa19bc92"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;},</span></p><p data-id="7da58223-8677-4b2e-b3f2-6f7989286266"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;{</span></p><p data-id="f3b36818-e0a2-41c4-ad57-69b32832d3dc"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id": 12,</span></p><p data-id="17985de8-427d-4ca2-ba68-d41b7b5614ae"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"country_name": "Austria",</span></p><p data-id="c0270ea9-4835-4610-84a6-79d49be6442d"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"currency_name": "euro",</span></p><p data-id="ebeca278-73d2-47cc-b675-73a862c5dd67"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"currency_code": "EUR",</span></p><p data-id="353f1599-1fed-43b4-9697-393392949282"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"country_code": "AT",</span></p><p data-id="acd31717-a104-475f-965c-229404b7b7ee"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"country_dialing_code": "43",</span></p><p data-id="e44dbc6b-95a3-426d-861f-e16d0f2084c0"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"country_code_iso_alpha3": "AUT",</span></p><p data-id="c0dd2f84-9a91-47ed-9b91-15558e80f7af"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"value": "Austria"</span></p><p data-id="dbc6bd95-81e4-4c6c-a5db-800e60d5cf76"><span style="color: rgb(0, 0, 0);">&nbsp;&nbsp;&nbsp;&nbsp;}</span></p><p data-id="2d4b0c79-158d-462b-98d6-61e429813985"><span style="color: rgb(0, 0, 0);">]</span></p></td></tr></tbody></table>
