List promo code suppliers

Returns supplier directory for creating incoming documents and filtering reports.

Why this method exists

Returns supplier directory for creating incoming documents and filtering reports.

When to use

Suppliers tab, incoming create form, import mask setup.

Endpoint

POST /v1/internal/promo-code-suppliers/list

Authentication: JWT via Authorization: Bearer <token>. User must have project access and inventory_promo_codes permission.

Permission: inventory_promo_codes.view

Request example

{
  "meta": { "requestId": "optional-uuid" },
  "data": { "projectId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "page": 1, "pageSize": 50, "search": "промомед", "isActive": true }
}

Response example

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "c219ef09-ae2f-4d08-af11-7cd51006fae4",
        "name": "Промомед",
        "legalName": "АО Промомед",
        "inn": "7701234567",
        "isActive": true,
        "defaultMaskId": "uuid-маски",
        "ingestEmailsCount": 2
      }
    ],
    "page": 1,
    "pageSize": 50,
    "totalCount": 8
  }
}

Errors

UNAUTHORIZED / ACCESS_DENIED — access denied
VALIDATION_ERROR — invalid body
NOT_FOUND — resource not found
RATE_LIMIT_EXCEEDED (429) — rate limit

cURL

curl -X POST "https://api-external.promanta.ru/v1/internal/promo-code-suppliers/list" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT" \
  -d '{"data": { "projectId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "page": 1, "pageSize": 50, "search": "промомед", "isActive": true }}'