Data

The data API allows you to view all types of data available.

List all data

This API lets you retrieve and view a simple list of available data endpoints.

GET /wp-json/wc/v3/data

cURL

curl https://example.com/wp-json/wc/v3/data \
	-u consumer_key:consumer_secret

JavaScript

WooCommerce.get( 'data' )
	.then( ( response ) => {
		console.log( response.data );
	} )
	.catch( ( error ) => {
		console.log( error.response.data );
	} );

PHP

<?php print_r($woocommerce->get('data')); ?>

Python

print(wcapi.get("data").json())

Ruby

woocommerce.get("data").parsed_response

JSON Response

[
	{
		"slug": "continents",
		"description": "List of supported continents, countries, and states.",
		"_links": {
			"self": [
				{
					"href": "https://example.com/wp-json/wc/v3/data/continents"
				}
			],
			"collection": [
				{
					"href": "https://example.com/wp-json/wc/v3/data"
				}
			]
		}
	},
	{
		"slug": "countries",
		"description": "List of supported states in a given country.",
		"_links": {
			"self": [
				{
					"href": "https://example.com/wp-json/wc/v3/data/countries"
				}
			],
			"collection": [
				{
					"href": "https://example.com/wp-json/wc/v3/data"
				}
			]
		}
	},
	{
		"slug": "currencies",
		"description": "List of supported currencies.",
		"_links": {
			"self": [
				{
					"href": "https://example.com/wp-json/wc/v3/data/currencies"
				}
			],
			"collection": [
				{
					"href": "https://example.com/wp-json/wc/v3/data"
				}
			]
		}
	}
]

Data properties

Attribute	Type	Description
slug	string	Data resource ID. READ-ONLY
description	string	Data resource description. READ-ONLY

List all continents

This API helps you to view all the continents.

GET /wp-json/wc/v3/data/continents

cURL

curl https://example.com/wp-json/wc/v3/data/continents \
	-u consumer_key:consumer_secret

JavaScript

WooCommerce.get( 'data/continents' )
	.then( ( response ) => {
		console.log( response.data );
	} )
	.catch( ( error ) => {
		console.log( error.response.data );
	} );

PHP

<?php
print_r($woocommerce->get('data/continents'));
?>

Python

print(wcapi.get("data/continents").json())

Ruby

woocommerce.get("data/continents").parsed_response

JSON Response

[
	{
		"code": "AF",
		"name": "Africa",
		"countries": [
			{
				"code": "AO",
				"name": "Angola",
				"states": [
					{
						"code": "BGO",
						"name": "Bengo"
					},
					{
						"code": "BLU",
						"name": "Benguela"
					},
					{
						"code": "BIE",
						"name": "Bié"
					},
					{
						"code": "CAB",
						"name": "Cabinda"
					},
					{
						"code": "CNN",
						"name": "Cunene"
					},
					{
						"code": "HUA",
						"name": "Huambo"
					},
					{
						"code": "HUI",
						"name": "Huíla"
					},
					{
						"code": "CCU",
						"name": "Kuando Kubango"
					},
					{
						"code": "CNO",
						"name": "Kwanza-Norte"
					},
					{
						"code": "CUS",
						"name": "Kwanza-Sul"
					},
					{
						"code": "LUA",
						"name": "Luanda"
					},
					{
						"code": "LNO",
						"name": "Lunda-Norte"
					},
					{
						"code": "LSU",
						"name": "Lunda-Sul"
					},
					{
						"code": "MAL",
						"name": "Malanje"
					},
					{
						"code": "MOX",
						"name": "Moxico"
					},
					{
						"code": "NAM",
						"name": "Namibe"
					},
					{
						"code": "UIG",
						"name": "Uíge"
					},
					{
						"code": "ZAI",
						"name": "Zaire"
					}
				]
			},
			{
				"code": "BF",
				"name": "Burkina Faso",
				"states": []
			},
			{
				"code": "BI",
				"name": "Burundi",
				"states": []
			}
		],
		"_links": {
			"self": [
				{
					"href": "https://example.com/wp-json/wc/v3/data/continents/af"
				}
			],
			"collection": [
				{
					"href": "https://example.com/wp-json/wc/v3/data/continents"
				}
			]
		}
	}
]

Continents properties

Attribute	Type	Description
code	string	2 character continent code. READ-ONLY
name	string	Full name of continent. READ-ONLY
countries	array	List of countries on this continent. See Continents - Countries properties READ-ONLY

Continents - Countries properties

Attribute	Type	Description
code	string	ISO3166 alpha-2 country code. READ-ONLY
currency_code	string	Default ISO4127 alpha-3 currency code for the country. READ-ONLY
currency_pos	string	Currency symbol position for this country. READ-ONLY
decimal_sep	string	Decimal separator for displayed prices for this country. READ-ONLY
dimension_unit	string	The unit lengths are defined in for this country. READ-ONLY
name	string	Full name of country. READ-ONLY
num_decimals	integer	Number of decimal points shown in displayed prices for this country. READ-ONLY
states	array	List of states in this country. See Continents - Countries - States properties READ-ONLY
thousand_sep	string	Thousands separator for displayed prices in this country. READ-ONLY
weight_unit	string	The unit weights are defined in for this country. READ-ONLY

Continents - Countries - States properties

Attribute	Type	Description
code	string	State code. READ-ONLY
name	string	Full name of state. READ-ONLY

Retrieve continent data

This API lets you retrieve and view a continent data.

GET /wp-json/wc/v3/data/continents/<location>

cURL

curl https://example.com/wp-json/wc/v3/data/continents/eu \
	-u consumer_key:consumer_secret

JavaScript

WooCommerce.get( 'data/continents/eu' )
	.then( ( response ) => {
		console.log( response.data );
	} )
	.catch( ( error ) => {
		console.log( error.response.data );
	} );

PHP

<?php
print_r($woocommerce->get('data/continents/eu'));
?>

Python

print(wcapi.get("data/continents/eu").json())

Ruby

woocommerce.get("data/continents/eu").parsed_response

JSON Response

{
	"code": "EU",
	"name": "Europe",
	"countries": [
		{
			"code": "AD",
			"name": "Andorra",
			"states": []
		},
		{
			"code": "AL",
			"name": "Albania",
			"states": []
		},
		{
			"code": "AT",
			"name": "Austria",
			"states": []
		},
		{
			"code": "AX",
			"name": "Åland Islands",
			"states": []
		},
		{
			"code": "BA",
			"name": "Bosnia and Herzegovina",
			"states": []
		},
		{
			"code": "BE",
			"name": "Belgium",
			"currency_code": "EUR",
			"currency_pos": "left",
			"decimal_sep": ",",
			"dimension_unit": "cm",
			"num_decimals": 2,
			"thousand_sep": " ",
			"weight_unit": "kg",
			"states": []
		},
		{
			"code": "BG",
			"name": "Bulgaria",
			"states": [
				{
					"code": "BG-01",
					"name": "Blagoevgrad"
				},
				{
					"code": "BG-02",
					"name": "Burgas"
				},
				{
					"code": "BG-08",
					"name": "Dobrich"
				},
				{
					"code": "BG-07",
					"name": "Gabrovo"
				},
				{
					"code": "BG-26",
					"name": "Haskovo"
				},
				{
					"code": "BG-09",
					"name": "Kardzhali"
				},
				{
					"code": "BG-10",
					"name": "Kyustendil"
				},
				{
					"code": "BG-11",
					"name": "Lovech"
				},
				{
					"code": "BG-12",
					"name": "Montana"
				},
				{
					"code": "BG-13",
					"name": "Pazardzhik"
				},
				{
					"code": "BG-14",
					"name": "Pernik"
				},
				{
					"code": "BG-15",
					"name": "Pleven"
				},
				{
					"code": "BG-16",
					"name": "Plovdiv"
				},
				{
					"code": "BG-17",
					"name": "Razgrad"
				},
				{
					"code": "BG-18",
					"name": "Ruse"
				},
				{
					"code": "BG-27",
					"name": "Shumen"
				},
				{
					"code": "BG-19",
					"name": "Silistra"
				},
				{
					"code": "BG-20",
					"name": "Sliven"
				},
				{
					"code": "BG-21",
					"name": "Smolyan"
				},
				{
					"code": "BG-23",
					"name": "Sofia"
				},
				{
					"code": "BG-22",
					"name": "Sofia-Grad"
				},
				{
					"code": "BG-24",
					"name": "Stara Zagora"
				},
				{
					"code": "BG-25",
					"name": "Targovishte"
				},
				{
					"code": "BG-03",
					"name": "Varna"
				},
				{
					"code": "BG-04",
					"name": "Veliko Tarnovo"
				},
				{
					"code": "BG-05",
					"name": "Vidin"
				},
				{
					"code": "BG-06",
					"name": "Vratsa"
				},
				{
					"code": "BG-28",
					"name": "Yambol"
				}
			]
		}
	],
	"_links": {
		"self": [
			{
				"href": "https://example.com/wp-json/wc/v3/data/continents/eu"
			}
		],
		"collection": [
			{
				"href": "https://example.com/wp-json/wc/v3/data/continents"
			}
		]
	}
}

Continent properties

See list of continents properties.

List all countries

This API helps you to view all the countries.

GET /wp-json/wc/v3/data/countries

cURL

curl https://example.com/wp-json/wc/v3/data/countries \
	-u consumer_key:consumer_secret

JavaScript

WooCommerce.get( 'data/countries' )
	.then( ( response ) => {
		console.log( response.data );
	} )
	.catch( ( error ) => {
		console.log( error.response.data );
	} );

PHP

<?php
print_r($woocommerce->get('data/countries'));
?>

Python

print(wcapi.get("data/countries").json())

Ruby

woocommerce.get("data/countries").parsed_response

JSON Response

[
	{
		"code": "US",
		"name": "United States (US)",
		"states": [
			{
				"code": "AL",
				"name": "Alabama"
			},
			{
				"code": "AK",
				"name": "Alaska"
			},
			{
				"code": "AZ",
				"name": "Arizona"
			},
			{
				"code": "AR",
				"name": "Arkansas"
			},
			{
				"code": "CA",
				"name": "California"
			},
			{
				"code": "CO",
				"name": "Colorado"
			},
			{
				"code": "CT",
				"name": "Connecticut"
			},
			{
				"code": "DE",
				"name": "Delaware"
			},
			{
				"code": "DC",
				"name": "District Of Columbia"
			},
			{
				"code": "FL",
				"name": "Florida"
			},
			{
				"code": "GA",
				"name": "Georgia"
			},
			{
				"code": "HI",
				"name": "Hawaii"
			},
			{
				"code": "ID",
				"name": "Idaho"
			},
			{
				"code": "IL",
				"name": "Illinois"
			},
			{
				"code": "IN",
				"name": "Indiana"
			},
			{
				"code": "IA",
				"name": "Iowa"
			},
			{
				"code": "KS",
				"name": "Kansas"
			},
			{
				"code": "KY",
				"name": "Kentucky"
			},
			{
				"code": "LA",
				"name": "Louisiana"
			},
			{
				"code": "ME",
				"name": "Maine"
			},
			{
				"code": "MD",
				"name": "Maryland"
			},
			{
				"code": "MA",
				"name": "Massachusetts"
			},
			{
				"code": "MI",
				"name": "Michigan"
			},
			{
				"code": "MN",
				"name": "Minnesota"
			},
			{
				"code": "MS",
				"name": "Mississippi"
			},
			{
				"code": "MO",
				"name": "Missouri"
			},
			{
				"code": "MT",
				"name": "Montana"
			},
			{
				"code": "NE",
				"name": "Nebraska"
			},
			{
				"code": "NV",
				"name": "Nevada"
			},
			{
				"code": "NH",
				"name": "New Hampshire"
			},
			{
				"code": "NJ",
				"name": "New Jersey"
			},
			{
				"code": "NM",
				"name": "New Mexico"
			},
			{
				"code": "NY",
				"name": "New York"
			},
			{
				"code": "NC",
				"name": "North Carolina"
			},
			{
				"code": "ND",
				"name": "North Dakota"
			},
			{
				"code": "OH",
				"name": "Ohio"
			},
			{
				"code": "OK",
				"name": "Oklahoma"
			},
			{
				"code": "OR",
				"name": "Oregon"
			},
			{
				"code": "PA",
				"name": "Pennsylvania"
			},
			{
				"code": "RI",
				"name": "Rhode Island"
			},
			{
				"code": "SC",
				"name": "South Carolina"
			},
			{
				"code": "SD",
				"name": "South Dakota"
			},
			{
				"code": "TN",
				"name": "Tennessee"
			},
			{
				"code": "TX",
				"name": "Texas"
			},
			{
				"code": "UT",
				"name": "Utah"
			},
			{
				"code": "VT",
				"name": "Vermont"
			},
			{
				"code": "VA",
				"name": "Virginia"
			},
			{
				"code": "WA",
				"name": "Washington"
			},
			{
				"code": "WV",
				"name": "West Virginia"
			},
			{
				"code": "WI",
				"name": "Wisconsin"
			},
			{
				"code": "WY",
				"name": "Wyoming"
			},
			{
				"code": "AA",
				"name": "Armed Forces (AA)"
			},
			{
				"code": "AE",
				"name": "Armed Forces (AE)"
			},
			{
				"code": "AP",
				"name": "Armed Forces (AP)"
			}
		],
		"_links": {
			"self": [
				{
					"href": "https://example.com/wp-json/wc/v3/data/countries/us"
				}
			],
			"collection": [
				{
					"href": "https://example.com/wp-json/wc/v3/data/countries"
				}
			]
		}
	}
]

Countries properties

Attribute	Type	Description
code	string	ISO3166 alpha-2 country code. READ-ONLY
name	string	Full name of country. READ-ONLY
states	array	List of states in this country. See Countries - States properties READ-ONLY

Countries - States properties

Attribute	Type	Description
code	string	State code. READ-ONLY
name	string	Full name of state. READ-ONLY

Retrieve country data

This API lets you retrieve and view a country data.

GET /wp-json/wc/v3/data/countries/<location>

cURL

curl https://example.com/wp-json/wc/v3/data/countries/br \
	-u consumer_key:consumer_secret

JavaScript

WooCommerce.get( 'data/countries/br' )
	.then( ( response ) => {
		console.log( response.data );
	} )
	.catch( ( error ) => {
		console.log( error.response.data );
	} );

PHP

<?php
print_r($woocommerce->get('data/countries/br'));
?>

Python

print(wcapi.get("data/countries/br").json())

Ruby

woocommerce.get("data/countries/br").parsed_response

JSON Response

{
	"code": "BR",
	"name": "Brazil",
	"states": [
		{
			"code": "AC",
			"name": "Acre"
		},
		{
			"code": "AL",
			"name": "Alagoas"
		},
		{
			"code": "AP",
			"name": "Amapá"
		},
		{
			"code": "AM",
			"name": "Amazonas"
		},
		{
			"code": "BA",
			"name": "Bahia"
		},
		{
			"code": "CE",
			"name": "Ceará"
		},
		{
			"code": "DF",
			"name": "Distrito Federal"
		},
		{
			"code": "ES",
			"name": "Espírito Santo"
		},
		{
			"code": "GO",
			"name": "Goiás"
		},
		{
			"code": "MA",
			"name": "Maranhão"
		},
		{
			"code": "MT",
			"name": "Mato Grosso"
		},
		{
			"code": "MS",
			"name": "Mato Grosso do Sul"
		},
		{
			"code": "MG",
			"name": "Minas Gerais"
		},
		{
			"code": "PA",
			"name": "Pará"
		},
		{
			"code": "PB",
			"name": "Paraíba"
		},
		{
			"code": "PR",
			"name": "Paraná"
		},
		{
			"code": "PE",
			"name": "Pernambuco"
		},
		{
			"code": "PI",
			"name": "Piauí"
		},
		{
			"code": "RJ",
			"name": "Rio de Janeiro"
		},
		{
			"code": "RN",
			"name": "Rio Grande do Norte"
		},
		{
			"code": "RS",
			"name": "Rio Grande do Sul"
		},
		{
			"code": "RO",
			"name": "Rondônia"
		},
		{
			"code": "RR",
			"name": "Roraima"
		},
		{
			"code": "SC",
			"name": "Santa Catarina"
		},
		{
			"code": "SP",
			"name": "São Paulo"
		},
		{
			"code": "SE",
			"name": "Sergipe"
		},
		{
			"code": "TO",
			"name": "Tocantins"
		}
	],
	"_links": {
		"self": [
			{
				"href": "https://example.com/wp-json/wc/v3/data/countries/br"
			}
		],
		"collection": [
			{
				"href": "https://example.com/wp-json/wc/v3/data/countries"
			}
		]
	}
}

Country properties

See list of countries properties.

List all currencies

This API helps you to view all the currencies.

GET /wp-json/wc/v3/data/currencies

cURL

curl https://example.com/wp-json/wc/v3/data/currencies \
	-u consumer_key:consumer_secret

JavaScript

WooCommerce.get( 'data/currencies' )
	.then( ( response ) => {
		console.log( response.data );
	} )
	.catch( ( error ) => {
		console.log( error.response.data );
	} );

PHP

<?php
print_r($woocommerce->get('data/currencies'));
?>

Python

print(wcapi.get("data/currencies").json())

Ruby

woocommerce.get("data/currencies").parsed_response

JSON Response

[
	{
		"code": "BTC",
		"name": "Bitcoin",
		"symbol": "฿",
		"_links": {
			"self": [
				{
					"href": "https://example.com/wp-json/wc/v3/data/currencies/BTC"
				}
			],
			"collection": [
				{
					"href": "https://example.com/wp-json/wc/v3/data/currencies"
				}
			]
		}
	},
	{
		"code": "EUR",
		"name": "Euro",
		"symbol": "€",
		"_links": {
			"self": [
				{
					"href": "https://example.com/wp-json/wc/v3/data/currencies/EUR"
				}
			],
			"collection": [
				{
					"href": "https://example.com/wp-json/wc/v3/data/currencies"
				}
			]
		}
	},
	{
		"code": "USD",
		"name": "United States (US) dollar",
		"symbol": "$",
		"_links": {
			"self": [
				{
					"href": "https://example.com/wp-json/wc/v3/data/currencies/USD"
				}
			],
			"collection": [
				{
					"href": "https://example.com/wp-json/wc/v3/data/currencies"
				}
			]
		}
	}
]

Currencies properties

Attribute	Type	Description
code	string	ISO4217 currency code. READ-ONLY
name	string	Full name of currency. READ-ONLY
symbol	string	Currency symbol. READ-ONLY

Retrieve currency data

This API lets you retrieve and view a currency data.

GET /wp-json/wc/v3/data/currencies/<currency>

cURL

curl https://example.com/wp-json/wc/v3/data/currencies/brl \
	-u consumer_key:consumer_secret

JavaScript

WooCommerce.get( 'data/currencies/brl' )
	.then( ( response ) => {
		console.log( response.data );
	} )
	.catch( ( error ) => {
		console.log( error.response.data );
	} );

PHP

<?php
print_r($woocommerce->get('data/currencies/brl'));
?>

Python

print(wcapi.get("data/currencies/brl").json())

Ruby

woocommerce.get("data/currencies/brl").parsed_response

JSON Response

{
	"code": "BRL",
	"name": "Brazilian real",
	"symbol": "R$",
	"_links": {
		"self": [
			{
				"href": "https://example.com/wp-json/wc/v3/data/currencies/BRL"
			}
		],
		"collection": [
			{
				"href": "https://example.com/wp-json/wc/v3/data/currencies"
			}
		]
	}
}

Currency properties

See list of currencies properties.

Retrieve current currency

This API lets you retrieve and view store's current currency data.

GET /wp-json/wc/v3/data/currencies/current

cURL

curl https://example.com/wp-json/wc/v3/data/currencies/current \
	-u consumer_key:consumer_secret

JavaScript

WooCommerce.get( 'data/currencies/current' )
	.then( ( response ) => {
		console.log( response.data );
	} )
	.catch( ( error ) => {
		console.log( error.response.data );
	} );

PHP

<?php
print_r($woocommerce->get('data/currencies/current'));
?>

Python

print(wcapi.get("data/currencies/current").json())

Ruby

woocommerce.get("data/currencies/current").parsed_response

JSON Response

{
	"code": "USD",
	"name": "United States (US) dollar",
	"symbol": "$",
	"_links": {
		"self": [
			{
				"href": "https://example.com/wp-json/wc/v3/data/currencies/USD"
			}
		],
		"collection": [
			{
				"href": "https://example.com/wp-json/wc/v3/data/currencies"
			}
		]
	}
}

Currency properties

See list of currencies properties.