---
search:
  tags:
    - Appointments
    - GET
seo:
  description: >-
    Returns detailed information about a specific appointment. Reference for the
    GET /appointments/{appointment_id} endpoint in the Almendra API.
sidebar:
  label: Get a specific scheduled appointment
  badge: GET
title: Get a specific scheduled appointment
type: openapi-operation
---
Returns detailed information about a specific appointment.

Requires the `appointments:read` permission.

`GET /appointments/{appointment_id}`

**Responses**

- `200` — Appointment details
- `400` — Invalid path parameter, query parameter or request body
- `401` — Unauthorized - Invalid API key
- `403` — The account behind the API key has no active paid plan, or the key lacks the permission this operation needs
- `404` — Appointment not found
- `429` — Rate limit exceeded (600 requests per 60 seconds); retry after \`Retry-After\` seconds
- `500` — Unexpected server error

Response example, 200:

```json
{
  "_id": "507f1f77bcf86cd799439016",
  "patient": "507f1f77bcf86cd799439011",
  "expert": "507f1f77bcf86cd799439012",
  "appointmentStatus": 0,
  "scheduledInfo": {
    "wasScheduled": true,
    "scheduledTimeStart": "2024-02-01T10:00:00.000Z",
    "scheduledTimeEnd": "2024-02-01T11:00:00.000Z",
    "scheduledDuration": 60
  },
  "location": "string",
  "conferenceType": "string",
  "conferenceRoomUrl": "string",
  "conferenceRoomId": "string",
  "price": 0,
  "purchasedHealthPlan": "string",
  "createdAt": "2024-01-15T00:00:00.000Z",
  "updatedAt": "2024-01-15T00:00:00.000Z"
}
```
