# Upcoming Calls

### Endpoint: Get Upcoming Calls

#### Request

**Method:** `GET`\
**URL:** `https://api.automatta.xyz/api/upcoming-calls?page=1&limit=10`\
**Headers:**

* `accept: */*`
* `x-api-key: {token}`

#### Example Request

```sh
curl -X 'GET' \
  'https://api.automatta.xyz/api/upcoming-calls?page=1&limit=10' \
  -H 'accept: */*' \
  -H 'x-api-key: {token}' \
  -d ''
```

Sample Response

```json
{
  "success": true,
  "message": "Upcoming calls retrieved successfully",
  "data": {
    "calls": [
      {
        "_id": "67dfbb5958c5a38030e2ba18",
        "role": "software engineer",
        "agent_name": "mathew",
        "applicant": {
          "name": "Bamidele Qudus",
          "phoneNumber": "+2347031799388",
          "email": "johndoes@gmail.com",
          "interview_details": {
            "years_of_experience": "5",
            "required_skills": [
              "Microsoft Word",
              "Photoshop",
              "Communication"
            ]
          },
          "company": {
            "name": "CallStack",
            "description": "A leading software development company."
          }
        },
        "type": "HIRING"
      }
    ],
    "total": 11,
    "page": "1",
    "limit": "10",
    "totalPages": 2
  },
  "timestamp": "2025-03-26T15:23:14.984Z"
}
```





