Get courier settings list

GET/api/crm/v2/couriers_listv2

operationId: couriersList.default

Authorization

api-token + language + role

Query parameters

branch_idintegerrequired

Example: 1

Responses

object

statusstringrequired

Values:successerror

Example: success

dataobject

filtersobject

branch_idobject (FilterSelectInteger)

valueinteger

Example: 8920

typestringrequired

Example: select

optionarray of object

valueintegerrequired

Example: 8920

namestringrequired

Example: Green Basket | Kaliningrad

modestring (FilterMode)

How the interface handles the filter; a regular filter does not have mode.
force_shown — always displayed, cannot be hidden.
value_required — entry point to the section: always displayed, cannot have an empty value (until a value is selected, the list is empty; there is no "all" option), global reset does not clear it.

Values:force_shownvalue_required

Example: value_required

settingsobject

distribution_methodstringrequired

Values:manuallyautomatically

Example: manually

independencebooleanrequired

Example: true

listarray of object

idintegerrequired

Example: 1

namestringrequired

Example: example

firm_user_idinteger

Example: 1

districts_idsarray of integer

curl -X GET 'https://foodsoul.ru/api/crm/v2/couriers_list?branch_id=1' \
  -H 'Authorization: Bearer fs_api_YOUR_TOKEN' \
  -H 'language: en' \
  -H 'role: partner'

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://foodsoul.ru/api/crm/v2/couriers_list?branch_id=1', [
    'headers' => [
        'Authorization' => 'Bearer fs_api_YOUR_TOKEN',
        'language' => 'en',
        'role' => 'partner',
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch("https://foodsoul.ru/api/crm/v2/couriers_list?branch_id=1", {
    method: "GET",
    headers: {
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "en",
        "role": "partner"
    },
})
const data = await response.json()

import requests

response = requests.request(
    "GET",
    "https://foodsoul.ru/api/crm/v2/couriers_list?branch_id=1",
    headers={
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "en",
        "role": "partner",
    },
)
data = response.json()

Response 200

{
  "status": "success",
  "data": {
    "filters": {
      "branch_id": {
        "value": 8920,
        "type": "select",
        "option": [
          {
            "value": 8920,
            "name": "Green Basket | Kaliningrad"
          }
        ],
        "mode": "value_required"
      }
    },
    "settings": {
      "distribution_method": "manually",
      "independence": true
    },
    "list": [
      {
        "id": 1,
        "name": "example",
        "firm_user_id": 1,
        "districts_ids": [
          1
        ]
      }
    ]
  }
}

Requests are sent to foodsoul.ru — the host of this portal; you cannot choose another one.