Developers

Inventrackr API & webhooks

Read and update a storage’s products from your shop system, spreadsheets or scripts, and get a signed HTTPS request whenever products or suppliers change. Available to storages whose owner is on Inventrackr Pro.

Base URL
https://api-production-c3ca.up.railway.app/api/v1
Auth
Authorization: Bearer itk_live_…
Format
JSON over HTTPS
On this page

Overview

The API is a small REST API under https://api-production-c3ca.up.railway.app/api/v1. Each API key belongs to one storage and can only see and change that storage: its products (called items in the API) and suppliers. To work with several storages, create a key in each.

  • Read products and suppliers, or only what changed since a point in time.
  • Write new products and stock changes (absolute counts or +/− adjustments).
  • Webhooks tell your server about product, stock and supplier changes made anywhere: the web, the iPhone and Android apps, CSV import or the API.

API keys and webhooks are part of Inventrackr Pro. Only the storage owner can create them, and they work while the owner’s plan is Pro. Changes made through the API appear in the storage’s activity history as “API key name”, and team members see them live like any other change.

Quick start

  1. In the Inventrackr web app, open the storage, then Storage settings → Integrations (storage owners only).
  2. Under API keys, enter a name (for example “Shop till sync”), choose Read only or Read & write, and select Create key.
  3. Copy the key right away. It starts with itk_live_ and is shown only once: Inventrackr stores just a hash of it.
  4. Call the API with the key in the Authorization header:
List the first 100 items
curl "https://api-production-c3ca.up.railway.app/api/v1/items?limit=100" \
  -H "Authorization: Bearer $INVENTRACKR_API_KEY"

The response is a page of items plus a cursor for the next page:

200 OK
{
  "items": [
    {
      "id": "3f6c2a8e-6b1d-4c1e-9a52-2d8f0c7b9e10",
      "name": "Espresso beans",
      "description": "House blend, 1 kg bags",
      "barcode": "8714789120045",
      "quantity": 3.5,
      "minimumQuantity": 5,
      "unit": "kg",
      "priceCents": 1899,
      "supplierId": "9b2e7c44-1f0a-4d3b-8e6f-5a1c2d3e4f50",
      "supplierName": "Roastery Co.",
      "hasImage": false,
      "imageVersion": 0,
      "version": 7,
      "createdAt": "2026-10-02T14:05:11.482Z",
      "updatedAt": "2026-11-18T09:31:27.103Z",
      "stockStatus": "lowStock"
    }
  ],
  "nextCursor": "WyIyMDI2LTExLTE4IDA5OjMxOjI3LjEwMyswMCIsIjNmNmMyYThlLTZiMWQtNGMxZS05YTUyLTJkOGYwYzdiOWUxMCJd"
}

Authentication

Send the key as a bearer token on every request:

HTTP
Authorization: Bearer itk_live_…
API key scopes
AccessCan call
Read only (read)GET /items, GET /items/{id}, GET /suppliers
Read & write (write)Everything above, plus POST /items and PATCH /items/{id}/quantity
  • Keys look like itk_live_ followed by 32 URL-safe characters. The app lists each key by name, its first characters, when it was created and when it was last used.
  • Revoking a key in the app takes effect immediately; a write still in progress when the key is revoked is refused.
  • A missing, malformed or revoked key gets 401 API_KEY_INVALID. If the storage owner’s Pro plan has ended, every key of the storage gets 401 PLAN_REQUIRED until Pro is active again; the keys themselves are kept.
  • A read-only key calling a write endpoint gets 403 INSUFFICIENT_SCOPE.

Rate limits

Rate limits
LimitApplies to
120 requests per minuteEach API key
600 requests per minuteEach client IP address (IPv6: per /64), counting every /api/v1 request, including ones with invalid keys

Limits use fixed one-minute windows. Over a limit, the API answers 429 Too Many Requests with a Retry-After header giving the seconds until the window resets. Wait that long before retrying. The 429 body is {"error": "Too many attempts. Please wait a moment and try again."} (it has no code field).

The API can also answer 503 with Retry-After: 1 when a change collided with another change at the same moment; it’s safe to retry. A page of up to 500 items counts as one request, so prefer large pages to many small ones.

Errors

Errors are JSON with a human-readable error message and, for most API-specific errors, a stable machine-readable code. Branch on the status and code, never on the message text.

401 Unauthorized
{
  "error": "This API key is invalid or was revoked",
  "code": "API_KEY_INVALID"
}
Error responses
StatuscodeWhen
400(none)The body or query failed validation. The response has "error": "Invalid request" and a details array (see below).
400INVALID_CURSORThe cursor parameter isn’t one the API returned.
400(none)An {id} in the path isn’t a UUID ("Invalid identifier"), the JSON is malformed, or text contains invalid Unicode (lone surrogates).
401API_KEY_INVALIDNo key, a malformed key, or a revoked key.
401PLAN_REQUIREDThe storage owner’s plan isn’t Pro (anymore).
403INSUFFICIENT_SCOPEA read-only key called a write endpoint.
404NOT_FOUNDThe item doesn’t exist in this key’s storage, or the path doesn’t exist.
409STOCK_CHANGEDThe stock no longer equals the expectedQuantity you sent.
409REFERENCE_REMOVEDSomething the change refers to (such as the supplier) was deleted at the same moment. Re-read and retry.
413(none)The request body is larger than 256 KB.
429(none)Rate limit exceeded. See Retry-After.
503(none)A conflicting change happened at the same time. Retry after Retry-After seconds.
500(none)Unexpected server error. Retry with backoff; contact support if it persists.

Validation errors list each problem with its path in the request:

400 Bad Request
{
  "error": "Invalid request",
  "details": [
    {
      "origin": "string",
      "code": "too_small",
      "minimum": 1,
      "inclusive": true,
      "path": [
        "name"
      ],
      "message": "Too small: expected string to have >=1 characters"
    },
    {
      "code": "custom",
      "path": [
        "quantity"
      ],
      "message": "Use at most 3 decimal places"
    }
  ]
}

Pagination & syncing

GET /items returns items ordered by updatedAt (oldest first, ties broken by id), so you can page through everything or only what changed. Pass limit (1–500, default 100). When there are more items, the response’s nextCursor is a string: send it back as cursor (with the same other parameters) to get the next page. On the last page nextCursor is null. Cursors are opaque; don’t build or modify them.

Next page
curl "https://api-production-c3ca.up.railway.app/api/v1/items?limit=500&cursor=WyIyMDI2LTExLTE4IDA5OjMx…" \
  -H "Authorization: Bearer $INVENTRACKR_API_KEY"

To keep a copy in sync, remember the largest updatedAt you have seen and next time ask for updatedSince that value. updatedSince is inclusive (items updated at or after it), so you’ll see the last item again: upsert by id and use version to skip what you already have. The value must be an ISO 8601 date-time with Z or an offset; URL-encode a + offset as %2B.

Changes since your last sync
curl "https://api-production-c3ca.up.railway.app/api/v1/items?updatedSince=2026-11-18T09:31:27.103Z&limit=500" \
  -H "Authorization: Bearer $INVENTRACKR_API_KEY"

Objects

Timestamps are ISO 8601 strings in UTC. IDs are lowercase UUIDs.

Item

Item fields
FieldTypeDescription
idstring (UUID)The item’s ID.
namestringUp to 160 characters.
descriptionstringUp to 4,000 characters; empty string when not set.
barcodestringUp to 120 characters; empty string when not set. Not required to be unique.
quantitynumberCurrent stock, ≥ 0, up to 3 decimal places.
minimumQuantitynumberThe “low stock at” level, ≥ 0, up to 3 decimal places.
unitstringOne of each, pack, box, case, roll, ml, l, g, kg, oz, lb, fl_oz, gal, cm, m, in, ft.
priceCentsintegerUnit price in the smallest currency unit (cents) of the storage’s currency, which is set in the app.
supplierIdstring (UUID) | nullThe item’s supplier, if any.
supplierNamestring | nullThat supplier’s name.
hasImagebooleanWhether the item has a photo (photos aren’t available through the API).
imageVersionintegerChanges when the photo changes.
versionintegerIncreases by one with every change to the item.
createdAtstring (date-time)When the item was created.
updatedAtstring (date-time)When the item last changed.
stockStatusstringoutOfStock when quantity is 0, lowStock when quantity ≤ minimumQuantity, else inStock.
Item
{
  "id": "3f6c2a8e-6b1d-4c1e-9a52-2d8f0c7b9e10",
  "name": "Espresso beans",
  "description": "House blend, 1 kg bags",
  "barcode": "8714789120045",
  "quantity": 3.5,
  "minimumQuantity": 5,
  "unit": "kg",
  "priceCents": 1899,
  "supplierId": "9b2e7c44-1f0a-4d3b-8e6f-5a1c2d3e4f50",
  "supplierName": "Roastery Co.",
  "hasImage": false,
  "imageVersion": 0,
  "version": 7,
  "createdAt": "2026-10-02T14:05:11.482Z",
  "updatedAt": "2026-11-18T09:31:27.103Z",
  "stockStatus": "lowStock"
}

Supplier

Supplier fields
FieldTypeDescription
idstring (UUID)The supplier’s ID.
namestringThe supplier’s name.
contactNamestringEmpty string when not set.
contactEmailstringEmpty string when not set.
contactPhonestringEmpty string when not set.
createdAtstring (date-time)When the supplier was added.
Supplier
{
  "id": "9b2e7c44-1f0a-4d3b-8e6f-5a1c2d3e4f50",
  "name": "Roastery Co.",
  "contactName": "Sam Rivera",
  "contactEmail": "orders@roastery.example",
  "contactPhone": "+1 555 0100",
  "createdAt": "2026-09-14T08:12:40.019Z"
}

Endpoints

List items

GET/api/v1/itemsRead or write key

Query parameters
ParameterTypeDescription
limitinteger, 1–500Items per page. Default 100.
cursorstringThe nextCursor from the previous page.
updatedSincedate-timeOnly items whose updatedAt is at or after this moment, e.g. 2026-11-01T00:00:00Z.
Shell
curl "https://api-production-c3ca.up.railway.app/api/v1/items?limit=100" \
  -H "Authorization: Bearer $INVENTRACKR_API_KEY"

Returns 200 with { "items": [Item, …], "nextCursor": string | null }.

Get an item

GET/api/v1/items/{id}Read or write key

Shell
curl "https://api-production-c3ca.up.railway.app/api/v1/items/3f6c2a8e-6b1d-4c1e-9a52-2d8f0c7b9e10" \
  -H "Authorization: Bearer $INVENTRACKR_API_KEY"

Returns 200 with an Item, or 404 NOT_FOUND.

List suppliers

GET/api/v1/suppliersRead or write key

Shell
curl "https://api-production-c3ca.up.railway.app/api/v1/suppliers" \
  -H "Authorization: Bearer $INVENTRACKR_API_KEY"

Returns 200 with an array of all of the storage’s suppliers, sorted by name (not paged).

200 OK
[
  {
    "id": "9b2e7c44-1f0a-4d3b-8e6f-5a1c2d3e4f50",
    "name": "Roastery Co.",
    "contactName": "Sam Rivera",
    "contactEmail": "orders@roastery.example",
    "contactPhone": "+1 555 0100",
    "createdAt": "2026-09-14T08:12:40.019Z"
  }
]

Create an item

POST/api/v1/itemsWrite key

Request body
FieldTypeRules
namestring, required1–160 characters after trimming spaces.
descriptionstringUp to 4,000 characters. Default empty.
barcodestringUp to 120 characters after trimming. Default empty.
quantitynumber0 to 999,999,999,999, at most 3 decimals. Default 0.
minimumQuantitynumberSame rules as quantity. Default 0.
unitstringOne of the units. Default each.
priceCentsinteger0 to 2,147,483,647. Default 0.
supplierIdstring (UUID) | nullA supplier of this storage. An ID that isn’t one of the storage’s suppliers is ignored (the item is created without a supplier).
Shell
curl -X POST "https://api-production-c3ca.up.railway.app/api/v1/items" \
  -H "Authorization: Bearer $INVENTRACKR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Espresso beans",
    "barcode": "8714789120045",
    "quantity": 12,
    "minimumQuantity": 5,
    "unit": "kg",
    "priceCents": 1899,
    "supplierId": "9b2e7c44-1f0a-4d3b-8e6f-5a1c2d3e4f50"
  }'

Returns 201 Created with the new Item and sends an item.created webhook. Unknown fields are ignored.

Change stock

PATCH/api/v1/items/{id}/quantityWrite key

Send either an absolute quantity or a relative delta (if both are sent, quantity is used):

Request body
FieldTypeRules
quantitynumberSets the stock: 0 to 999,999,999,999, at most 3 decimals.
deltanumberAdds to the stock (negative removes): −1,000,000 to 1,000,000, at most 3 decimals. The result never goes below 0.
expectedQuantitynumberOptional, with quantity only: the change is refused with 409 STOCK_CHANGED unless the current stock equals this value. Use it to avoid overwriting a count someone else just changed. Ignored with delta.
notestringOptional, up to 280 characters. Shown in the activity history and included in the webhook.
Remove 2 kg
curl -X PATCH "https://api-production-c3ca.up.railway.app/api/v1/items/3f6c2a8e-6b1d-4c1e-9a52-2d8f0c7b9e10/quantity" \
  -H "Authorization: Bearer $INVENTRACKR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"delta": -2, "note": "Sold at the counter"}'
Set a counted value, only if nobody changed it meanwhile
curl -X PATCH "https://api-production-c3ca.up.railway.app/api/v1/items/3f6c2a8e-6b1d-4c1e-9a52-2d8f0c7b9e10/quantity" \
  -H "Authorization: Bearer $INVENTRACKR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"quantity": 40, "expectedQuantity": 3.5, "note": "Stock count"}'

Returns 200 with the updated Item plus previousQuantity, and sends an item.quantityChanged webhook (and item.lowStock when the change takes the item from above its minimum to at or below it).

200 OK
{
  "id": "3f6c2a8e-6b1d-4c1e-9a52-2d8f0c7b9e10",
  "name": "Espresso beans",
  "description": "House blend, 1 kg bags",
  "barcode": "8714789120045",
  "quantity": 1.5,
  "minimumQuantity": 5,
  "unit": "kg",
  "priceCents": 1899,
  "supplierId": "9b2e7c44-1f0a-4d3b-8e6f-5a1c2d3e4f50",
  "supplierName": "Roastery Co.",
  "hasImage": false,
  "imageVersion": 0,
  "version": 8,
  "createdAt": "2026-10-02T14:05:11.482Z",
  "updatedAt": "2026-11-18T10:02:44.590Z",
  "stockStatus": "lowStock",
  "previousQuantity": 3.5
}

Webhooks

Webhooks send a signed HTTPS POST to your endpoint when products, stock or suppliers change, whoever made the change and wherever it was made.

Setting up

  1. In the web app, open the storage, then Storage settings → Integrations → Webhooks (storage owner, Pro).
  2. Enter your endpoint URL and choose the events to receive.
  3. Copy the signing secret (whsec_…). It’s shown only once; to get a new one, delete the webhook and add it again.
  4. Select Send test to check your endpoint, then watch Deliveries for results.

Endpoint URLs must:

  • start with https:// (plain HTTP isn’t allowed) and be at most 2,000 characters;
  • not contain a user name or password;
  • point to a public internet host: not an IP address or hostname in a private, loopback, link-local, carrier-grade NAT, multicast or reserved range, and not a single-label name or a name ending in .localhost, .local, .internal, .localdomain, .home.arpa, .intranet, .lan or .corp.

The host is resolved when you add the webhook and again on every delivery; if any address it resolves to isn’t public, the delivery fails. A storage can have up to 10 webhooks.

Event types

Webhook event types
EventSent whendata
item.createdA product is added (in the apps, by CSV import, or with POST /items).item: the full Item
item.updatedA product’s details are edited in the apps or updated by a CSV import.item: the full Item after the change
item.deletedA product is deleted.item: { id, name }
item.quantityChangedStock changes: adjustments, edits of the count, CSV import, or PATCH …/quantity.item (after the change), previousQuantity, delta, and note when one was given
item.lowStockA stock change takes a product from above its minimum to at or below it.item: the full Item
supplier.createdA supplier is added (in the apps or by CSV import).supplier: the full Supplier
supplier.updatedA supplier is edited.supplier: the full Supplier
supplier.deletedA supplier is deleted.supplier: { id, name }

An edit that changes the count sends both item.updated and item.quantityChanged; an edit that changes the unit sends only item.updated. Photo changes don’t send events. When a supplier is deleted, its products lose their supplier without separate item.updated events. item.lowStock isn’t sent when a product is created at or below its minimum, or when the minimum is raised above the current stock.

Payload & headers

Every delivery has the same envelope:

Envelope fields
FieldDescription
idThe event ID (UUID). The same for every endpoint and every retry of this event: use it to drop duplicates.
typeThe event type, e.g. item.quantityChanged.
createdAtWhen the event happened (ISO 8601, UTC).
storageIdThe storage the event belongs to.
dataEvent-specific data (see the table above).
item.quantityChanged
{
  "id": "6f1c3e0a-2b7d-4f5e-9c1a-8d2e4b6a0f13",
  "type": "item.quantityChanged",
  "createdAt": "2026-11-18T09:31:27.214Z",
  "storageId": "b4a7d2c1-5e6f-4a3b-9c8d-7e6f5a4b3c2d",
  "data": {
    "item": {
      "id": "3f6c2a8e-6b1d-4c1e-9a52-2d8f0c7b9e10",
      "name": "Espresso beans",
      "description": "House blend, 1 kg bags",
      "barcode": "8714789120045",
      "quantity": 1.5,
      "minimumQuantity": 5,
      "unit": "kg",
      "priceCents": 1899,
      "supplierId": "9b2e7c44-1f0a-4d3b-8e6f-5a1c2d3e4f50",
      "supplierName": "Roastery Co.",
      "hasImage": false,
      "imageVersion": 0,
      "version": 8,
      "createdAt": "2026-10-02T14:05:11.482Z",
      "updatedAt": "2026-11-18T09:31:27.103Z",
      "stockStatus": "lowStock"
    },
    "previousQuantity": 3.5,
    "delta": -2,
    "note": "Sold at the counter"
  }
}
item.deleted
{
  "id": "6f1c3e0a-2b7d-4f5e-9c1a-8d2e4b6a0f13",
  "type": "item.deleted",
  "createdAt": "2026-11-18T09:31:27.214Z",
  "storageId": "b4a7d2c1-5e6f-4a3b-9c8d-7e6f5a4b3c2d",
  "data": {
    "item": {
      "id": "3f6c2a8e-6b1d-4c1e-9a52-2d8f0c7b9e10",
      "name": "Espresso beans"
    }
  }
}
supplier.updated
{
  "id": "6f1c3e0a-2b7d-4f5e-9c1a-8d2e4b6a0f13",
  "type": "supplier.updated",
  "createdAt": "2026-11-18T09:31:27.214Z",
  "storageId": "b4a7d2c1-5e6f-4a3b-9c8d-7e6f5a4b3c2d",
  "data": {
    "supplier": {
      "id": "9b2e7c44-1f0a-4d3b-8e6f-5a1c2d3e4f50",
      "name": "Roastery Co.",
      "contactName": "Sam Rivera",
      "contactEmail": "orders@roastery.example",
      "contactPhone": "+1 555 0100",
      "createdAt": "2026-09-14T08:12:40.019Z"
    }
  }
}

Request headers:

Webhook request headers
HeaderValue
Content-Typeapplication/json
User-AgentInventrackr-Webhooks/1.0
Inventrackr-EventThe event type (also in the body), e.g. item.created.
Inventrackr-DeliveryThe delivery ID (UUID): unique per endpoint and event, unchanged across retries.
Inventrackr-Signaturet=<unix seconds>,v1=<hex HMAC-SHA256>; see below.

Verifying signatures

Check every request before trusting it. The Inventrackr-Signature header looks like this:

HTTP
Inventrackr-Signature: t=1763458287,v1=0f4c1e5b8a…(64 hex characters)
  1. Split the header on , and each part on the first = to get t (the time the delivery was sent, in Unix seconds) and v1 (the signature).
  2. Build the signed content: the t value, a period, and the raw request body exactly as received: `${t}.${rawBody}`.
  3. Compute an HMAC with SHA-256 over it, using your whole signing secret (including the whsec_ prefix) as the key, and hex-encode it (lowercase).
  4. Compare it with v1 using a constant-time comparison.
  5. Reject the request if t is more than a few minutes from your clock (5 minutes is a good tolerance), to stop replays. Each attempt, including retries, is signed with a fresh t.
Node.js (Express)
import crypto from "node:crypto";
import express from "express";

const secret = process.env.INVENTRACKR_WEBHOOK_SECRET; // "whsec_…", used exactly as shown
const TOLERANCE_SECONDS = 300;

/** Checks an Inventrackr-Signature header ("t=<unix seconds>,v1=<hex>") against the raw body. */
function verifySignature(rawBody, header, secret) {
  const parts = Object.fromEntries(
    String(header).split(",").map((part) => {
      const index = part.indexOf("=");
      return [part.slice(0, index).trim(), part.slice(index + 1).trim()];
    }),
  );
  const timestamp = Number(parts.t);
  if (!Number.isInteger(timestamp) || !parts.v1) return false;
  if (Math.abs(Date.now() / 1000 - timestamp) > TOLERANCE_SECONDS) return false;

  const expected = crypto
    .createHmac("sha256", secret)
    .update(`${timestamp}.`)
    .update(rawBody) // the exact bytes received, not re-serialized JSON
    .digest("hex");
  const a = Buffer.from(expected, "utf8");
  const b = Buffer.from(parts.v1, "utf8");
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}

const app = express();

// Read the body as raw bytes for this route (before any JSON parser).
app.post("/webhooks/inventrackr", express.raw({ type: "application/json" }), (req, res) => {
  if (!verifySignature(req.body, req.get("Inventrackr-Signature") ?? "", secret)) {
    return res.status(400).send("Invalid signature");
  }
  const event = JSON.parse(req.body.toString("utf8"));
  res.sendStatus(204); // answer within 10 seconds, then do the work
  queueForProcessing(event); // your code: dedupe on event.id
});

app.listen(3000);
Python (Flask)
import hashlib
import hmac
import json
import os
import time

from flask import Flask, abort, request

SECRET = os.environ["INVENTRACKR_WEBHOOK_SECRET"].encode()  # "whsec_…", used exactly as shown
TOLERANCE_SECONDS = 300


def verify_signature(raw_body: bytes, header: str) -> bool:
    """Checks an Inventrackr-Signature header ("t=<unix seconds>,v1=<hex>") against the raw body."""
    parts = dict(part.strip().split("=", 1) for part in header.split(",") if "=" in part)
    try:
        timestamp = int(parts["t"])
    except (KeyError, ValueError):
        return False
    if abs(time.time() - timestamp) > TOLERANCE_SECONDS:
        return False
    signed = f"{timestamp}.".encode() + raw_body  # the exact bytes received
    expected = hmac.new(SECRET, signed, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, parts.get("v1", ""))


app = Flask(__name__)


@app.post("/webhooks/inventrackr")
def inventrackr_webhook():
    raw_body = request.get_data()
    if not verify_signature(raw_body, request.headers.get("Inventrackr-Signature", "")):
        abort(400)
    event = json.loads(raw_body)
    queue_for_processing(event)  # your code: dedupe on event["id"], process asynchronously
    return "", 204

Responses & retries

Answer with any 2xx status within 10 seconds to acknowledge a delivery; the response body is ignored. Anything else is a failure: other status codes, redirects (they aren’t followed), timeouts, TLS or connection errors. Do slow work after responding.

Failed deliveries are retried with exponential backoff (±10% jitter), up to 8 attempts in total:

Retry schedule
AttemptSentAbout … after the first attempt
1Within seconds of the change—
21 minute after attempt 11 min
34 minutes after attempt 25 min
416 minutes after attempt 321 min
5About 1 hour after attempt 41 h 25 min
6About 4 hours after attempt 55 h 40 min
712 hours after attempt 617 h 40 min
8 (last)12 hours after attempt 729 h 40 min
  • After the 8th failed attempt the delivery is marked failed and isn’t retried. Deliveries still pending after 3 days are also marked failed.
  • If deliveries to an endpoint keep failing for more than 3 days with no success in between, the endpoint is disabled (the app shows “Disabled after 3 days of failed deliveries”). Events that happen while it’s disabled aren’t queued for it. A successful Send test turns it back on.
  • Webhooks pause while the storage owner isn’t on Pro: no new events are queued and pending retries wait (up to the 3-day limit).

Duplicates & ordering

  • At-least-once: a delivery can arrive more than once (for example when your 2xx response was lost). Store the event id and ignore ones you’ve already processed.
  • No ordering guarantee: deliveries are sent in parallel and retries can overtake later events. Use the item’s version (or updatedAt) to ignore data older than what you already have, or fetch the item with GET /items/{id} for its current state.
  • The item in an event is its state right after the change, not when the delivery arrives.

Test deliveries & logs

Send test delivers a webhook.test event right away, signed like any other delivery, attempted once and never retried. You can send up to 10 tests per minute per storage. You can’t subscribe to webhook.test.

webhook.test
{
  "id": "6f1c3e0a-2b7d-4f5e-9c1a-8d2e4b6a0f13",
  "type": "webhook.test",
  "createdAt": "2026-11-18T09:31:27.214Z",
  "storageId": "b4a7d2c1-5e6f-4a3b-9c8d-7e6f5a4b3c2d",
  "data": {
    "message": "This is a test delivery from Inventrackr."
  }
}

Deliveries shows the 50 most recent deliveries for a webhook with their status (pending, succeeded, failed), attempts, your endpoint’s HTTP status or the error, and the next retry time. Delivery logs are kept for 30 days.

CORS & browser use

The API allows cross-origin requests from any origin (Access-Control-Allow-Origin: *) without cookies or credentials. Browsers may send the Authorization and Content-Type headers, can read Retry-After, and cache preflight responses for 10 minutes.

Limits at a glance

Limits
WhatLimit
API keys per storage25
Webhooks per storage10
Requests per API key120 per minute
Requests per IP address600 per minute
Items per page500 (default 100)
Request body256 KB
Webhook response time10 seconds
Webhook attempts8 over about 30 hours
Test deliveries10 per minute per storage
Delivery log50 most recent per webhook, kept 30 days

Versioning & changelog

The version is part of the path: /api/v1. Within v1 you should expect additive changes, such as new fields in responses and webhook payloads, new endpoints and new event types, so ignore fields you don’t know. A change that would break existing integrations would come as a new version. The machine-readable description is at inventrackr.com/openapi.json (OpenAPI 3.1), for client generators and API tools.

Changelog

  • : API v1 and webhooks documented publicly: items (list, get, create, change stock), suppliers (list), eight webhook event types, signed deliveries with retries, and the OpenAPI 3.1 spec.

Questions or something missing? Email support@inventrackr.com.