Список покупателей

GET https://mrp.zolotenkov.ru/api/external/v1/customers

Требуемое право ключа: read:sales

Карточки покупателей постранично, по курсору. Поле id каждой записи — тот самый customer_id, который требует тело POST /sales-orders. Фильтр search находит контрагента по названию, ИНН или адресу электронной почты, не обходя справочник целиком.

Параметры запроса

limit целое число необязателен

Сколько записей вернуть: от 1 до 200, по умолчанию 50
cursor строка необязателен

Курсор из поля next_cursor предыдущего ответа. Без него чтение начинается сначала
search строка необязателен

Подстрока названия покупателя, его ИНН или адреса электронной почты, без учета регистра. Пустая строка и строка из пробелов фильтром не считаются

Ответы

200 Страница списка покупателей
400 Недопустимое значение фильтра или курсора
401 Ключ не передан, недействителен или отозван
403 У ключа нет права read:sales
429 Превышена частота обращений. Задержка до повтора — в заголовке Retry-After

const response = await fetch("https://mrp.zolotenkov.ru/api/external/v1/customers?limit=1", { method: "GET", headers: { "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", }, }); const data = await response.json();

import requests response = requests.get( "https://mrp.zolotenkov.ru/api/external/v1/customers?limit=1", headers={ "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", }, timeout=30, ) response.raise_for_status() print(response.json())

<?php $curl = curl_init('https://mrp.zolotenkov.ru/api/external/v1/customers?limit=1'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'GET', CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ", "Accept: application/json", ], ]); $response = curl_exec($curl); var_dump(json_decode($response, true));

{ "data": [ { "address": "Москва, ул. Складская, 3", "bill_to_address": "119021, Москва, ул. Льва Толстого, 16", "country_code": "RU", "created_at": "2026-08-01T09:00:00Z", "currency": "RUB", "email": "zakaz@example.ru", "first_name": "Иван", "id": "42", "inn": "7701234567", "kpp": "770101001", "last_name": "Петров", "legal_name": "Общество с ограниченной ответственностью «Ромашка»", "notes": "Отгрузка по вторникам", "ogrn": "1027700132195", "phone": "+7 495 123-45-67", "title": "ООО «Ромашка»", "updated_at": "2026-08-01T09:00:00Z" } ], "next_cursor": "eyJpZCI6NDJ9" }