Get a list of supported countries and their states

GET

https://api.synup.com/api/v4/countries

This API fetches a list of supported countries, including their database IDs, ISO codes, and states. The retrieved ISO codes should be used as input values when creating or updating locations.

Request

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.synup.com/api/v4/countries' \
--header 'Authorization: API T9V35W3xxxxxxxxxxx'

Responses

🟢200OK

application/json

Successfully retrieved the list of countries and their states

Body

Example

{
    "data": {
        "supportedCountries": [
            {
                "databaseId": 13,
                "id": "Q291bnRyeToxMw==",
                "iso": "AU",
                "name": "Australia",
                "states": [
                    {
                        "countryId": 13,
                        "id": "136",
                        "iso": "WA",
                        "name": "Western Australia"
                    }
                ]
            }
        ]
    }
}

🟠401Unauthorized

🔴500Server Error

Modified at 2025-05-23 06:55:31

List Active Subscriptions

Get SubCategories and AdditionalCategories