Stock API

Real-time stock levels for base product variants. Stock numbers are aggregated across all fulfilment partners the allthe platform syncs from.

Base URL: https://developer.allthe.com/api/v1 Required scope: stock:read Cadence: partners typically re-sync every 15–60 minutes. See last_synced_at on each response.

Endpoints

| Method | Path | Description | | ------ | ---------------------- | -------------------------------- | | GET | /stock | Bulk stock lookup | | GET | /stock/{variantId} | Stock for a single variant |

Bulk lookup

GET /stock

Two modes of use:

By variant ids — up to 100 in a single call:

curl "https://developer.allthe.com/api/v1/stock?variant_ids=ckv1,ckv2,ckv3" \
  -H "Authorization: Bearer pat_live_..."

{
  "data": [
    {
      "variant_id": "ckv1...",
      "sku": "G6400-BLK-M",
      "available": 1847,
      "on_order":  1200,
      "last_synced_at": "2026-04-19T23:12:05.000Z"
    }
  ]
}

Paginated scan — omit variant_ids to walk all active variants:

| Name | Type | Description | | -------- | ------- | ------------------------------------------------- | | limit | integer | Page size, 1–100. Default 25. | | cursor | string | Variant id from a previous page's next_cursor. |

Response follows the standard { data, has_more, next_cursor } envelope.

Single variant

GET /stock/{variantId}

curl "https://developer.allthe.com/api/v1/stock/ckv1..." \
  -H "Authorization: Bearer pat_live_..."

{
  "variant_id": "ckv1...",
  "sku": "G6400-BLK-M",
  "available": 1847,
  "on_order":  1200,
  "last_synced_at": "2026-04-19T23:12:05.000Z"
}

Returns 404 not_found if the variant does not exist.

Notes

available is the sum across all syncing partners — treat it as an advisory signal, not a reservation.
on_order is the sum of open re-stock PO quantities reported by partners. May be null if partners do not report restocks.
last_synced_at is the most recent sync across all partners for this variant.
For reservations, place an order — order creation atomically reserves stock.