Getting a list of contractor applications from the garage
Eats courier and Platform profile creation
Request
POST
https://fleet-api.taxi.yandex.net/v1/performer/create
Headers
|
Name |
Description |
|
Accept-Language |
Type: string Preferred language of the response Min length: Example: |
|
X-API-Key |
Type: string API-key Min length: Example: |
|
X-Client-ID |
Type: string Client ID Min length: Example: |
|
X-Idempotency-Token |
Type: string Idempotent request token. Must contain only printable ASCII characters Min length: Max length: Example: |
|
X-Park-ID |
Type: string Partner ID Example: |
Body
application/json
{
"last_name": " Ivanov ",
"first_name": " Ivan ",
"middle_name": " Ivanovich ",
"phone": "+79999999999",
"region_geobase_id": 1,
"birth_date": "1990-01-01",
"registration_address": " Mira Street, 1 ",
"instant_payments_id": "550e8400-e29b-41d4-a716-446655440000",
"work_rule_id": "bc43tre6ba054dfdb7143ckfgvcby63e",
"citizenship_code2": "RU",
"employment_type": "park_direct",
"tax_identification_number": "1234567890"
}
|
Name |
Description |
|
birth_date |
Type: string<date> Date of birth Example: |
|
first_name |
Type: string Name Min length: Example: |
|
last_name |
Type: string Last name Min length: Example: |
|
phone |
Type: string Phone number; for Russia - must be registered in My Tax Min length: Example: |
|
region_geobase_id |
Type: integer City identifier in the geobase hierarchy |
|
citizenship_code2 |
Type: string Country code in ISO 3166-1 alpha-2 format Pattern: Example: |
|
employment_type |
Type: string Employment type. Can be park_direct (park direct staff) or courier_service (courier service employee in Fleet terms) Enum: |
|
instant_payments_id |
Type: string<uuid> Instant payout rule identifier assigned to the courier. If not specified, the default rule configured for the partner is applied, if available Example: |
|
middle_name |
Type: string Second name Min length: Example: |
|
registration_address |
Type: string Registration address. Required for Russia or when employment_type = park_direct in Kazakhstan Min length: Example: |
|
tax_identification_number |
Type: string Courier's tax identification number in registration country. Required based on country and employment type Min length: Example: |
|
work_rule_id |
Type: string Work condition identifier assigned to the courier. Value can be obtained via partner's work conditions list retrieval method Min length: Example: |
Responses
200 OK
Data of the created profile
Body
application/json
{
"park_id": "ee6f33c4562b4e1f8646d157bd70b2c4",
"contractor_id": "9b17db0cb1f24a38a5c3c8b4f6e4f63b",
"polling_settings": {
"polling_interval_ms": 0,
"polling_timeout_sec": 0
}
}
|
Name |
Description |
||||
|
contractor_id |
Type: string Platform profile identifier Example: |
||||
|
park_id |
Type: string Park profile identifier Example: |
||||
|
polling_settings |
Type: object
Polling settings Example
|
400 Bad Request
Invalid request parameters
Body
application/json
{
"code": "example",
"message": "Textual description of the error"
}
|
Name |
Description |
|
message |
Type: string Human-readable error message Example: |
|
code |
Type: string Machine-readable error code Example: |
422 Unprocessable Entity
Invalid request parameters
Body
application/json
{
"code": "example",
"message": "Textual description of the error"
}
|
Name |
Description |
|
message |
Type: string Human-readable error message Example: |
|
code |
Type: string Machine-readable error code Example: |