Stockagile REST API

A JSON API for reading and writing inventory data across your stores. Connect your ERP, POS, and ecommerce platforms to a single authoritative source of stock levels.

Base URL

https://api.stockaglie.com/v1

All requests require an Authorization: Bearer <token> header. Tokens are issued per workspace from your account settings. Responses are JSON; errors follow RFC 7807.

Endpoints

Core resources

GET /inventory

Returns stock levels for all SKUs across all locations. Supports filtering by location, category, and SKU prefix.

location_id category sku_prefix page per_page

GET /inventory/{sku}

Returns the full stock record for a single SKU across all locations, including reorder point, safety stock, and last-updated timestamp.

sku location_id

POST /inventory/adjustments

Submit a stock adjustment for one or more SKUs. Each entry requires a SKU, location ID, delta quantity, and adjustment reason.

sku location_id delta reason

GET /locations

Lists all store and warehouse locations in your workspace, including their IDs, names, and operational status.

active_only

GET /replenishment/suggestions

Returns the current reorder suggestion list generated by the forecasting engine. Each item includes suggested order quantity and estimated days to stockout.

location_id urgency supplier_id

POST /webhooks

Register a webhook endpoint to receive real-time notifications when stock levels cross reorder thresholds or adjustments are posted by another integration.

url events[] secret

Quick start

Your first API call in 60 seconds

Retrieve your current inventory across all locations with a single request. Replace YOUR_TOKEN with the Bearer token from your account settings.

curl -X GET \
  https://api.stockaglie.com/v1/inventory \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

The response is a paginated JSON array. Each record includes sku, location_id, quantity_on_hand, quantity_reserved, and reorder_point.

{
  "data": [
    {
      "sku": "SKU-00124",
      "location_id": "loc_madrid_retiro",
      "quantity_on_hand": 48,
      "quantity_reserved": 3,
      "reorder_point": 15,
      "updated_at": "2026-08-15T09:12:33Z"
    }
  ],
  "meta": {
    "total": 842,
    "page": 1,
    "per_page": 50
  }
}

Need help?

API access is available on Growth and Scale plans

If you are evaluating the API for a technical integration, our team can walk you through the authentication flow and data model on a short call.

See plans Talk to the team