---
metadata:
  - name: generator
    content: Diplodoc Platform v5.19.6
alternate:
  - https://docs.routeq.com/doc/en/extras/delivery-feedback-api.md
title: RouteQ — delivery ratings — running the API
---
> **Documentation Index:** Fetch the complete configuration index at https://docs.routeq.com/doc/en/llms.txt


# Viewing delivery ratings via the API

{% note info %}

Running the API is only available to RouteQ users with the Administrator role.

{% endnote %}

## Viewing delivery ratings {#get-delivery-ratings}

To view delivery ratings, use the `delivery-ratings` method.

```
GET https://courier.yandex.ru/api/v1/companies/<your-company-id>/orders/delivery-ratings
```

It returns the `delivery_rating` (the actual rating) and `delivery_comment` (user comments) fields:

```json
[
    {
        "type": "order",
        "courier_name": "Citroen Jumper",
        "courier_number": "0",
        "order_id": 123456,
        ...
        "delivery_rating": 5,
        "delivery_comment": "OK"
    },
  ...
]
```

## Order details {#order-details}

To view order ratings for a specific route, use the `order-details` method.

```
GET https://courier.yandex.ru/api/v1/companies/<your-company-id>/order-details?route_id=<route-id>
```

It returns the `delivery_rating` (the actual rating) and `delivery_comment` (user comments) fields:

```json
[
    {
        "courier_id": 333,
        "courier_name": "Citroen Jamper",
        "order_id": 123456,
        ...
        "delivery_rating": 5,
        "delivery_comment": "OK"
    },
  ...
]
```


## Delivery quality report {#courier-quality}

To view a delivery quality report, use the [courier-quality](https://yandex.ru/routing/doc/en/delivery/redoc/index.html#operation/getsDeliveryQualityInformation) method.

```
GET https://courier.yandex.ru/api/v1/companies/<your-company-id>/courier-quality?types=order&route_id=<route-id>
```

It returns the `delivery_rating` (the actual rating) and `delivery_comment` (user comments) fields:

```json
[
    {
        "type": "order",
        "courier_name": "Citroen Jamper",
        "courier_number": "0",
        "order_number": "2024-01-15",
        ...
        "delivery_rating": 5,
        "delivery_comment": "OK"
    },
  ...
]
```

{% include [warehouse-feedback](_includes/feedback-5c7fe6b98fdb.md) %}