List Suppliers

🔒

Requires read_product access scope. More access scope

The List Suppliers API allows users to retrieve a list of suppliers with optional filtering by specific supplier IDs. The API supports pagination to handle large datasets and returns detailed information about suppliers, including their metadata.This API is especially useful for:

  1. Fetching a list of suppliers for inventory and procurement purposes.
  2. Retrieving specific suppliers by their unique IDs.
  3. Supporting pagination for managing large supplier datasets.

Request Parameters

Public Request Parameters

📘

Public Request Parameters

Query Parameters

ParameterTypeRequiredExampleDescription
idsarray of stringsNo["382453603865993516"]A list of supplier IDs to filter results. Empty value retrieves all suppliers.
pageint32No1Page number of results to retrieve, starting from 1. Must be a positive integer.
limitint32No10Maximum number of results per page. Acceptable range: 1 to 100.

Response Explanation

Public Response Parameters

📘

Public Response Parameters

Success Response

FieldTypeExampleDescription
suppliersarrayList of supplier objects.
suppliers.idstring"382453603865993516"Unique identifier of the supplier.
suppliers.titlestring"example supplier"Name of the supplier.
suppliers.urlstring"https://shoplazza.com"URL associated with the supplier.
suppliers.created_atstring"2024-05-21T08:54:05Z"Timestamp when the supplier was created.
suppliers.updated_atstring"2024-05-21T08:54:05Z"Timestamp when the supplier was last updated.
countint1Total number of suppliers retrieved.

Error Response

Error responses in the API can be represented using two different fields: errors and error. Both fields provide details about issues encountered during request processing. Below is an explanation of the fields with their respective examples and descriptions.

FieldTypeExampleDescription
errorsArray[ "Duplicated supplier name"]A list of errors encountered during the request processing.
FieldTypeExampleDescription
errorArray "store is not active"Indicates an error encountered during the process.

Error Details

Status CodeError MessagePossible CauseExample Response
400Bad RequestThe request contains invalid input or is missing required fields.
UnauthorizedThe request is missing valid authentication credentials or the credentials provided are invalid.

API Structure Overview

Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!