List delivery methods
const options = {
method: 'GET',
headers: {'X-Spree-Seller-Id': '<x-spree-seller-id>', Authorization: 'Bearer <token>'}
};
fetch('http://{defaultHost}/api/v3/seller/delivery_methods', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request GET \
--url http://{defaultHost}/api/v3/seller/delivery_methods \
--header 'Authorization: Bearer <token>' \
--header 'X-Spree-Seller-Id: <x-spree-seller-id>'{
"data": [
{
"id": "dm_UkLWZg9DAJ",
"name": "My courier",
"code": "UPS_GROUND_73",
"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",
"calculator_preferences": {
"amounts": {},
"amount": "10.0",
"currency": "USD"
}
},
{
"id": "dm_gbHJdmfrXB",
"name": "Marketplace post",
"code": "UPS_GROUND_74",
"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",
"calculator_preferences": {
"amounts": {},
"amount": "10.0",
"currency": "USD"
}
}
],
"meta": {
"page": 1,
"limit": 25,
"count": 2,
"pages": 1,
"from": 1,
"to": 2,
"in": 2,
"previous": null,
"next": null
}
}List delivery methods
How this seller’s goods can ship: the methods they created themselves, plus any the marketplace shares with its sellers.
A shared marketplace method comes back with editable: false — it is
listed so the seller can see what already ships their goods, and every
write against it is a 404.
GET
/
api
/
v3
/
seller
/
delivery_methods
List delivery methods
const options = {
method: 'GET',
headers: {'X-Spree-Seller-Id': '<x-spree-seller-id>', Authorization: 'Bearer <token>'}
};
fetch('http://{defaultHost}/api/v3/seller/delivery_methods', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request GET \
--url http://{defaultHost}/api/v3/seller/delivery_methods \
--header 'Authorization: Bearer <token>' \
--header 'X-Spree-Seller-Id: <x-spree-seller-id>'{
"data": [
{
"id": "dm_UkLWZg9DAJ",
"name": "My courier",
"code": "UPS_GROUND_73",
"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",
"calculator_preferences": {
"amounts": {},
"amount": "10.0",
"currency": "USD"
}
},
{
"id": "dm_gbHJdmfrXB",
"name": "Marketplace post",
"code": "UPS_GROUND_74",
"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",
"calculator_preferences": {
"amounts": {},
"amount": "10.0",
"currency": "USD"
}
}
],
"meta": {
"page": 1,
"limit": 25,
"count": 2,
"pages": 1,
"from": 1,
"to": 2,
"in": 2,
"previous": null,
"next": null
}
}Authorizations
JWT token for an authenticated seller session (seller_api audience)
Headers
Was this page helpful?
⌘I

