List an item's inventory adjustments

cURL

curl -X GET "$EXSITED_BASE_URL/api/v4/items/ITEM-0001/inventory_adjustments?limit=20" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

import com.exsited.client.ApiResponse;
import com.exsited.client.ClientRegistry;
import com.exsited.client.ExsitedClient;
import com.exsited.resources.items.items_dto.ItemsDto.InventoryAdjustmentList;
import java.util.Map;

ExsitedClient client = ClientRegistry.buildClient();

ApiResponse<InventoryAdjustmentList> response = client.items().getItemInventoryAdjustments(
        "ITEM-0001",
        Map.of("limit", 20));
System.out.println(response.getMap());

using Exsited.Client;

await using var client = ExsitedClient.BuildClient();

var response = await client.Items.GetItemInventoryAdjustmentsAsync(
    "ITEM-0001",
    new Dictionary<string, object?> { ["limit"] = 20 });

Console.WriteLine(response.Json);

import 'package:exsited/exsited.dart';

final client = buildClient();

final response = await client.items.getItemInventoryAdjustments(
  'ITEM-0001',
  queryParams: {'limit': 20},
);
print(response.map);

import (
	"context"
	"fmt"
	"log"

	exsited "github.com/exsited/exsited-sdk-go/v4"
)

client, err := exsited.BuildClient(nil)
if err != nil {
	log.Fatal(err)
}
defer client.Close()

response, err := client.Items().GetItemInventoryAdjustments(context.Background(), "ITEM-0001", map[string]any{"limit": 20}, nil)
if err != nil {
	log.Fatal(err)
}
fmt.Println(response.Map)

{
  "object": "<string>",
  "url": "<string>",
  "data": [
    {
      "object": "<string>",
      "id": "<string>",
      "item_id": "<string>",
      "item_name": "<string>",
      "warehouse_name": "<string>",
      "adjustment_amount": "<string>",
      "adjustment_type": "<string>",
      "reference": "<string>",
      "status": "<string>",
      "quantity_on_hand": "<string>",
      "quantity_available": "<string>",
      "quantity_on_order": "<string>",
      "quantity_promised": "<string>",
      "quantity_on_return": "<string>",
      "quantity_on_purchase_return": "<string>",
      "quantity_on_reserve": "<string>",
      "created_on": "<string>",
      "last_updated_on": "<string>",
      "href": "<string>",
      "created_by": "<unknown>",
      "last_updated_by": "<unknown>"
    }
  ],
  "pagination": {
    "limit": 123,
    "has_more": true,
    "next_cursor": "<string>",
    "prev_cursor": "<string>",
    "links": {
      "next": "<string>",
      "prev": "<string>"
    }
  }
}

GET

items

{item_id}

inventory_adjustments

cURL

curl -X GET "$EXSITED_BASE_URL/api/v4/items/ITEM-0001/inventory_adjustments?limit=20" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

import com.exsited.client.ApiResponse;
import com.exsited.client.ClientRegistry;
import com.exsited.client.ExsitedClient;
import com.exsited.resources.items.items_dto.ItemsDto.InventoryAdjustmentList;
import java.util.Map;

ExsitedClient client = ClientRegistry.buildClient();

ApiResponse<InventoryAdjustmentList> response = client.items().getItemInventoryAdjustments(
        "ITEM-0001",
        Map.of("limit", 20));
System.out.println(response.getMap());

using Exsited.Client;

await using var client = ExsitedClient.BuildClient();

var response = await client.Items.GetItemInventoryAdjustmentsAsync(
    "ITEM-0001",
    new Dictionary<string, object?> { ["limit"] = 20 });

Console.WriteLine(response.Json);

import 'package:exsited/exsited.dart';

final client = buildClient();

final response = await client.items.getItemInventoryAdjustments(
  'ITEM-0001',
  queryParams: {'limit': 20},
);
print(response.map);

import (
	"context"
	"fmt"
	"log"

	exsited "github.com/exsited/exsited-sdk-go/v4"
)

client, err := exsited.BuildClient(nil)
if err != nil {
	log.Fatal(err)
}
defer client.Close()

response, err := client.Items().GetItemInventoryAdjustments(context.Background(), "ITEM-0001", map[string]any{"limit": 20}, nil)
if err != nil {
	log.Fatal(err)
}
fmt.Println(response.Map)

{
  "object": "<string>",
  "url": "<string>",
  "data": [
    {
      "object": "<string>",
      "id": "<string>",
      "item_id": "<string>",
      "item_name": "<string>",
      "warehouse_name": "<string>",
      "adjustment_amount": "<string>",
      "adjustment_type": "<string>",
      "reference": "<string>",
      "status": "<string>",
      "quantity_on_hand": "<string>",
      "quantity_available": "<string>",
      "quantity_on_order": "<string>",
      "quantity_promised": "<string>",
      "quantity_on_return": "<string>",
      "quantity_on_purchase_return": "<string>",
      "quantity_on_reserve": "<string>",
      "created_on": "<string>",
      "last_updated_on": "<string>",
      "href": "<string>",
      "created_by": "<unknown>",
      "last_updated_by": "<unknown>"
    }
  ],
  "pagination": {
    "limit": 123,
    "has_more": true,
    "next_cursor": "<string>",
    "prev_cursor": "<string>",
    "links": {
      "next": "<string>",
      "prev": "<string>"
    }
  }
}

Returns the item’s inventory adjustments under data, one per stock change, paged by cursor. Every quantity in an adjustment is a string, so convert it before doing arithmetic.

The SDK samples get their client from credentials your app registers once when it starts, as shown in Authentication. To try the call here, click Try it, set host to your Exsited API host name and paste an access token from Get an access token.

Authorizations

Authorization

string

header

required

An access token from POST /api/v4/oauth2/token. The SDKs get and renew it for you.

Path Parameters

item_id

string

required

The item's id, such as ITEM-0001. Not its uuid.

Query Parameters

limit

integer

How many records to return on one page.

Example:

20

cursor

string

The next_cursor from the previous page, to fetch the page after it.

Response

200 - application/json

A page of inventory adjustments, under data.

object

string

url

string

data

object[]

Show child attributes

pagination

object

Show child attributes

Guides

API reference

List an item's inventory adjustments

Authorizations

Path Parameters

Query Parameters

Response