get
https://{subdomain}.myshoplaza.com/openapi/2025-06/suppliers/
Retrieves the detailed information of a specific supplier by its unique identifier (id).
Requiresread_productaccess 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:
- Retrieving specific supplier by the unique ID.
- Supporting pagination for managing large supplier datasets.
Note: The operation is scoped to a specific shop, identified by its unique domain prefix (shopdomain), ensuring all updates are applied to the correct store.
Request Parameters
Public Request Parameters
Path Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
id | string | No | Filter by specific supplier IDs | "sup_456" |
Response Description
Public Response Fields
Success Response
| Field | Type | Example | Description |
|---|---|---|---|
code | string | "success" | Response status code |
message | string | Descriptive message of the response | |
data.supplier | Supplier object |
Supplier Object
| Parameter | Type | Example | Description |
|---|---|---|---|
id | string | "sup_123" | Unique supplier identifier |
title | string | "Acme Supplies" | Name of the supplier |
url | string | "https://acme.example.com" | Supplier website URL |
created_at | string | "2025-01-01T00:00:00Z" | Creation timestamp (ISO 8601) |
updated_at | string | "2025-01-02T12:00:00Z" | Last update timestamp (ISO 8601) |
Error Response
| Field | Type | Example | Description |
|---|---|---|---|
code | string | InvalidParameter | Error http message |
message | string | `` | Error message |