Get Item
GET /items/{id}
Get one item, with its custom fields
Scope items:read.
Request
GET https://example.com/api/index.php/v1/nextinventory/items/{id}Parameters
| Name | Type | In | Required | Description |
|---|---|---|---|---|
id |
integer |
path |
Yes | (min 1) |
Responses
200 — The item.
{
"data": {
"id": 1,
"title": "string",
"alias": "string",
"item_type": "asset",
"sku": "string",
"barcode": "string",
"serial_number": "string",
"category_id": 1,
"category_title": "string",
"warehouse_id": 1,
"warehouse_title": "string",
"unit_id": 1,
"unit_title": "string",
"unit_code": "string",
"stock_quantity": 1.5,
"unit_price": 1.5,
"low_stock_threshold": 1.5,
"weight": 1.5,
"weight_unit": "string",
"track_weight": true,
"description": "string",
"image": "string",
"state": 1,
"created": "2026-01-01T12:00:00Z",
"modified": "2026-01-01T12:00:00Z",
"custom_fields": [
{
"name": "string",
"label": "string",
"field_type": "string",
"value": "string"
}
]
}
}| Field | Type | Meaning |
|---|---|---|
data |
object |
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/items/1" \
-H "Authorization: Bearer $API_TOKEN"PHP
<?php
$ch = curl_init('https://example.com/api/index.php/v1/nextinventory/items/1');
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/items/1", {
headers: {
"Authorization": `Bearer ${API_TOKEN}`,
},
});
const data = await response.json();