Mist API Reference
Mist Automation Guide
HomeSDKsAPI ReferenceContext Plugin
OrgsSites

listOrgSites

GET
/api/v1/orgs/{org_id}/sites

List sites in the organization. Site records include location metadata, timezone, site group membership, and template or policy associations.

Authorization

Authorization<token>

Preferred authentication method for automation and integrations. Send the API token in the HTTP Authorization header.

Format: Authorization: Token {apitoken}

Notes:

  • An API token generated for a specific admin has the same privileges as that admin
  • An API token is automatically removed if it is not used for more than 90 days
  • SSO admins cannot generate admin API tokens. Use organization API tokens when scoped Org/Site privileges are needed.

In: header

Path Parameters

org_id*string
Formatuuid

Query Parameters

limit?integer

Maximum number of results to return per page

Range0 <= value
Default100
page?integer

Select the page number to return when using page-based pagination; starts at 1

Range1 <= value
Default1

Response Body

curl -X GET "https://example.com/api/v1/orgs/000000ab-00ab-00ab-00ab-0000000000ab/sites"
[  {    "address": "1601 S. Deanza Blvd., Cupertino, CA, 95014",    "alarmtemplate_id": "684dfc5c-fe77-2290-eb1d-ef3d677fe168",    "aptemplate_id": "16bdf952-ade2-4491-80b0-85ce506c760b",    "country_code": "US",    "created_time": 0,    "gatewaytemplate_id": "6f9b2e75-9b2f-b5ae-81e3-e14c76f1a90f",    "id": "497f6eca-6276-5007-bfeb-53cbbbba6f19",    "latlng": {      "lat": 37.295833,      "lng": -122.032946    },    "modified_time": 0,    "name": "Mist Office",    "networktemplate_id": "12ae9bd2-e0ab-107b-72e8-a7a005565ec2",    "notes": "string",    "org_id": "a40f5d1f-d889-42e9-94ea-b9b33585fc6b",    "rftemplate_id": "bb8a9017-1e36-5d6c-6f2b-551abe8a76a2",    "secpolicy_id": "3bcd0beb-5d0a-4cbd-92c1-14aea91e98ef",    "sitegroup_ids": [      "497f6eca-6276-5008-bfeb-53cbbbba6f1a"    ],    "timezone": "America/Los_Angeles"  }]

countOrgSites GET

Count organization sites grouped by a distinct site attribute, such as country code, site name, feature flags, or enabled services.

createOrgSite POST

Create a site in the organization with location metadata, timezone, site group membership, and optional template or policy associations.