Endpoint
All requests use a single endpoint:Actions
Quick start
Health check
List specific SKUs
Paginate all SKUs
Example response
Field reference
Learn what each response field means and how regions map to currencies.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Server-to-server inventory for external integrations.
POST https://api.keystoneb2b.io/v1/inventory
Authorization: Bearer <api_key>
Content-Type: application/json
| Action | Auth required | Purpose |
|---|---|---|
health | Yes | Verify the service is reachable and the API key is valid |
list | Yes | Fetch inventory for all or specific SKUs |
curl -s https://api.keystoneb2b.io/v1/inventory \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"action":"health"}'
{
"success": true,
"service": "inventory-truth-api",
"timestamp": "2026-06-16T12:00:00.000Z"
}
curl -s https://api.keystoneb2b.io/v1/inventory \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"action":"list","skus":["E-CC26-01"]}'
{
"action": "list",
"limit": 500,
"offset": 0
}
| Parameter | Notes |
|---|---|
limit | Optional. Default 100, maximum 500 |
offset | Optional. Default 0 |
skus | Optional. Array of SKU strings, max 200 per request |
{
"success": true,
"data": [
{
"sku": "E-CC26-01",
"immediate_inventory": { "usa": 118, "canada": 0 },
"future_inventory": {
"usa": [
{ "expected_date": "2026-03-22", "quantity": 1396 },
{ "expected_date": "2026-06-27", "quantity": 50 },
{ "expected_date": "2026-08-06", "quantity": 492 }
],
"canada": [
{ "expected_date": "2026-06-26", "quantity": 10 }
]
},
"refreshed_at": "2026-06-16T02:56:04.608992+00:00"
}
],
"limit": 100,
"offset": 0
}
