Endpoints

Shipments

Returns shipment records for orders, with timestamps for when each shipment left the warehouse, was delivered, or was returned.

GEThttps://xqqpbuhqvbbgyevwmktp.supabase.co/functions/v1/stylehub-shipments

Query parameters#

Parameter	Type	Required	Description
`created_from`	string (YYYY-MM-DD)	one of four*	Return rows whose created_at is on or after this date.
`created_to`	string (YYYY-MM-DD)	one of four*	Return rows whose created_at is on or before this date.
`updated_from`	string (YYYY-MM-DD)	one of four*	Return rows whose updated_at is on or after this date.
`updated_to`	string (YYYY-MM-DD)	one of four*	Return rows whose updated_at is on or before this date.
`order_id`	integer	optional	Positive integer. Return only the shipments belonging to this order.
`page`	integer	optional	Zero-indexed page number. Default: `0`.
`page_size`	integer	optional	Rows per page. Maximum 1000. Default: `1000`.

* At least one date parameter is required — see Date filtering. Parameters combine with AND.

Example request#

Requires an API key sent as a Bearer token — see Authentication.

curl -s "https://xqqpbuhqvbbgyevwmktp.supabase.co/functions/v1/stylehub-shipments?updated_from=2026-10-01&order_id=18423" \
  -H "Authorization: Bearer stylehub_fsUPPpnCdz44Ld5fPQSfP0sTA3JaAjYn"

Example response#

JSON

{
  "data": [
    {
      "id": 17002,
      "order_id": 18423,
      "shipped_at": "2026-03-15T11:00:00Z",
      "delivered_at": null,
      "returned_at": null,
      "created_at": "2026-03-14T09:12:44Z",
      "updated_at": "2026-03-15T11:00:02Z"
    },
    {
      "id": 16990,
      "order_id": 18391,
      "shipped_at": "2026-03-12T08:45:00Z",
      "delivered_at": "2026-03-16T14:20:00Z",
      "returned_at": null,
      "created_at": "2026-03-11T17:30:12Z",
      "updated_at": "2026-03-16T14:20:05Z"
    }
  ],
  "meta": {
    "page": 0,
    "page_size": 1000,
    "count": 1234,
    "has_more": true
  }
}

Abbreviated: data holds up to page_size rows. See Response format and Errors.

Previous← Order Items NextConnecting →