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

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