> 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/rate-a-call.md).

# Rate a Call

POST /calls/{call\_id}/rate/

Use the `POST /calls/{call_id}/rate/` endpoint to submit a rating for a completed call. Ratings help evaluate the quality of the service provided during the call.

**Path Parameter**

| **Parameter** | **Type** | **Description**            | **Required** |
| ------------- | -------- | -------------------------- | ------------ |
| `call_id`     | `string` | The unique ID of the call. | Yes          |

**Request Body**

| **Parameter** | **Type** | **Description**                       | **Required** |
| ------------- | -------- | ------------------------------------- | ------------ |
| `rating`      | `number` | The numerical rating for the call.    | Yes          |
| `reason`      | `string` | The reason for the rating (optional). | No           |

**Example Request Body**

```json
{
  "rating": 4.5,
  "reason": "The mechanic was very professional and resolved my issue quickly."
}
```

***

#### Response

**Status Code: `201 Created`**

**Response Body**

| **Parameter** | **Type** | **Description**                         |
| ------------- | -------- | --------------------------------------- |
| `rating`      | `number` | The submitted numerical rating.         |
| `reason`      | `string` | The reason for the rating, if provided. |

**Example Response Body**

```json
{
  "rating": 4.5,
  "reason": "The mechanic was very professional and resolved my issue quickly."
}
```