Conventions

Success envelope

Every 200 wraps the result in data, with a small meta block:

{
  "data": { /* the resource(s) */ },
  "meta": { "requestId": "0f8c…", "apiVersion": "1.0" }
}

meta.requestId — also returned as the X-Request-Id response header. Quote it in support requests.
meta.apiVersion — the REST API version (1.0).

Pagination

List endpoints accept:

limit — page size (max 50).
cursor — an opaque page token from the previous response.

and return them inside data:

{
  "data": { "purchaseOrders": [ /* … */ ], "totalCount": 128, "cursor": "3" },
  "meta": { "requestId": "…", "apiVersion": "1.0" }
}

Pass cursor back to fetch the next page. When cursor is null, you’ve reached the last page.

# page 1
curl -s -H "Authorization: Bearer $LSTK_TOKEN" \
  "https://prod.logistified.app/api/v1/purchase-orders?limit=50"
# page 2 (cursor from the previous response)
curl -s -H "Authorization: Bearer $LSTK_TOKEN" \
  "https://prod.logistified.app/api/v1/purchase-orders?limit=50&cursor=2"

Filtering

List endpoints accept query filters (e.g. status, supplierId, search, date ranges, sku). See each endpoint in the reference for its supported filters.

Methods

Only GET is supported in v1. Any other method returns 405 with Allow: GET.