Spree Admin SDK

import { createAdminClient } from '@spree/admin-sdk'

const client = createAdminClient({
  baseUrl: 'https://your-store.com',
  secretKey: 'sk_xxx',
})

const { data: transfers } = await client.stockTransfers.list({
  open: true,
  sort: '-created_at',
})

{
  "data": [
    {
      "id": "st_UkLWZg9DAJ",
      "number": "T1001",
      "reference": "Weekly restock",
      "created_at": "2026-01-15T12:00:00.000Z",
      "updated_at": "2026-01-15T12:00:00.000Z",
      "source_location_id": "sloc_UkLWZg9DAJ",
      "destination_location_id": "sloc_gbHJdmfrXB",
      "status": "draft",
      "notes": null,
      "metadata": {},
      "close_reason": null,
      "items_count": 1,
      "quantity_received_total": 0,
      "quantity_rejected_total": 0,
      "shipped_at": null,
      "received_at": null,
      "closed_short_at": null,
      "deleted_at": null,
      "closed_short": false,
      "quantity_shipped_total": 10,
      "editable": true
    }
  ],
  "meta": {
    "page": 1,
    "limit": 25,
    "count": 1,
    "pages": 1,
    "from": 1,
    "to": 1,
    "in": 1,
    "previous": null,
    "next": null
  }
}

{
  "error": {
    "code": "authentication_required",
    "message": "Authentication required"
  }
}

List stock transfers

Stock moving between two of the merchant’s own warehouses.

A transfer is a trip, not an instant. Units leave the source when the transfer is marked in transit and land at the destination when somebody counts them in — in between they are in flight, gone from one shelf and not yet on the other.

Statuses are draft, ready_to_ship, in_transit, partially_received, received, over_received and canceled. Each move between them is its own endpoint, not a PATCH that writes status.

Receiving from a supplier is a purchase order, not a transfer with a missing source.

Filter with Ransack predicates such as q[status_eq], q[source_location_id_eq] or q[number_or_reference_cont]. Expand items, source_location and destination_location.

Required scope: read_stock (for API-key authentication).

GET

api

admin

stock_transfers

Spree Admin SDK

import { createAdminClient } from '@spree/admin-sdk'

const client = createAdminClient({
  baseUrl: 'https://your-store.com',
  secretKey: 'sk_xxx',
})

const { data: transfers } = await client.stockTransfers.list({
  open: true,
  sort: '-created_at',
})

{
  "data": [
    {
      "id": "st_UkLWZg9DAJ",
      "number": "T1001",
      "reference": "Weekly restock",
      "created_at": "2026-01-15T12:00:00.000Z",
      "updated_at": "2026-01-15T12:00:00.000Z",
      "source_location_id": "sloc_UkLWZg9DAJ",
      "destination_location_id": "sloc_gbHJdmfrXB",
      "status": "draft",
      "notes": null,
      "metadata": {},
      "close_reason": null,
      "items_count": 1,
      "quantity_received_total": 0,
      "quantity_rejected_total": 0,
      "shipped_at": null,
      "received_at": null,
      "closed_short_at": null,
      "deleted_at": null,
      "closed_short": false,
      "quantity_shipped_total": 10,
      "editable": true
    }
  ],
  "meta": {
    "page": 1,
    "limit": 25,
    "count": 1,
    "pages": 1,
    "from": 1,
    "to": 1,
    "in": 1,
    "previous": null,
    "next": null
  }
}

{
  "error": {
    "code": "authentication_required",
    "message": "Authentication required"
  }
}

Filters

Filter with q[<attribute>_<predicate>]=value, for example q[number_cont]=…. Send a list as q[<attribute>_in][]=a&q[<attribute>_in][]=b. How filters work.

Attribute	Kind	Predicates
`closed_short_at`	Date and time	`eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null`
`created_at`	Date and time	`eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null`
`destination_location_id`	Prefixed ID	`eq` `not_eq` `in` `not_in` `null` `not_null`
`id`	Prefixed ID	`eq` `not_eq` `in` `not_in` `null` `not_null`
`number`	Text	`eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank`
`received_at`	Date and time	`eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null`
`reference`	Text	`eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank`
`shipped_at`	Date and time	`eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null`
`source_location_id`	Prefixed ID	`eq` `not_eq` `in` `not_in` `null` `not_null`
`status`	One of `draft`, `ready_to_ship`, `in_transit`, `partially_received`, `received`, `over_received`, `canceled`	`eq` `not_eq` `in` `not_in` `null` `not_null`
`updated_at`	Date and time	`eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null`

Filters through associations

Prefix an associated record’s attribute with the association, as in q[destination_location_id_eq]. The same predicates apply.

Prefix	Attributes
`destination_location_`	`active`, `country_code`, `created_at`, `default`, `id`, `kind`, `name`, `pickup_enabled`, `returns_enabled`, `seller_id`, `state_code`, `updated_at`
`destination_location_seller_`	`contact_email`, `created_at`, `id`, `name`, `status`, `updated_at`
`items_`	`created_at`, `id`, `quantity_received`, `quantity_rejected`, `quantity_shipped`, `updated_at`, `variant_id`
`items_variant_`	`carton_package_type_id`, `carton_weight`, `cartons_per_pallet`, `cost_currency`, `cost_price`, `country_of_origin`, `created_at`, `deleted_at`, `depth`, `discontinue_on`, `height`, `hs_code`, `id`, `minimum_order_quantity`, `order_multiple`, `position`, `product_id`, `purchase_unit`, `sku`, `track_inventory`, `units_per_carton`, `updated_at`, `weight`, `width`
`source_location_`	`active`, `country_code`, `created_at`, `default`, `id`, `kind`, `name`, `pickup_enabled`, `returns_enabled`, `seller_id`, `state_code`, `updated_at`
`source_location_seller_`	`contact_email`, `created_at`, `id`, `name`, `status`, `updated_at`

Sort by: closed_short_at, created_at, destination_location_id, id, number, received_at, reference, shipped_at, source_location_id, status, updated_at. Prefix a field with - to sort descending.

Authorizations

x-spree-api-key

string

header

required

Secret API key for admin access

Authorization

string

header

required

JWT token for admin user authentication

Headers

x-spree-api-key

string

required

Authorization

string

required

Bearer token for admin authentication

Query Parameters

q[search]

string

Matches any of number and reference (partial, case-insensitive).

q[closed]

boolean

Set to true to apply closed.

q[open]

boolean

Set to true to apply open.

page

integer

Page number

limit

integer

Number of records per page

object

Attribute filters, as q[<attribute>_<predicate>]=value. See Filters above for the list.

expand

string

Comma-separated associations to embed: items, source_location, destination_location

Response

stock transfers found

data

object[]

required

Show child attributes

API basics

Endpoints

List stock transfers

Filters

Authorizations

Headers

Query Parameters

Response

​Filters

Authorizations

Headers

Query Parameters

Response

Filters