**Version: 202601**

# List suppliers

**GET** `/openapi/2026-01/suppliers`

Allows users to retrieve a list of suppliers with optional filtering by specific supplier IDs.

## Request

**Query Parameters**

- `cursor` string

  Cursor for pagination
- `page_size` int32

  Maximum number of results per page. Acceptable range: 1 to 100. Default is 10
- `page` int32

  Page number (1-based). Mutually exclusive with cursor
- `ids` uint64[]

  A list of supplier IDs to filter results. Empty value retrieves all suppliers. Example: ?ids=1001&ids=1002

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `suppliers` object[]

    List of supplier objects

    *   Array \[

    - `id` uint64

      Supplier ID
    - `title` string

      Name of the supplier
    - `url` string

      URL associated with the supplier
    - `created_at` string

      Timestamp when the supplier was created, in ISO-8601 format
    - `updated_at` string

      Timestamp when the supplier was last updated, in ISO-8601 format
    *   \]
  - `cursor` string

    The cursor for the next page of results
  - `has_more` boolean

    Whether there are more records
  - `total` int32

    Total number of records across all pages (for page-mode pagination)

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "suppliers": [
      {
        "id": 0,
        "title": "string",
        "url": "string",
        "created_at": "string",
        "updated_at": "string"
      }
    ],
    "cursor": "string",
    "has_more": true,
    "total": 0
  }
}
```