Next Restaurant 6.1.0: move your data in, run payroll, and connect other systems Next Inventory 6.2.0: a REST API and webhooks for your other systems Next DB 6.1: Auto-Updating Tables, Printing, Phone Layout and SEO Next Task 6.0.0: a task manager for Joomla Next Inventory 6.1.1: smoother Check Out, no more list limits, and much faster PHP2Shell: Is Your Joomla Site Safe? What to Do Today Introducing Next Boards: Kanban project and task boards for Joomla Building the Future of Joomla Extensions
NextSoftware
Next Inventory — Documentation

List Transactions

GET /transactions

The ledger — every stock change, newest first

Scope transactions:read; role permission transactions.view.

Request

GET https://example.com/api/index.php/v1/nextinventory/transactions?limit=<integer>&offset=<integer>&item_id=<integer>&transaction_type=<string>&created_by=<integer>&date_from=<string>&date_to=<string>

Parameters

Name Type In Required Description
limit integer query No Page size. (min 1) Defaults to 20.
offset integer query No Rows to skip. (min 0) Defaults to 0.
item_id integer query No
transaction_type string query No
created_by integer query No
date_from string query No (date)
date_to string query No (date)

Responses

200 — A page of ledger rows.

{
    "data": [
        {
            "id": 1,
            "item_id": 1,
            "item_title": "string",
            "item_sku": "string",
            "transaction_type": "string",
            "quantity_change": 1.5,
            "new_quantity": 1.5,
            "transaction_unit_id": 1,
            "original_quantity": 1.5,
            "cost_per_unit": 1.5,
            "total_cost": 1.5,
            "batch_id": "string",
            "recipient_id": 1,
            "recipient": "string",
            "reason": "string",
            "created_by": 1,
            "created_by_name": "string",
            "created": "2026-01-01T12:00:00Z"
        }
    ],
    "meta": {
        "total": 1
    }
}
Field Type Meaning
data[].id integer
data[].item_id integer
data[].item_title string|null
data[].item_sku string|null
data[].transaction_type string
data[].quantity_change number Signed: negative for stock out.
data[].new_quantity number
data[].transaction_unit_id integer|null
data[].original_quantity number|null
data[].cost_per_unit number|null
data[].total_cost number|null
data[].batch_id string|null Shared by every row of one movement/transfer/adjustment.
data[].recipient_id integer|null
data[].recipient string|null
data[].reason string|null
data[].created_by integer
data[].created_by_name string|null
data[].created string|null (date-time)
meta.total integer Rows matching the filters, across all pages.

Errors

Status Code When
4 A refusal. Common codes: MISSING_TOKEN / INVALID_TOKEN (401); API_DISABLED, ACCOUNT_UNUSABLE, ACCESS_DENIED, TASK_NOT_ALLOWED, MISSING_SCOPE, APP_DISABLED, DEMO_LOCKED, FORBIDDEN (403); NOT_FOUND (404); BAD_REQUEST / INVALID_JSON / INVALID_IDEMPOTENCY_KEY (400, validation and stock rules, with the reason in title); IDEMPOTENCY_IN_PROGRESS (409); PRECONDITION_FAILED (412, the record changed since the If-Match ETag was read); IDEMPOTENCY_KEY_REUSED (422); RATE_LIMITED / TOO_MANY_FAILED_LOGINS (429, with a Retry-After header in seconds); SERVER_ERROR (500).

Examples

curl

curl -s "https://example.com/api/index.php/v1/nextinventory/transactions" \
  -H "Authorization: Bearer $API_TOKEN"

PHP

<?php
$ch = curl_init('https://example.com/api/index.php/v1/nextinventory/transactions?limit=<integer>&offset=<integer>&item_id=<integer>&transaction_type=<string>&created_by=<integer>&date_from=<string>&date_to=<string>');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('API_TOKEN'),
    ],
]);

$response = json_decode(curl_exec($ch), true);
curl_close($ch);

JavaScript

const API_TOKEN = process.env.API_TOKEN;

const response = await fetch("https://example.com/api/index.php/v1/nextinventory/transactions?limit=<integer>&offset=<integer>&item_id=<integer>&transaction_type=<string>&created_by=<integer>&date_from=<string>&date_to=<string>", {
  headers: {
    "Authorization": `Bearer ${API_TOKEN}`,
  },
});
const data = await response.json();

All Extensions