v2.0 (Stable)

API Reference

Integrate Inventilo into your existing tech stack. Our REST API uses standard HTTP verbs, understands JSON payloads, and returns JSON-encoded responses.

Authentication

Authenticate your API requests by including your secret API key in the Authorization header.

Authorization: Bearer sk_live_...

Pagination

All top-level API resources have support for bulk fetches via "list" API methods. These list API methods share a common structure, taking at least these two parameters: limit and cursor.

Webhooks

Inventilo can send webhook events that notify your application any time an event happens on your account. This is especially useful for events that are asynchronous like order.fulfilled.

GET/v2/products

List all products

curl https://api.inventilo.com/v2/products \
  -H "Authorization: Bearer sk_live_abc123" \
  -d limit=10

200 OK

{
  "object": "list",
  "url": "/v2/products",
  "has_more": false,
  "data": [
    {
      "id": "prod_123",
      "object": "product",
      "name": "Enterprise Plan",
      ...
    }
  ]
}

POST/v2/orders

Create an order

import { Inventilo } from 'inventilo';
const erp = new Inventilo('sk_live_abc123');

const order = await erp.orders.create({
  customer: 'cus_890',
  items: [
    { product: 'prod_123', quantity: 2 }
  ]
});