Catalogue API

A read-only JSON feed of the VESTRA wholesale catalogue, for partners who want the range inside their own shop or ERP rather than in a spreadsheet. Brands, articles, size runs, colours, minimum order quantities, tiered wholesale prices in EUR, photograph URLs and a link back to each product page.

Getting a key

Keys are issued per partner to verified trade accounts, because the feed carries wholesale pricing. Write to support@vestrasales.com from the address on your account. A key looks like vsk_…. We store only a one-way hash of it, so it appears in full exactly once — at the moment it is issued. Nobody here can read it back to you afterwards; if it goes missing we revoke it and issue another.

Send it on every request:

curl -H "Authorization: Bearer vsk_your_key_here" \
  "https://vestrasales.com/api/catalog?a=whoami"

A missing or revoked key returns 401 with {"ok": false, "error": "unauthorized"}. Revocation takes effect immediately.

Endpoints

GET /api/catalog?a=products

The catalogue, paginated. Parameters, all optional:

The response carries next_page so you do not have to compute it; it is null on the last page. Walking until next_page is null is the whole of correct pagination here.

{
  "ok": true,
  "generated_at": "2026-08-27T12:40:11+00:00",
  "page": 1, "per_page": 100, "pages": 4, "total": 344,
  "next_page": 2,
  "items": [ { … } ]
}

GET /api/catalog?a=product&id=id

One article, same shape as an item above, under item. Unknown id returns 404.

GET /api/catalog?a=brands

Every brand in the catalogue with a product count — useful for building your own filter, and for checking a brand name before passing it to brand=.

GET /api/catalog?a=whoami

Confirms the key works and reports which partner it belongs to, the field list, and the same “not available” notes as above. Start here when wiring up.

The product object

Currency

Prices are always EUR here, with no conversion parameter. The website converts the shelf price for visitors outside the euro area as a reading convenience, but orders are contracted and invoiced in EUR — so a feed that quoted anything else would hand you a number your invoice will not match. Convert at your own rate, on your own schedule, in your own shop.

Rate and caching

There is no hard rate limit, and no charge for access. Responses carry Cache-Control: private, max-age=60: the catalogue does not change by the second, and a nightly full pull plus since= during the day is both gentler and more accurate than polling.

Ordering: the dropship API

The catalogue API above is read-only. Placing orders one piece at a time is a separate endpoint, /api/dropship, with its own key. It is open to verified trade partners buying for their own customers: you complete checkout and enter your customer's delivery address, and no contract of sale arises between VESTRA and that end customer. The commercial side of it — pricing rule, exclusions, availability, duties and photograph rights — is set out on the dropshipping page.

GET /api/dropship?a=list

Every article available for single-piece purchase, with its price. Ralph Lauren, Lacoste and boxershorts are excluded from dropshipping — treat this feed as the authority rather than filtering the catalogue yourself.

GET /api/dropship?a=stock&id=id

Price, the three shipping zones, and stock_tracked — which is false for catalogue articles, for the same reason the catalogue feed reports no stock. Also returns colours and sizes: the values the listing knows, for you to offer your customer. Either may be empty, which means the listing does not state them — not that none exist. shipping is keyed by zone and carries label, fee and transit_working_days for each.

POST /api/dropship?a=order

{ "id": "dsq-101211", "colour": "Black", "size": "M", "qty": 1,
  "country": "JP",
  "reference": "your-order-id",
  "customer_email": "…", "customer_name": "…" }

Returns { ok, ref, checkout_url }. Open checkout_url to pay. Your own reference is echoed back and shown on the order.

Price and shipping

The dropship price is the wholesale price of the smallest quantity tier plus 20%. Shipping is charged once per order by zone:

Transit is working days from dispatch, not calendar days, and does not include the time customs holds a consignment at destination.

Outside the EU the zone code is the destination's ISO-2 country code, so passing country is enough and zone is the same string. A country not in this table falls back to EU, whose session will then refuse that address rather than ship it at the wrong rate.

The zone is fixed before the payment session opens, and the session then accepts only that zone's countries — so the rate charged and the address entered cannot diverge.

If you need something else

CSV and XLSX exports of the same catalogue are available to signed-in trade accounts from the price list — the XLSX carries the photographs embedded next to each row. There is no XML feed and no FTP drop.