Reservations

List reservations

Returns a paginated list of future reservations.
Reservations grant temporary access to specific channels (door controllers) for a person within a specified time window.
Supports incremental sync via since or since_utc parameters.

GET /api/3/reservations

Authentication

This endpoint requires authentication:

OAuth 2.0 Recommended

Use an OAuth 2.0 access token in the Authorization header. This is the recommended authentication method for all integrations. OAuth provides automatic token expiration, granular permission scopes, detailed usage tracking, and per-integration revocation. Learn how to obtain an access token.

Header Format:

Authorization: Bearer YOUR_ACCESS_TOKEN

Required Scopes:

account.reservation.readonly

Parameters

Query Parameters

since string
Optional

Return only reservations updated since this timestamp (local time)

since_utc string
Optional

Return only reservations updated since this timestamp (UTC)

per_page integer
Optional

Number of results per page

Default: 500

page integer
Optional

Page number for pagination

Default: 1

skip_pagination boolean
Optional

Skip pagination and return all results

Responses

200

List of reservations retrieved successfully

Response Fields

id integer required

Unique identifier for the reservation

eg. 789
person_id integer required

ID of the person granted temporary access

eg. 12345
start_time string required

Start time of the reservation

eg. 2024-01-15T09:00:00.000Z
end_time string required

End time of the reservation (must be after start time and on the same day)

eg. 2024-01-15T17:00:00.000Z
channel_ids array<integer> required

Array of channel (door controller) IDs the person has access to during this reservation

eg. [1340, 1341]
created_at string required

Timestamp of creation

updated_at string required

Timestamp of last update

401

Unauthorized - Invalid or missing authentication

Response Fields

error string
eg. unauthorized
error_description string
eg. The access token is invalid
403

Forbidden - User does not have permission

Response Fields

error string
eg. forbidden
error_description string
eg. You are not authorized to access this resource
500

Internal Server Error

Response Fields

error string
eg. internal_server_error
error_description string
eg. An unexpected error occurred

Mentioned in Guides

This endpoint is used in the following guides:

Contractor Temporary Access

Grant time-limited access to contractors for weeks or months in 5 minutes

Common Workflows • 5 min • Intermediate

Request

curl -X GET \
  "https://api.doorflow.com/api/3/reservations" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Responses

List of reservations retrieved successfully

[
  {
    "id": 789,
    "person_id": 12345,
    "start_time": "2024-01-15T09:00:00.000Z",
    "end_time": "2024-01-15T17:00:00.000Z",
    "channel_ids": [
      0
    ],
    "created_at": "string",
    "updated_at": "string"
  }
]