---
title: "List access control doors"
method: GET
path: "/v1/access-control/doors"
tags: ["doors"]
---

# List access control doors

`GET /v1/access-control/doors`

Returns the doors the API key creator can see, with their online
status. Admins see every door in the tenant; lower roles see only
doors they have permission to unlock. Use `page` and `limit` to
paginate; `has_more` on the response signals more pages remain.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Successful Response

- DoorList
  - `results` Door[], required
    - `id` integer, required — Stable internal identifier of the door.
    - `name` string, required — Human-readable door name as set in the Coram app.
    - `location_id` integer, required — ID of the location this door belongs to. Zero when the door has no assigned location.
    - `is_online` boolean, required — True if the door's controller board has reported a heartbeat within the last 15 seconds.
  - `has_more` boolean, required — Reserved for future pagination; always false today. The endpoint currently returns every door the caller can see.

## Other responses

- `401` — Missing or invalid API key
- `403` — API key lacks the required scope or role

---

[API](https://skmtc.dev/coram/apis/coram-api.md) · [All operations](https://skmtc.dev/coram/apis/coram-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coram/coram-api/revisions/2842f226f93b/schema)
