Получение списка заявок исполнителей из гаража

Получение списка заявок исполнителей из гаража с пагинацией

Request

GET

https://fleet-api.taxi.yandex.net/v1/parks/contractors/applications/list

Query parameters

Name	Description
cursor	Type: string Курсор для получения следующий порции данных Example: `eyJsZWFkX2lkIjoiNTUwZTg0MDAtZTI5Yi00MWQ0LWE3MTYtNDQ2NjU1NDQwMDAwIn0=`
date_start	Type: string<date-time> Начальная дата фильтрации по времени последнего бронирования в формате ISO 8601. Параметр можно передавать только на первой странице (без cursor). Example: `2026-01-01T10:00:00Z`
limit	Type: integer Ограничение количества элементов в ответе Default: `100` Min value: `1` Max value: `100`

Headers

Name	Description
X-API-Key	Type: string API-ключ Min length: `1` Example: `<API-ключ>`
X-Client-ID	Type: string Идентификатор клиента Min length: `1` Example: `<Идентификатор клиента>`
X-Park-ID	Type: string Идентификатор партнера Example: `ee6f33c4562b4e1f8646d157bd70b2c4`
Accept-Language	Type: string Предпочитаемый язык ответа. Если не указан, используется ru. Min length: `2` Example: `ru`

Responses

200 OK

Список заявок на автомобили

Body

application/json

{
  "items": [
    {
      "lead_id": "550e8400-e29b-41d4-a716-446655440000",
      "driver_id": "33de650c6a1a40bfa78dd981817da866",
      "driver_link": "https://fleet.yandex.ru/contractors?park_id=ee6f33c4562b4e1f8646d157bd70b2c4&contractor_id=33de650c6a1a40bfa78dd981817da866",
      "driver_name": {
        "first_name": "Ivan",
        "middle_name": "Ivanovich",
        "last_name": "Ivanov"
      },
      "driver_license": "7700123456",
      "phone": "+79999999999",
      "vehicle_id": "5011ade6ba054dfdb7143c8cc9460dbc",
      "vehicle_brand": "Toyota",
      "vehicle_model": "Camry",
      "territory_id": "213",
      "territory_name": "Москва",
      "offer_link": "https://garage.yandex.ru/offer?posting_id=posting_id1&territory_id=213",
      "schema": {
        "price": "1500.0000",
        "working_days": 6,
        "non_working_days": 1
      },
      "request_type": "multiple",
      "created_at": "2023-12-15T09:00:00+03:00",
      "updated_at": "2023-12-15T14:30:00+03:00"
    }
  ],
  "cursor": "eyJsZWFkX2lkIjoiNTUwZTg0MDAtZTI5Yi00MWQ0LWE3MTYtNDQ2NjU1NDQwMDAwIn0="
}

Name

Description

items

Type: ContractorApplicationItem[]

Список заявок

Example

[
  {
    "lead_id": "550e8400-e29b-41d4-a716-446655440000",
    "driver_id": "33de650c6a1a40bfa78dd981817da866",
    "driver_link": "https://fleet.yandex.ru/contractors?park_id=ee6f33c4562b4e1f8646d157bd70b2c4&contractor_id=33de650c6a1a40bfa78dd981817da866",
    "driver_name": {
      "first_name": "Ivan",
      "middle_name": "Ivanovich",
      "last_name": "Ivanov"
    },
    "driver_license": "7700123456",
    "phone": "+79999999999",
    "vehicle_id": "5011ade6ba054dfdb7143c8cc9460dbc",
    "vehicle_brand": "Toyota",
    "vehicle_model": "Camry",
    "territory_id": "213",
    "territory_name": "Москва",
    "offer_link": "https://garage.yandex.ru/offer?posting_id=posting_id1&territory_id=213",
    "schema": {
      "price": "1500.0000",
      "working_days": 6,
      "non_working_days": 1
    },
    "request_type": "multiple",
    "created_at": "2023-12-15T09:00:00+03:00",
    "updated_at": "2023-12-15T14:30:00+03:00"
  }
]

cursor

Type: string

Курсор для получения следующей страницы

Example: eyJsZWFkX2lkIjoiNTUwZTg0MDAtZTI5Yi00MWQ0LWE3MTYtNDQ2NjU1NDQwMDAwIn0=

FirstName

Имя

Type: string

Example: Ivan

MiddleName

Отчество

Type: string

Example: Ivanovich

LastName

Фамилия

Type: string

Example: Ivanov

FullName

Полное имя водителя

Name	Description
first_name	Type: FirstName Имя Example: `Ivan`
last_name	Type: LastName Фамилия Example: `Ivanov`
middle_name	Type: MiddleName Отчество Example: `Ivanovich`

Example

{
  "first_name": "Ivan",
  "middle_name": "Ivanovich",
  "last_name": "Ivanov"
}

ContractorApplicationItem

Name

Description

lead_id

Type: string<uuid>

Идентификатор лида

Example: 550e8400-e29b-41d4-a716-446655440000

phone

Type: string

Номер телефона

Example: +79999999999

vehicle_id

Type: string

Идентификатор автомобиля

Example: 5011ade6ba054dfdb7143c8cc9460dbc

created_at

Type: string<date-time>

Дата и время создания заявки

Example: 2023-12-15T09:00:00+03:00

driver_id

Type: string

Идентификатор водителя

Example: 33de650c6a1a40bfa78dd981817da866

driver_license

Type: string

Номер водительского удостоверения

Example: 7700123456

driver_link

Type: string

Ссылка на профиль исполнителя или кандидата в Диспетчерской

Example: https://fleet.yandex.ru/contractors?park_id=ee6f33c4562b4e1f8646d157bd70b2c4&contractor_id=33de650c6a1a40bfa78dd981817da866

driver_name

Type: FullName

Полное имя водителя

Example

{
  "first_name": "Ivan",
  "middle_name": "Ivanovich",
  "last_name": "Ivanov"
}

offer_link

Type: string

Ссылка на объявление в гараже

Example: https://garage.yandex.ru/offer?posting_id=posting_id1&territory_id=213

request_type

Type: string

Тип заявки: phonecall - создана по телефонному звонку, multiple - мультибронирование

Enum: phonecall, multiple

schema

Type: object

non_working_days

Type: integer

Количество дней когда авто не сдается в аренду

price

Type: string

Стоимость аренды в сутки

Pattern: ^[0-9]+(\.[0-9]{1,4})?$

Example: 1500.0000

working_days

Type: integer

Количество дней когда авто сдается в аренду

Схема аренды

Example

{
  "price": "1500.0000",
  "working_days": 6,
  "non_working_days": 1
}

territory_id

Type: string

Идентификатор локации

Example: 213

territory_name

Type: string

Название локации

Example: Москва

updated_at

Type: string<date-time>

Дата и время обновления заявки

Example: 2023-12-15T14:30:00+03:00

vehicle_brand

Type: string

Марка автомобиля

Example: Toyota

vehicle_model

Type: string

Модель автомобиля

Example: Camry

Example

{
  "lead_id": "550e8400-e29b-41d4-a716-446655440000",
  "driver_id": "33de650c6a1a40bfa78dd981817da866",
  "driver_link": "https://fleet.yandex.ru/contractors?park_id=ee6f33c4562b4e1f8646d157bd70b2c4&contractor_id=33de650c6a1a40bfa78dd981817da866",
  "driver_name": {
    "first_name": "Ivan",
    "middle_name": "Ivanovich",
    "last_name": "Ivanov"
  },
  "driver_license": "7700123456",
  "phone": "+79999999999",
  "vehicle_id": "5011ade6ba054dfdb7143c8cc9460dbc",
  "vehicle_brand": "Toyota",
  "vehicle_model": "Camry",
  "territory_id": "213",
  "territory_name": "Москва",
  "offer_link": "https://garage.yandex.ru/offer?posting_id=posting_id1&territory_id=213",
  "schema": {
    "price": "1500.0000",
    "working_days": 6,
    "non_working_days": 1
  },
  "request_type": "multiple",
  "created_at": "2023-12-15T09:00:00+03:00",
  "updated_at": "2023-12-15T14:30:00+03:00"
}

400 Bad Request

Некорректные параметры запроса

Body

application/json

{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

401 Unauthorized

Отсутствуют параметры авторизации запроса

Body

application/json

{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

403 Forbidden

Недостаточно прав для выполнения запроса

Body

application/json

{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

429 Too Many Requests

Превышено допустимое число запросов

Body

application/json

{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

500 Internal Server Error

Внутренняя ошибка сервера

Body

application/json

{
  "code": "example",
  "message": "Текстовое описание ошибки"
}

Name

Description

message

Type: string

Человекочитаемое сообщение об ошибке

Example: Текстовое описание ошибки

code

Type: string

Машиночитаемый код ошибки

Example: example

Была ли статья полезна?

Получение баланса и заблокированного баланса водителя

Получение списка условий работы