Inventory

Stock Adjustments

The StockAdjustments report lists out stock adjustments for a site.

get/inventory/reports/stock-adjustments

Stock Adjustments report

listStockAdjustments

This endpoint provides a report of stock adjustments for the given parameters.

Query parameters

site_iduuidrequired
Filter stock adjustments by site.
date_fromdaterequired
Filter the list of stock adjustments by the date the adjustment was made. The adjustment must have been made on or after this date.
date_todaterequired
Filter the list of stock adjustments by the date the adjustment was made. The adjustment must have been made on or before this date.
brand_idsstring[]optional
Filter the list of stock adjustments by a comma-separated list of brand IDs associated with the inventory products.
category_idsstring[]optional
Filter the list of stock adjustments by a comma-separated list of category IDs associated with the inventory products.
pageintegeroptional
The page to retrieve results from
per_pageintegeroptional
The number of results to return per page

Responses

200
The stock adjustments were successfully retrieved
401
The user is unauthenticated

curl "https://api.playground.try.be/inventory/reports/stock-adjustments?site_id=00000000-0000-0000-0000-000000000000&date_from=2026-01-15&date_to=2026-01-15" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

const response = await fetch('https://api.playground.try.be/inventory/reports/stock-adjustments?site_id=00000000-0000-0000-0000-000000000000&date_from=2026-01-15&date_to=2026-01-15', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    Accept: 'application/json',
  },
})

if (!response.ok) {
  throw new Error(`Trybe API ${response.status}: ${await response.text()}`)
}

const data = await response.json()

import httpx

response = httpx.get(
    "https://api.playground.try.be/inventory/reports/stock-adjustments?site_id=00000000-0000-0000-0000-000000000000&date_from=2026-01-15&date_to=2026-01-15",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.playground.try.be/inventory/reports/stock-adjustments?site_id=00000000-0000-0000-0000-000000000000&date_from=2026-01-15&date_to=2026-01-15', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_KEY',
        'Accept' => 'application/json',
    ],
]);

$data = json_decode($response->getBody(), true);

package main

import (
	"encoding/json"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.playground.try.be/inventory/reports/stock-adjustments?site_id=00000000-0000-0000-0000-000000000000&date_from=2026-01-15&date_to=2026-01-15", nil)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
}

The stock adjustments were successfully retrieved

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "date": "2026-01-15T09:30:00+00:00",
      "product_id": "00000000-0000-0000-0000-000000000000",
      "product_name": "Blissful Body Butter",
      "quantity": 10,
      "reason_code": "Sale",
      "reason_description": "Sale of 10 Blissful Body Butter products",
      "adjusted_by_id": "00000000-0000-0000-0000-000000000000",
      "adjusted_by": {
        "id": "00000000-0000-0000-0000-000000000000",
        "email": "guest@example.com",
        "first_name": "Dan",
        "last_name": "Johnson",
        "full_name": "Dan Johnson"
      },
      "adjusted_value": 2000,
      "currency": "gbp"
    }
  ],
  "meta": {
    "from": 1,
    "to": 2,
    "total": 2,
    "current_page": 1,
    "last_page": 2,
    "per_page": 15,
    "path": "http://example.com/api"
  }
}

{
  "message": "Unauthenticated"
}

get/inventory/reports/stock-adjustments/queue

Stock Adjustments report queue

actionQueueStockAdjustments

This endpoint queues an export of the report of stock adjustments for the given parameters.

Query parameters

site_iduuidrequired
Filter stock adjustments by site.
date_fromdaterequired
Filter the list of stock adjustments by the date the adjustment was made. The adjustment must have been made on or after this date.
date_todaterequired
Filter the list of stock adjustments by the date the adjustment was made. The adjustment must have been made on or before this date.
brand_idsstring[]optional
Filter the list of stock adjustments by a comma-separated list of brand IDs associated with the inventory products.
category_idsstring[]optional
Filter the list of stock adjustments by a comma-separated list of category IDs associated with the inventory products.

Responses

200
The job was successfully queued
400
The request failed.
401
The user is unauthenticated

curl "https://api.playground.try.be/inventory/reports/stock-adjustments/queue?site_id=00000000-0000-0000-0000-000000000000&date_from=2026-01-15&date_to=2026-01-15" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

const response = await fetch('https://api.playground.try.be/inventory/reports/stock-adjustments/queue?site_id=00000000-0000-0000-0000-000000000000&date_from=2026-01-15&date_to=2026-01-15', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    Accept: 'application/json',
  },
})

if (!response.ok) {
  throw new Error(`Trybe API ${response.status}: ${await response.text()}`)
}

const data = await response.json()

import httpx

response = httpx.get(
    "https://api.playground.try.be/inventory/reports/stock-adjustments/queue?site_id=00000000-0000-0000-0000-000000000000&date_from=2026-01-15&date_to=2026-01-15",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
    },
)
response.raise_for_status()
data = response.json()

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.playground.try.be/inventory/reports/stock-adjustments/queue?site_id=00000000-0000-0000-0000-000000000000&date_from=2026-01-15&date_to=2026-01-15', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_KEY',
        'Accept' => 'application/json',
    ],
]);

$data = json_decode($response->getBody(), true);

package main

import (
	"encoding/json"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.playground.try.be/inventory/reports/stock-adjustments/queue?site_id=00000000-0000-0000-0000-000000000000&date_from=2026-01-15&date_to=2026-01-15", nil)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
}

The job was successfully queued

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "status": "pending",
    "output": {},
    "created_at": "2023-11-07T00:00:00+00:00",
    "updated_at": "2023-11-07T01:00:00+00:00"
  }
}

{
  "message": "string"
}

{
  "message": "Unauthenticated"
}