Skip to main content
POST
/
merchant
/
product
/
list
Get Product List
curl --request POST \
  --url https://api.unibee.dev/merchant/product/list \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "count": 123,
  "page": 123,
  "sortField": "<string>",
  "sortType": "<string>",
  "status": [
    123
  ]
}
'
{
  "code": 123,
  "data": {
    "products": [
      {
        "createTime": 123,
        "description": "<string>",
        "homeUrl": "<string>",
        "id": 123,
        "imageUrl": "<string>",
        "isDeleted": 123,
        "merchantId": 123,
        "metaData": "<string>",
        "productName": "<string>",
        "status": 123,
        "usVATConfig": {
          "active": true,
          "fromAddress": {
            "address": "<string>",
            "city": "<string>",
            "countryCode": "<string>",
            "state": "<string>",
            "verified": true,
            "zipCode": "<string>"
          },
          "nexusAddresses": [
            {
              "address": "<string>",
              "city": "<string>",
              "countryCode": "<string>",
              "state": "<string>",
              "verified": true,
              "zipCode": "<string>"
            }
          ],
          "sellOnUSOnly": true,
          "taxCode": "<string>",
          "toAddress": {
            "address": "<string>",
            "city": "<string>",
            "countryCode": "<string>",
            "state": "<string>",
            "verified": true,
            "zipCode": "<string>"
          }
        }
      }
    ],
    "total": 123
  },
  "merchantId": 123,
  "message": "<string>",
  "redirect": "<string>",
  "requestId": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.unibee.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoint Overview

POST https://api.unibee.dev/merchant/product/list Get Product List

​
Authorization

All UniBee Merchant API requests require authentication via API key.
HeaderRequiredDescription
AuthorizationYesBearer <your_api_key>
Content-TypeYesapplication/json (for request body)

​
Parameters

Parameters for this endpoint are listed below. The schema is also shown in the Try it panel.

​
Request body

NameTypeRequiredDescription
countintegerNoCount Of Per Page
pageintegerNoPage, Start 0
sortFieldstringNoSort Field，id|create_time|gmt_modify，Default id
sortTypestringNoSort Type，asc|desc，Default desc
statusarrayNoFilter, Default All，,Status，1-active，2-inactive

​
Request examples

​
cURL

curl -X POST "https://api.unibee.dev/merchant/product/list" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "count": 0,
  "page": 0,
  "sortField": "",
  "sortType": "",
  "status": []
}'

​
Sandbox

curl -X POST "https://api-sandbox.unibee.top/merchant/product/list" \
  -H "Authorization: Bearer YOUR_SANDBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "count": 0,
  "page": 0,
  "sortField": "",
  "sortType": "",
  "status": []
}'

​
Response

Success responses return a JSON envelope with code, data, message, redirect, and requestId. code 0 indicates success.
FieldTypeDescription
codeintegerResponse code. 0 = success
dataobjectResponse payload
data.productsarrayProduct Object List
data.totalintegerTotal
messagestringHuman-readable message
requestIdstringRequest ID for support

​
Error handling

HTTP statusMeaning
400Bad request — invalid or missing parameters. Check message in the body.
401Unauthorized — missing or invalid API key.
404Not found — invalid path or resource.
500Server error — retry with backoff.
When code in the response body is non-zero, check message for details. Use requestId when contacting support.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
count
integer<int>

Count Of Per Page

​
page
integer<int>

Page, Start 0

​
sortField
string<string>

Sort Field，id|create_time|gmt_modify，Default id

​
sortType
string<string>

Sort Type，asc|desc，Default desc

​
status
integer<int>[]

Filter, Default All，,Status，1-active，2-inactive

Response

200 - application/json
​
code
integer<int>
​
data
object
​
merchantId
integer<int64>
​
message
string<string>
​
redirect
string<string>
​
requestId
string<string>