Grey LanternAPI

Partner API · v2

Our catalogue, by request.

A small, read-only JSON API for stockists and design studios who want live product data and batch availability in their own systems.

Basics

All requests go over HTTPS to the /v2 base path on this host. Responses are JSON, UTF-8, with prices in minor units (cents). Every partner receives a personal key from the trade desk; send it in the Authorization header.

# every request
Authorization: Bearer <partner-key>
Accept: application/json

Limits are deliberately modest: 60 requests per minute per key. Product data changes a few times a week, so caching for an hour is perfectly fine.

Endpoints

GET/v2/products

Lists every lamp in the current collection, including finishes and fittings.

  • family — optional: halden, ostra or pell
  • page — page number, 25 items per page
{
  "items": [{
    "sku": "GL-HAL-38-BR",
    "name": "Halden pendant",
    "finish": "raw brass",
    "diameter_mm": 380,
    "lamp_base": "E27",
    "trade_price": 41500
  }],
  "page": 1, "pages": 1
}

GET/v2/batches

Shows open production batches: which week each batch leaves the bench and how many of its twelve slots are still free.

{ "batch": "2026-44-PELL", "ships_week": "2026-W47", "slots_free": 5 }

GET/v2/orders/{reference}

Returns the status of one of your own trade orders: queued, on_bench, burn_test, packed or shipped.

{ "reference": "TR-10482", "status": "burn_test", "updated": "2026-10-21" }

There are no write endpoints. Orders are still placed with a person at the trade desk.

Status

All endpoints operational
Current version
v2.3
v1 retired
March 2026
Questions
trade@greylanternco.com