> For the complete documentation index, see [llms.txt](https://requestmechanic.gitbook.io/request-mechanic-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://requestmechanic.gitbook.io/request-mechanic-api-documentation/calls/retrieve-upcoming-calls.md).

# Retrieve Upcoming Calls

Use the `GET /calls/upcoming-calls/` endpoint to retrieve a list of upcoming calls scheduled for a user. This allows users to view all their pending call appointments.

***

**Request**

* **Method:** GET
* **URL:** `/calls/upcoming-calls/`
* **Authorization:** Bearer token required.

No additional parameters are needed for this request.

***

**Response**

* **Status Code:** `200 OK`
* **Description:** Successfully retrieves a list of upcoming calls.

**Example Response**:

```json
[
  {
    "call_id": "12345",
    "mechanic_name": "John Doe",
    "scheduled_time": "2024-11-13T10:30:00Z",
    "status": "Scheduled"
  },
  {
    "call_id": "67890",
    "mechanic_name": "Jane Smith",
    "scheduled_time": "2024-11-14T15:00:00Z",
    "status": "Confirmed"
  }
]
```