List Countries | BigCommerce Developer Center

Returns a list of all countries and, if applicable, their states. The response includes the name and code of each returned element and the id of each country.

NOTE: Due to the size of the list returned, the results should be cached for continued use, if possible.

Equivalent Storefront GraphQL API Query: countries. For more information, see the GraphQL Playground.

Returns a list of **all** countries and, if applicable, their states. The response includes the name and code of each returned element and the id of each country. **NOTE:** Due to the size of the list returned, the results should be cached for continued use, if possible. Equivalent Storefront GraphQL API Query: `countries`. For more information, see the [GraphQL Playground](https://api-b2b.bigcommerce.com/graphql/playground).

Authentication

AuthorizationBearer

Authentication header

Header	Argument	Description
`Authorization`	`Bearer {{B2B_JWT_TOKEN}}`	You can obtain this token using the steps described in the REST Storefront API section[…]

### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| |`Authorization`|`Bearer {{B2B_JWT_TOKEN}}`| You can obtain this token using the steps described in the [REST Storefront API](/developer/docs/b2b-edition/getting-started/authentication#rest-storefront-api) section[...]

Query parameters

storeHashstringRequired

The unique alphanumeric store hash for the BigCommerce store.

Response

codedoubleDefaults to 200

dataobject

messagestringDefaults to SUCCESS

1	import requests
2
3	url = "https://api-b2b.bigcommerce.com/api/v2/companies/addresses/countries"
4
5	querystring = {"storeHash":"abc123"}
6
7	headers = {"Authorization": "Bearer <token>"}
8
9	response = requests.get(url, headers=headers, params=querystring)
10
11	print(response.json())

1	{
2	"code": 200,
3	"data": {
4	"list": [
5	{
6	"countryCode": "US",
7	"countryName": "United States",
8	"id": 226,
9	"states": [
10	{
11	"stateName": "Texas",
12	"stateCode": "TX"
13	}
14	]
15	}
16	]
17	},
18	"message": "string"
19	}