---
title: "List Building IDs"
method: GET
path: "/buildingIds"
tags: ["buildings"]
---

# List Building IDs

`GET /buildingIds`

## Request

- Base URL: `https://api.sb.ecobee.com/api/v2`
- URL: `https://api.sb.ecobee.com/api/v2/buildingIds`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.sb.ecobee.com/api/v2/token` scopes: `read:buildings`

Retrieve a list of all building IDs available under the current scope.

## Response `200`

Success

- ListResponse
  - `status` 'success'
  - `data` object
    - `count` integer
    - `items` ListItem[]
      - `contentLocation` string, uri: URI for retrieving the full resource object
      - `id` string

## Other responses

- `401`: Not authenticated
- `403`: Not authorized
- `422`: Validation Failed
- `429`: Too many requests
- `500`: Internal server error
- `default`: Unexpected error

---

[API](https://skmtc.dev/ecobee/apis/ecobee-smartbuildings-public-api.md) - [All operations](https://skmtc.dev/ecobee/apis/ecobee-smartbuildings-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ecobee/apis/ecobee-smartbuildings-public-api/revisions/d78d4fd5e1c6?raw)