Maxuria Partner API

Product List API

Reference for partner product listing requests exposed at partner.maxuria.com/api/list.

Endpoint

POST https://partner.maxuria.com/api/list

Auth: Bearer token

Authentication

Include the partner token in the Authorization header.

Authorization: Bearer <PARTNER_API_BEARER_TOKEN>

Request Body

Field	Type	Description
start	number	Optional. Offset-style starting index. Defaults to 0.
size	number	Optional. Number of products to return. Defaults to 100 and caps at 100.
createdAfter	string	Optional. ISO date string. Returns products created on or after this date.
ids	string[]	Optional. Shopify product handles.
brands	string[]	Optional. Brand identifiers only, such as gucci or louisVuitton.
locations	string[]	Optional. LA or SH. LA includes Los Angeles and arriving-soon LA inventory.

Example

{
  "start": 0,
  "size": 100,
  "createdAfter": "2026-01-01T00:00:00Z",
  "ids": ["ab072326a0"],
  "brands": ["gucci", "louisVuitton"],
  "locations": ["LA"]
}

cURL

curl -X POST https://partner.maxuria.com/api/list \
  -H "Authorization: Bearer <PARTNER_API_BEARER_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "start": 0,
  "size": 100,
  "createdAfter": "2026-01-01T00:00:00Z",
  "ids": ["ab072326a0"],
  "brands": ["gucci", "louisVuitton"],
  "locations": ["LA"]
}'

Response

Field	Type	Description
id	string	Shopify product handle exposed as the partner product ID.
title	string	Product title.
description	string	Product description.
brand	string \| null	Brand identifier.
category	string \| null	Category identifier.
hardware	string \| null	Hardware descriptor.
colors	string[]	Color descriptors.
year	string \| null	Product year.
hermesColors	string[]	Hermes color descriptors.
hermesMaterials	string[]	Hermes material descriptors.
hermesYearStamp	string \| null	Hermes year stamp.
bagSize	string \| null	Bag size descriptor.
bagMaterials	string[]	Bag material descriptors.
bagStyles	string[]	Bag style descriptors.
accessories	string[]	Included accessory descriptors.
images	Image[]	Shopify product images.
wholesalePriceInUSD	string	Computed wholesale price in USD.
listingPriceInUSD	string	Shopify listing price in USD.
condition	string \| null	Condition descriptor.
size	object \| null	Bag dimensions in centimeters.
location	string \| null	Mapped location display name.

Example

{
  "products": [
    {
      "id": "ab072326a0",
      "title": "Gucci Bag",
      "description": "Product description",
      "brand": "gucci",
      "category": "bag",
      "hardware": "gold",
      "colors": ["black"],
      "year": "2024",
      "hermesColors": [],
      "hermesMaterials": [],
      "hermesYearStamp": null,
      "bagSize": "small",
      "bagMaterials": ["leather"],
      "bagStyles": ["shoulder"],
      "accessories": ["dustBag"],
      "images": [
        {
          "url": "https://cdn.shopify.com/...",
          "altText": "Gucci Bag",
          "width": 1200,
          "height": 1200
        }
      ],
      "wholesalePriceInUSD": "1000.00",
      "listingPriceInUSD": "1100.00",
      "condition": "excellent",
      "size": {
        "widthInCM": 30,
        "heightInCM": 22,
        "depthInCM": 16
      },
      "location": "Los Angeles"
    }
  ],
  "start": 0,
  "size": 100,
  "nextStart": 100,
  "hasNext": true
}

Errors

Status	Meaning
400	Invalid JSON or invalid list query params.
401	Missing or invalid bearer token.
500	Unexpected server or Shopify error.