Gets delivery quality information with pagination

HTTP Request

GET https://courier.yandex.ru/api/v2/companies/{company_id}/courier-quality\
?date={string}\
&depot_id={integer}\
&route_id={integer}\
&types={string}\
&with_deleted_couriers={boolean}\
&page_token={string}\
&max_results={integer}

Path Parameters

company_id *

integer

Company ID used in requests to the Track & Trace API.

* Required parameter

Query Parameters

date	string The route's date in YYYY-MM-DD format. Fields `date` and `route_id` are mutually exclusive. But at least one of them must be present.
depot_id	integer ID of the depot where the route starts. Minimum value: `1`.
route_id	integer ID of the route. Fields `date` and `route_id` are mutually exclusive. But at least one of them must be present. Minimum value: `1`.
types	string Comma-separated list of point types to use in report. Available types are "order", "depot", "garage". Default "order".
with_deleted_couriers	boolean Include deleted couriers in the report.
page_token	string Pagination token, can either be omitted or equal to next_page_token from the body of previos response.
max_results	integer Maximum number of entities to be returned. Minimum value: `1`. Maximum value: `100`. Default value: `100`.

* Required parameter

Responses

Code 200

Report on the delivery quality received.

{
  "next_page_token": string,
  "results": [
    {
      "air_distance": number,
      "arrived_at": string,
      "courier_deleted": boolean,
      "courier_name": string,
      "courier_number": string,
      "customer_name": string,
      "delivery_comment": string,
      "delivery_lat": number,
      "delivery_lon": number,
      "delivery_not_in_interval": boolean,
      "delivery_rating": number,
      "depot_number": string,
      "far_from_point": boolean,
      "garage_number": string,
      "lat": number,
      "late_call_before_delivery": boolean,
      "left_at": string,
      "location_idle_duration": number,
      "lon": number,
      "no_call_before_delivery": boolean,
      "not_in_order": boolean,
      "order_address": string,
      "order_comments": string,
      "order_completed_at": string,
      "order_confirmed_at": string,
      "order_interval": [
        {
          "end": string,
          "start": string
        }
      ],
      "order_number": string,
      "order_payment_status": string,
      "order_payment_type": string,
      "order_shared_with_companies": [
        {
          "id": integer,
          "name": string,
          "number": string
        }
      ],
      "order_status": string,
      "order_status_comments": [
        {
          "comment": string,
          "id": integer,
          "status": string
        }
      ],
      "order_visited_at": string,
      "order_volume": number,
      "order_weight": number,
      "phone": string,
      "refined_lat": number,
      "refined_lon": number,
      "route_date": string,
      "route_imei": integer,
      "route_imei_str": string,
      "route_number": string,
      "route_routing_mode": string,
      "segment_distance_m": number,
      "service_duration_s": integer,
      "shared_service_duration_s": integer,
      "suggested_order_number": number,
      "time_interval_error": number,
      "transit_idle_duration": number,
      "type": string,
      "used_mark_delivered_radius": number
    }
  ]
}
Copied to clipboard

Representation

Collapse all

Expand all

Fields

next_page_token

string

If present, then there is a next page, and, to get the next page, this url can be called with page_token, which is equal to this field.

results[] *

array

One Of:

results[].air_distance	number The distance between the order coordinates and the courier location in which the order status was changed to "finished" or "partially_finished", in a straight line in meters.
results[].arrived_at	string The time when the courier first entered the area in the specified radius from the delivery point, in ISO 8601 format.
results[].courier_deleted	boolean Courier status, deleted or not.
results[].courier_name	string Name of the courier fulfilling the order.
results[].courier_number	string ID of the courier fulfilling the order.
results[].customer_name	string Customer's name.
results[].delivery_comment	string Order delivery rating comment.
results[].delivery_lat	number Latitude of order delivery location.
results[].delivery_lon	number Longitude of order delivery location.
results[].delivery_not_in_interval	boolean Indicates whether the order was completed outside of the agreed timeframe. Returns `true` if the order was not delivered within the specified timeframe.
results[].delivery_rating	number Order delivery rating. Minimum value: `1`. Maximum value: `5`.
results[].depot_number	string The unique number of the depot that handles the order.
results[].far_from_point	boolean Indicates that items were delivered far away from the specified point. Returns `true` if the distance between the actual delivery point and the one specified in the order is more than 200 meters.
results[].lat	number Latitude of order location.
results[].late_call_before_delivery	boolean Indicates that the call to the customer was late. Returns `true` if the call was made less than 30 minutes before completing the order.
results[].left_at	string The time when the courier last left the delivery point, in ISO 8601 format.
results[].location_idle_duration	number Duration of idle events at order location.
results[].lon	number Longitude of order location.
results[].no_call_before_delivery	boolean Indicates that the customer didn't get a call before the order was completed. Returns `true` if the courier didn't call before the order was completed or canceled.
results[].not_in_order	boolean Indicates that the delivery was completed in an unexpected order. Returns `true` if the delivery wasn't completed in the order specified in the Track & Trace API.
results[].order_address	string Order delivery address.
results[].order_comments	string Order comments.
results[].order_completed_at	string The time when information about the order was recorded, in ISO 8601 format.
results[].order_confirmed_at	string Time when delivery was agreed on and the order was switched to the confirmed status, in ISO 8601 format.
results[].order_interval[]	array
results[].order_interval[].end	string The end of the agreed delivery interval, in ISO 8601 format.
results[].order_interval[].start	string The start of the agreed delivery window, in ISO 8601 format.
results[].order_number	string Order number in the delivery company database.
results[].order_payment_status	string Payment status. Possible values: paid — The order is already paid. unpaid — The order is not paid yet. Allowed values paid unpaid
results[].order_payment_type	string Payment method. Possible values: cash — Payment to the courier in cash. card — Payment to the courier by bank card. prepaid — Prepayment (paid in advance). yandex_pay — Payment via Yandex Pay. Can only be set internally. Allowed values cash card prepaid yandex_pay
results[].order_shared_with_companies[]	array
results[].order_shared_with_companies[].id	integer ID of the company that also receives order information.
results[].order_shared_with_companies[].name	string Name of the company.
results[].order_shared_with_companies[].number	string Number of the company.
results[].order_status	string The current order status. Possible values: new — The order was created. confirmed — The order delivery time was set (confirmed with recipient). finished — The order was delivered. partially_finished — The order was delivered only partially. Order status can be set to `partially_finished` only for companies with `company.partially_finished_status_enabled` flag equals `true`. cancelled — The order was canceled. postponed — The order is postponed or the courier couldn't contact the customer.
results[].order_status_comments[]	array
results[].order_status_comments[].comment	string Comment for order status update event.
results[].order_status_comments[].id	integer ID of the order status update event.
results[].order_status_comments[].status	string The current order status. Possible values: new — The order was created. confirmed — The order delivery time was set (confirmed with recipient). finished — The order was delivered. partially_finished — The order was delivered only partially. Order status can be set to `partially_finished` only for companies with `company.partially_finished_status_enabled` flag equals `true`. cancelled — The order was canceled. postponed — The order is postponed or the courier couldn't contact the customer.
results[].order_visited_at	string Date and time when the courier spent mark_delivered_service_time_coefficient * (order.service_duration_s + order.shared_service_duration_s) seconds within mark_delivered_radius meters from the delivery point. Specified in ISO 8601 format, based on data from the GPS tracker or mobile app.
results[].order_volume	number Order volume.
results[].order_weight	number Order weight.
results[].phone	string The recipient's phone number.
results[].refined_lat	number Latitude of the real (refined by courier) delivery point.
results[].refined_lon	number Logitude of the real (refined by courier) delivery point.
results[].route_date	string The route's date in YYYY-MM-DD format.
results[].route_imei	integer The number of the GPS tracker of the courier fulfilling the order.
results[].route_imei_str	string String representation of numeric number of a GPS tracker. Should be used in case integer overflow of numeric number of a GPS tracker value in the programming language used. If defined in request, this takes precedence over the value of integer number of a GPS tracker field.
results[].route_number	string Unique route number that matches the number in the delivery company's database.
results[].route_routing_mode	string Transportation method. Possible values: `driving` - courier drives a car. `truck` - courier drives a truck. `transit` - courier uses public transport and walks. `walking` - courier walks.
results[].segment_distance_m	number Distance the courier went from their last visited location.
results[].service_duration_s	integer Expected time the courier will need to pass the order to the recipient, including going up to the floor and receiving payment.
results[].shared_service_duration_s	integer Service duration at the location, which can be shared with other orders at the same location. Shared service duration can include operations as parking a car, delivering documents, etc.
results[].suggested_order_number	number The number of the order that should be delivered according to route.
results[].time_interval_error	number The amount of time the delivery window was exceeded, in seconds.
results[].transit_idle_duration	number Duration of idle events in transit from last visited location.
results[].type	string Object type `order`.
results[].used_mark_delivered_radius	number The value of order.mark_delivered_radius or depot.mark_delivered_radius or company.mark_delivered_radius that was used to mark the order as visited. Returns `null` until the order is visited. Minimum value: `0`. Maximum value: `2000`.

results[].arrived_at	string The time when the courier first entered the area in the specified radius from the depot, in ISO 8601 format.
results[].courier_deleted	boolean Courier status, deleted or not.
results[].courier_name	string Name of the courier fulfilling the order.
results[].courier_number	string ID of the courier fulfilling the order.
results[].depot_number	string The unique number of the depot.
results[].lat	number Latitude of depot location.
results[].left_at	string The time when the courier last left the depot, in ISO 8601 format.
results[].location_idle_duration	number Duration of idle events at depot location.
results[].lon	number Longitude of depot location.
results[].route_date	string The route's date in YYYY-MM-DD format.
results[].route_number	string Unique route number that matches the number in the delivery company's database.
results[].segment_distance_m	number Distance the courier went from their last visited location.
results[].service_duration_s	integer Time spent dispatching goods in the depot, in seconds. This time is independent from the time required to load orders.
results[].transit_idle_duration	number Duration of idle events in transit from last visited location.
results[].type	string Object type `depot`.

results[].courier_deleted	boolean Courier status, deleted or not.
results[].courier_name	string Name of the courier fulfilling the order.
results[].courier_number	string ID of the courier fulfilling the order.
results[].garage_number	string The unique number of the garage.
results[].lat	number Latitude of garage location.
results[].location_idle_duration	number Duration of idle events at garage location.
results[].lon	number Longitude of garage location.
results[].route_date	string The route's date in YYYY-MM-DD format.
results[].route_number	string Unique route number that matches the number in the delivery company's database.
results[].segment_distance_m	number Distance the courier went from their last visited location.
results[].transit_idle_duration	number Duration of idle events in transit from last visited location.
results[].type	string Object type `garage`.

results[].air_distance

number

The distance between the order coordinates and the courier location in which the order status was changed to "finished" or "partially_finished", in a straight line in meters.

results[].arrived_at

string

The time when the courier first entered the area in the specified radius from the delivery point, in ISO 8601 format.

results[].courier_deleted

boolean

Courier status, deleted or not.

results[].courier_name

string

Name of the courier fulfilling the order.

results[].courier_number

string

ID of the courier fulfilling the order.

results[].customer_name

string

Customer's name.

results[].delivery_comment

string

Order delivery rating comment.

results[].delivery_lat

number

Latitude of order delivery location.

results[].delivery_lon

number

Longitude of order delivery location.

results[].delivery_not_in_interval

boolean

Indicates whether the order was completed outside of the agreed timeframe. Returns true if the order was not delivered within the specified timeframe.

results[].delivery_rating

number

Order delivery rating.

Minimum value: 1.
Maximum value: 5.

results[].depot_number

string

The unique number of the depot that handles the order.

results[].far_from_point

boolean

Indicates that items were delivered far away from the specified point. Returns true if the distance between the actual delivery point and the one specified in t