list_delivery_options

Updated August 7, 20261 min read

List delivery options for a tenant via GET /delivery-options. Pagination starts at page 1. Use select (json-mask) for response trimming.

Parameters

NameTypeRequiredDescription
tenantIdstringYesThe tenant to list.
selectstringNojson-mask — useful for trimming the response.
merchantstring | string[]NoFilter by one or more merchants.
statusstring | string[]NoValues: ACTIVE, INACTIVE.
carrier_account_idstring | string[]NoFilter by assigned carrier account.
location_idstring | string[]NoFilter by fulfillment / collection location.
customer_countrystring | string[]NoFilter by the customer condition's country.
search_stringstringNoFree-text search.
page, page_sizestringNoPagination — page starts at 1.
paginationbooleanNoSet false to skip pagination.

Returns

items — an array of delivery option records (id, code, name, delivery method, status, merchant, shipping fee, conditions) — plus pagination with total and page.

Example agent prompt

"Which delivery options does the ACME merchant offer?"

list_delivery_options(
  tenantId="…",
  merchant="ACME",
  status="ACTIVE",
  select="items(id,code,name,delivery_method,status)"
)