Get Sites List

Gets the list of site for the currently logged in user.


  • Method: GET
  • Server: https://[app key here]-[site_ID here] Take a look at the Authorize your API calls document for more info on how this URL is formed.
    • Note: When building apps always use relative request URLs. Do not use the "full" URL above because you might have problems running your app on a different site as the site_ID parameter will be different.
  • Path: /api/v2/admin/sites
  • Authorization header: This should contain the authorization token. Here is how to obtain the token.


  • Query:
    • status (optional) - indicates the combination of statuses that will be retrieved. It defaults to 101 (Paid, Free, TrialInProgress and GracePeriod). Note: The Delete and Disabled statuses are ignored
    • id (optional) - filter the list, showing only the summary specified by the id


SiteList object with the following properties:

  • Items - an array of SiteSummary objects which have the following properties:
    • Id
    • Name
    • Links
    • SiteLinks
    • useAdvancedModuleDataEdit
    • siteStatus
    • billingMethodTypeId
    • createDate

Available Site Status codes

Status Code (hexa) Code (decimal)
Unknown 0x00 0
TrialInProgress 0x01 1
TrialExpired 0x02 2
GracePeriod 0x04 4
Deleted 0x08 8
Disabled 0x10 16
Paid 0x20 32
Free 0x40 64

Accepts and returns JSON as Content-Type.


GET /api/v2/admin/sites HTTPS/1.1
Content-Type: application/json


HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{"id": ...,
"links": ...,
"name": ...

Sample code

var request = $.ajax({
    url: "/api/v2/admin/sites",
    type: "GET",
    contentType: "application/json",headers: {
        "Authorization": $.cookie('access_token')
request.done(function (msg) {
}) (jqXHR) {
    console.log("Request failed.");
    console.log("Error code: " + jqXHR.status);
    console.log("Error text: " + jqXHR.statusText);
    console.log("Response text: " + jqXHR.responseText);

Error codes

This method will return the following error codes:

  • 200 - success
  • 401 - when authentication token is incorrect or missing