List inventory increases
Operation ID: inventoryIncreases
Group: Inventory › Inventory Increases
Open in the interactive reference
GET /inventory/inventory-increases
Read-only: Reads and returns; changes nothing.
Lists inventory increases. Each inventory increase comes back with its main fields and lineCount, but without the lines.
To read the lines, use GET inventory/inventory-increases/:id or POST inventory/inventory-increases/search. To filter by item, use POST inventory/inventory-increases/search.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Api-Version |
header | string · v1 | yes | The API version this request targets, named by its public identifier. Required on every request; omitting it, or naming a version this company does not have, is answered with 400. This document describes version v1. |
Query surface
id— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likedocumentNumber— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likedocumentStatus— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likedocumentDate— filter by eq, ne, gt, gte, lt, lte, in, notIn, betweenentityId— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likelocationId— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likelocationCode— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likereasonCodeId— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likereasonCode— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likelastModifiedDate— filter by eq, ne, gt, gte, lt, lte, in, notIn, between- Orderable: id, documentNumber, documentDate, documentStatus, createdDate, lastModifiedDate
- Selectable: id, documentNumber, documentStatus, documentDate, entityId, entityName, locationId, locationCode, locationName, reasonCodeId, reasonCode, reasonCodeDescription, currency, lineCount, notes, createdDate, lastModifiedDate
page[size]— Page sizepage[cursor]— Opaque continuation cursor
Response
200 Success
Under data, an array of inventoryIncreasesRow:
| Field | Type | Required | Filter | Sort | Description |
|---|---|---|---|---|---|
id |
string | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
yes | The unique identifier for the inventory increase. Example: "d4a17f28-6b93-4c50-8e71-2a5d0c9b3e64". |
documentNumber |
string | null | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
yes | The inventory increase's document number, for example 'INC-42'. Absent while none has been assigned. Example: "INC-42". |
documentStatus |
string | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
yes | The status of the inventory increase. Possible values: 'DRAFT', 'COMMITTED', 'CANCELLED'. Example: "DRAFT". |
documentDate |
date | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) |
yes | The date the inventory increase is dated. It sets the posting period. Format YYYY-MM-DD. Example: "2026-08-14". |
entityId |
string | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
no | The unique identifier for the legal entity. See id on GET base/entities. Example: "1a9c4e70-38b5-4d26-9f01-7c2e5b8a6d43". |
entityName |
string | null | no | no | no | The display name of that legal entity. Example: "Acme Netherlands B.V.". |
locationId |
string | null | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
no | The unique identifier for the warehouse the stock is added to. See id on GET inventory/warehouses/:id. Example: "e1d84c07-5b39-4a26-9f70-2c8b613ad495". |
locationCode |
string | null | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
no | The short code of that warehouse. Example: "WH-01". |
locationName |
string | null | no | no | no | The display name of that warehouse. Example: "Rotterdam Distribution Centre". |
reasonCodeId |
string | null | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
no | The unique identifier for the reason code. See id on GET inventory/reason-codes/:id. Example: "6f2b58c1-9d47-4e03-a815-70c9d2e46b38". |
reasonCode |
string | null | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
no | The short code of that reason code. Example: "COUNT". |
reasonCodeDescription |
string | null | no | no | no | The description of that reason code. Example: "Count correction". |
currency |
string | null | no | no | no | The currency the inventory increase is valued in. Format ISO 4217, for example 'EUR'. Example: "EUR". |
lineCount |
number | null | no | no | no | The number of lines the inventory increase has. The collection does not return the lines themselves. Example: 1. |
notes |
string | null | no | no | no | Free text on the inventory increase. Example: "August cycle count". |
createdDate |
date-time | null | no | no | yes | The date and time the inventory increase was created, in UTC. Format YYYY-MM-DDTHH:mm:ss.sssZ. Example: "2026-08-14T09:12:00.000Z". |
lastModifiedDate |
date-time | null | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) |
yes | The date and time the inventory increase record last changed, in UTC. Format YYYY-MM-DDTHH:mm:ss.sssZ. Example: "2026-08-14T09:12:00.000Z". |
{
"data": [
{
"id": "d4a17f28-6b93-4c50-8e71-2a5d0c9b3e64",
"documentNumber": "INC-42",
"documentStatus": "DRAFT",
"documentDate": "2026-08-14",
"entityId": "1a9c4e70-38b5-4d26-9f01-7c2e5b8a6d43",
"entityName": "Acme Netherlands B.V.",
"locationId": "e1d84c07-5b39-4a26-9f70-2c8b613ad495",
"locationCode": "WH-01",
"locationName": "Rotterdam Distribution Centre",
"reasonCodeId": "6f2b58c1-9d47-4e03-a815-70c9d2e46b38",
"reasonCode": "COUNT",
"reasonCodeDescription": "Count correction",
"currency": "EUR",
"lineCount": 1,
"notes": "August cycle count",
"createdDate": "2026-08-14T09:12:00.000Z",
"lastModifiedDate": "2026-08-14T09:12:00.000Z"
}
],
"pagination": {
"hasMore": true,
"nextCursor": "<nextCursor>"
}
}
Statuses
400— Invalid request or business failure401— The request carries no valid access token.403— Not authorized404— Not found429— Too many requests from this client address. The response has no body and noRetry-Afterheader.500— Internal server error