List suppliers

GET 
/openapi/2026-07/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

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

Schema

codestring

error code

messagestring

error message

data object

suppliers object[]

List of supplier objects

Array [

iduint64

Supplier ID

titlestring

Name of the supplier

urlstring

URL associated with the supplier

created_atstring

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

updated_atstring

Timestamp when the supplier was last updated, in ISO-8601 format

]

cursorstring

The cursor for the next page of results

has_moreboolean

Whether there are more records

Example

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