---
title: "List the views of a building"
method: GET
path: "/projects/{project}/angles"
tags: ["Views"]
---

# List the views of a building

`GET /projects/{project}/angles`

## Request

- Base URL: `https://api.getfacade.ai/api/v1`
- URL: `https://api.getfacade.ai/api/v1/projects/{project}/angles`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.getfacade.ai/oauth/authorize`, token URL `https://api.getfacade.ai/oauth/token`, scopes: `agent`)

Every photo accepted as a view of the house, whether it was uploaded through this API or
added by the person in the app. `id` is the view to start a design from; `is_main` marks
the main view, and `file_url` is the photo itself.

## Path parameters

- `project` string, required

## Response `200`

Views of the building

- object
  - `data` object[]
    - `type` 'angle'
    - `id` string
    - `attributes` object
      - `name` string, nullable
      - `is_main` boolean
      - `file_url` string, uri, nullable
      - `width` integer, nullable
      - `height` integer, nullable

## Other responses

- `401`: The key is missing, revoked or expired. Re-issuing a key is a human action.
- `403`: The key is valid but this building belongs to another account. The message is the API's own text; show it unchanged.
- `429`: Rate limited on this key's own bucket, separate from the human sessions of the same account. Refusal is deliberately cheap: back off, do not retry in a tight loop.

---

[API](https://skmtc.dev/getfacade/apis/getfacade-agent-api.md) · [All operations](https://skmtc.dev/getfacade/apis/getfacade-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getfacade/apis/getfacade-agent-api/revisions/2b52eda7362c?raw)