Deliveries

List Deliveries

Returns a flat list of delivery records across all orders for your account. Each record represents a single SKU line received in a stock arrival.

Lines belonging to the same shipment (same order_id, recorded on the same created_at calendar day) share a common shipment_id, so you can group them client-side to reconstruct the full shipment.

GET/api/v1/orders/delivery

Query Parameters

Parameter	Type	Default	Description
created_after	datetime	-	Only include deliveries created on or after this ISO 8601 datetime (e.g., 2026-04-29T16:00:00Z). A date-only value is parsed as midnight UTC.
created_before	datetime	-	Only include deliveries created strictly before this ISO 8601 datetime. A date-only value is parsed as midnight UTC, so to include a full calendar day pass the next day at 00:00:00Z (e.g., 2026-04-30T00:00:00Z to include 29 Apr).

Example Request

cURL

# Datetime range (recommended)
curl -X GET "https://api.prediko.io/api/v1/orders/delivery?created_after=2026-04-29T00:00:00Z&created_before=2026-04-30T00:00:00Z" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Date-only values are accepted too (parsed as midnight UTC)
curl -X GET "https://api.prediko.io/api/v1/orders/delivery?created_after=2026-04-29" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import requests

response = requests.get(
    "https://api.prediko.io/api/v1/orders/delivery",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={
        "created_after": "2026-04-29T00:00:00Z",
        "created_before": "2026-04-30T00:00:00Z",
    },
)
deliveries = response.json()

JavaScript

const params = new URLSearchParams({
  created_after: "2026-04-29T00:00:00Z",
  created_before: "2026-04-30T00:00:00Z",
});

const response = await fetch(
  `https://api.prediko.io/api/v1/orders/delivery?${params}`,
  {
    headers: { "Authorization": "Bearer YOUR_API_KEY" }
  }
);
const deliveries = await response.json();

Response

Returns an array of delivery objects.

[
  {
    "order_id": "8b964899-442f-4e69-9ddb-9e9dba1e8929",
    "order_name": "PO-20260218190713",
    "sku_name": "CONVERSE | CHUCK TAYLOR ALL STAR II HI - white / 11",
    "warehouse_name": "19 Avenue Duquesne",
    "quantity_received": 100,
    "shipment_id": "4688555ff8",
    "delivery_date": "2026-04-29T16:57:35.185983",
    "created_at": "2026-04-29T16:57:35.185980"
  },
  {
    "order_id": "5fa1b3c2-9d04-4c2e-b8a1-77d9ef02aa12",
    "order_name": "TCON115768_90",
    "sku_name": "10077580",
    "warehouse_name": "WAREHOUSE",
    "quantity_received": -7,
    "shipment_id": "23c3a1a074",
    "delivery_date": "2026-04-23T19:08:43.128656",
    "created_at": "2026-04-23T19:08:43.121002"
  },
  {
    "order_id": "5fa1b3c2-9d04-4c2e-b8a1-77d9ef02aa12",
    "order_name": "TCON115768_90",
    "sku_name": "10077579",
    "warehouse_name": "WAREHOUSE",
    "quantity_received": -3,
    "shipment_id": "23c3a1a074",
    "delivery_date": "2026-04-23T19:08:43.128656",
    "created_at": "2026-04-23T19:08:43.121002"
  }
]

The last two records share the same shipment_id because they belong to the same order_id and were received on the same day.

Response Fields

Field	Type	Description
order_id	string (uuid)	Internal identifier of the purchase order
order_name	string	Reference name of the purchase order (e.g., PO-0083)
sku_name	string	Name of the SKU that was delivered
warehouse_name	string	Name of the warehouse receiving the delivery
quantity_received	integer	Number of units received in this delivery
shipment_id	string	Stable 10-character identifier of the shipment the line belongs to. Computed as the first 10 hex chars of `sha256(order_id + "
delivery_date	datetime	Timestamp of when the delivery occurred (ISO 8601)
created_at	datetime	Timestamp at which the arrival record was created — this is the field the created_after / created_before filters compare against (ISO 8601)

Negative quantities

A negative quantity_received represents a return or adjustment (e.g., a refund or stock correction).

Grouping lines into shipments

To reconstruct a full shipment, group the response by shipment_id. Every SKU line belonging to the same order_id and recorded on the same created_at calendar day shares the same value, and the value is stable across calls. Note: if a single PO is received in multiple separate batches on the same day they will share a shipment_id; if you need to distinguish those, also group by delivery_date.