Get list of countries

GET /countries

An API call to get a list of countries

ReturnsShippingCountry[]

Countries list response

Error responses

401object

The X-API-KEY header is missing or invalid (invalid_api_key), or the shop has no active Subbly subscription (inactive_subscription).

curl https://api.subbly.co/storefront/v1/countries \
  -H 'X-API-KEY: <api-key>'

Response

[
  {
    "id": 1,
    "name": "United States",
    "code": "US",
    "code_iso": "USA",
    "region_title": "State",
    "sca_required": false,
    "regions": [
      {
        "id": 1,
        "name": "California",
        "code": "CA"
      }
    ]
  }
]

Countries

Storefront Countries API endpoints

Endpoints

GET/countries

Get list of countries

GET /countries

An API call to get a list of countries

ReturnsShippingCountry[]

Countries list response

idinteger

namestring

codestring

code_isostring

region_titlestring

sca_requiredboolean

regionsShippingRegion[]

Error responses

401object

The X-API-KEY header is missing or invalid (invalid_api_key), or the shop has no active Subbly subscription (inactive_subscription).

curl https://api.subbly.co/storefront/v1/countries \
  -H 'X-API-KEY: <api-key>'

Response

[
  {
    "id": 1,
    "name": "United States",
    "code": "US",
    "code_iso": "USA",
    "region_title": "State",
    "sca_required": false,
    "regions": [
      {
        "id": 1,
        "name": "California",
        "code": "CA"
      }
    ]
  }
]