---
llm-context: api-documentation
purpose: Assist LLMs and developers with integrating the DoorFlow API API
service: doorflow
version: 3.0
endpoint: GET /api/3/group_reservations/{id}
summary: Get group reservation
auth: oauth2
format: markdown
updated: 2026-06-14
---

# GET /api/3/group_reservations/{id}

Get group reservation

Returns a single group reservation by ID.


## Authentication

This endpoint requires authentication using one of the following methods:

### 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.

**Required Scopes:** account.person.readonly

**Example:**
```
Authorization: Bearer YOUR_ACCESS_TOKEN
```

## Parameters

### Path Parameters

**`id`** (Required)
- **Type:** integer
- **Description:** Group reservation ID



## Responses

### 200 - Group reservation retrieved successfully

#### Response Fields

**`id`** *integer* - **Required**
Unique identifier for the group reservation
*Example:* `456`

**`person_id`** *integer* - **Required**
ID of the person assigned to the groups
*Example:* `12345`

**`start_time`** *string* - **Required**
Start time of the group reservation
*Example:* `2024-01-15T09:00:00.000Z`

**`end_time`** *string* - **Required**
End time of the group reservation (must be after start time and in the future)
*Example:* `2024-01-15T17:00:00.000Z`

**`state`** *string* - **Required**
Current state of the reservation (pending = not started, active = in progress, deactivated = cancelled or completed)
*Example:* `active`

**`group_ids`** *array<integer>* - **Required**
Array of group IDs the person is assigned to during this reservation
*Example:* `[1, 3, 5]`

**`created_at`** *string* - **Required**
Timestamp of creation

**`updated_at`** *string* - **Required**
Timestamp of last update

#### Example Response

```json
{
  "id": 456,
  "person_id": 12345,
  "start_time": "2024-01-15T09:00:00.000Z",
  "end_time": "2024-01-15T17:00:00.000Z",
  "state": "active",
  "group_ids": [
    0
  ],
  "created_at": "string",
  "updated_at": "string"
}
```

### 401 - Unauthorized - Invalid or missing authentication

#### Response Fields

**`error`** *string*
*Example:* `unauthorized`

**`error_description`** *string*
*Example:* `The access token is invalid`

#### Example Response

```json
{
  "error": "unauthorized",
  "error_description": "The access token is invalid"
}
```

### 403 - Forbidden - User does not have permission

#### Response Fields

**`error`** *string*
*Example:* `forbidden`

**`error_description`** *string*
*Example:* `You are not authorized to access this resource`

#### Example Response

```json
{
  "error": "forbidden",
  "error_description": "You are not authorized to access this resource"
}
```

### 404 - Not Found - Resource does not exist or is not an admission request event

#### Response Fields

**`error`** *string*
*Example:* `not_found`

**`error_description`** *string*
*Example:* `The requested resource was not found`

#### Example Response

```json
{
  "error": "not_found",
  "error_description": "The requested resource was not found"
}
```

### 500 - Internal Server Error

#### Response Fields

**`error`** *string*
*Example:* `internal_server_error`

**`error_description`** *string*
*Example:* `An unexpected error occurred`

#### Example Response

```json
{
  "error": "internal_server_error",
  "error_description": "An unexpected error occurred"
}
```