Skip to main content

List available countries

Introduction#

Retrieves a list of currently supported countries and states along with their ISO codes.

Use this list as a guide of ISO codes, countries and regions supported across Festivo products.

Rate limiting and throttling#

We're here to support the speed of your business - there are no rate limits in place.

Usage#

To list available countries, you'll need to make a request to GET /countries endpoint. You can alter received response by using filters

const axios = require('axios');
axios.get('https://api.getfestivo.com/v2/countries', {
params: {
api_key: "XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXX"
}
})
.then(function (response) {
// handle success
console.log(response)
})
.catch(function (error) {
// handle error
console.log(error)
})
.then(function () {
// always executed
})

Filters#

In GET query you are able to append more parameters. Please make yourself comfortable with the list below before you start using our Public Holidays API.

ParameterRequiredDescriptionTypeExample
codenoISO 3166-1 alpha-2 country codestringUS