List delivery methods

Spree Seller SDK

import { createSellerClient } from '@spree/seller-sdk'

const client = createSellerClient({
  baseUrl: 'https://your-store.com',
  jwtToken: 'eyJhbGciOi...',
  sellerId: 'sel_UkLWZg9DAJ',
})

const { data: deliveryMethods } = await client.deliveryMethods.list()

{
  "data": [
    {
      "id": "dm_UkLWZg9DAJ",
      "name": "My courier",
      "code": "UPS_GROUND_117",
      "estimated_transit_business_days_min": null,
      "estimated_transit_business_days_max": null,
      "digital": false,
      "pickup": false,
      "pickup_point": false,
      "admin_name": null,
      "storefront_visible": true,
      "tracking_url": null,
      "created_at": "2026-01-15T12:00:00.000Z",
      "updated_at": "2026-01-15T12:00:00.000Z",
      "rules": [],
      "editable": true,
      "delivery_profile_id": "fp_UkLWZg9DAJ",
      "delivery_zone_id": null,
      "calculator": {
        "type": "flat_rate",
        "preferences": {
          "amounts": {},
          "amount": "10.00",
          "currency": "USD"
        }
      }
    },
    {
      "id": "dm_gbHJdmfrXB",
      "name": "Marketplace post",
      "code": "UPS_GROUND_118",
      "estimated_transit_business_days_min": null,
      "estimated_transit_business_days_max": null,
      "digital": false,
      "pickup": false,
      "pickup_point": false,
      "admin_name": null,
      "storefront_visible": true,
      "tracking_url": null,
      "created_at": "2026-01-15T12:00:00.000Z",
      "updated_at": "2026-01-15T12:00:00.000Z",
      "rules": [],
      "editable": false,
      "delivery_profile_id": "fp_UkLWZg9DAJ",
      "delivery_zone_id": null,
      "calculator": {
        "type": "flat_rate",
        "preferences": {
          "amounts": {},
          "amount": "10.00",
          "currency": "USD"
        }
      }
    }
  ],
  "meta": {
    "page": 1,
    "limit": 25,
    "count": 2,
    "pages": 1,
    "from": 1,
    "to": 2,
    "in": 2,
    "previous": null,
    "next": null
  }
}

GET

api

seller

delivery_methods

Spree Seller SDK

import { createSellerClient } from '@spree/seller-sdk'

const client = createSellerClient({
  baseUrl: 'https://your-store.com',
  jwtToken: 'eyJhbGciOi...',
  sellerId: 'sel_UkLWZg9DAJ',
})

const { data: deliveryMethods } = await client.deliveryMethods.list()

{
  "data": [
    {
      "id": "dm_UkLWZg9DAJ",
      "name": "My courier",
      "code": "UPS_GROUND_117",
      "estimated_transit_business_days_min": null,
      "estimated_transit_business_days_max": null,
      "digital": false,
      "pickup": false,
      "pickup_point": false,
      "admin_name": null,
      "storefront_visible": true,
      "tracking_url": null,
      "created_at": "2026-01-15T12:00:00.000Z",
      "updated_at": "2026-01-15T12:00:00.000Z",
      "rules": [],
      "editable": true,
      "delivery_profile_id": "fp_UkLWZg9DAJ",
      "delivery_zone_id": null,
      "calculator": {
        "type": "flat_rate",
        "preferences": {
          "amounts": {},
          "amount": "10.00",
          "currency": "USD"
        }
      }
    },
    {
      "id": "dm_gbHJdmfrXB",
      "name": "Marketplace post",
      "code": "UPS_GROUND_118",
      "estimated_transit_business_days_min": null,
      "estimated_transit_business_days_max": null,
      "digital": false,
      "pickup": false,
      "pickup_point": false,
      "admin_name": null,
      "storefront_visible": true,
      "tracking_url": null,
      "created_at": "2026-01-15T12:00:00.000Z",
      "updated_at": "2026-01-15T12:00:00.000Z",
      "rules": [],
      "editable": false,
      "delivery_profile_id": "fp_UkLWZg9DAJ",
      "delivery_zone_id": null,
      "calculator": {
        "type": "flat_rate",
        "preferences": {
          "amounts": {},
          "amount": "10.00",
          "currency": "USD"
        }
      }
    }
  ],
  "meta": {
    "page": 1,
    "limit": 25,
    "count": 2,
    "pages": 1,
    "from": 1,
    "to": 2,
    "in": 2,
    "previous": null,
    "next": null
  }
}

Filters

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

Attribute	Kind	Predicates
`available_to_sellers`	True or false	`eq` `not_eq` `in` `not_in` `true` `false` `null`
`created_at`	Date and time	`eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null`
`id`	Prefixed ID	`eq` `not_eq` `in` `not_in` `null` `not_null`
`name`	Text	`eq` `not_eq` `in` `not_in` `cont` `i_cont` `not_cont` `start` `end` `null` `not_null` `present` `blank`
`seller_id`	Prefixed ID	`eq` `not_eq` `in` `not_in` `null` `not_null`
`storefront_visible`	True or false	`eq` `not_eq` `in` `not_in` `true` `false` `null`
`updated_at`	Date and time	`eq` `not_eq` `in` `not_in` `lt` `lteq` `gt` `gteq` `null` `not_null`

Sort by: available_to_sellers, created_at, id, name, seller_id, storefront_visible, updated_at. Prefix a field with - to sort descending.

Authorizations

Authorization

string

header

required

JWT token for an authenticated seller session (seller_api audience)

Headers

X-Spree-Seller-Id

string

required

Query Parameters

q[search]

string

Matches any of name (partial, case-insensitive).

page

integer

Page number

limit

integer

Records per page (max 100)

object

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

Response

200 - application/json

delivery methods listed

data

object[]

required

Show child attributes

API basics

Endpoints

Filters

Authorizations

Headers

Query Parameters

Response

​Filters

Authorizations

Headers

Query Parameters

Response

Filters