API Resource: Regions

The 'Regions' resource allows you to get and set the region settings available on some services supported by Getflix.

Note: Not all regions are available for all services, if you specify an invalid region for a particular service, an error will be returned.

---

GET v1/regions.json
Returns a complete array of region objects, each containing a service name and 2 character ISO country code.

Return Data

[
  {
    "service": <serviceName>,
    "region": <regionCode>
  }
]

Example Usage

curl -u <api_key>:x -X GET https://www.getflix.com.au/api/v1/regions.json

[
  {
    "service": "netflix",
    "region": "CA"
  },
  {
    "service": "wdtv",
    "region": "GB"
  },
  {
    "service": "theplatform",
    "region": "US"
  },
  {
    "service": "brightcove",
    "region": "US"
  },
  {
    "service": "sony",
    "region": "US"
  }
]

---

POST v1/regions.json
Updates the region for a specified service. Only 1 service can be updated at a time, and the following JSON object must be present in the POST body.

{
  "service": <serviceName>,
  "region": <regionCode>
}

serviceName: is a valid service name (see region list below)
regionCode: is the ISO 2 letter country code for the region to switch to (in upper-case).

Example Usage

curl -u <api_key>:x -X POST -d '{"service":"netflix","region":"US"}' https://www.getflix.com.au/api/v1/regions.json

---

GET v1/regions/list.json
Fetches a list of services and the valid regions each service can be switched to.

Example Usage

curl -u <api_key>:x -X GET https://www.getflix.com.au/api/v1/regions/list.json