List all shipping methods

GET https://api.tamio.com/v2/shippings/list

Returns a paginated list of shipping methods. Supports filtering by tax configuration, destination countries, and free-text search. Results can be sorted by title, price, or currency.

Query Parameters

page integer*

Page number for pagination.

per_page integer*

Number of shipping methods per page.

order string

Sort direction.

ascdesc

sort_by string

Field to sort by.

titlepricecurrency

filter string

Free-text search across shipping method names or descriptions.

tax_id string

Filter by tax configuration UUID.

countries array of string

Filter by destination country codes (ISO 3166-1 alpha-2).

Responses

200 Paginated list of shipping methods

Paginated list of shipping methods

status integer

total_results integer

shippings array of Shipping

id string

Unique identifier of the shipping method.

label string

Display name.

object string

Object type identifier.

currency string

ISO currency code.

destination array of string

Country/region codes where shipping is available.

price integer

Price in smallest currency unit (e.g. cents).

has_bundling boolean

Whether bundling rules are configured.

postcodes array of string

Postcode restrictions, or null.

states array of string

State/province restrictions, or null.

bundling_rules array of BundlingRule

Quantity-based pricing tiers.

type string

Rule type.

rangemax

cost integer

Cost in smallest currency unit.

cost_rule string

Cost application method.

unitfixed

max integer

Maximum quantity for max-type rules.

from integer

Starting quantity for range-type rules.

to integer

Ending quantity for range-type rules.

active boolean

Whether the shipping method is active.

has_notes boolean

Whether associated notes exist.

401 Missing or invalid API key

Create a shipping method

/shippings/list

1 const response = await fetch("https://api.tamio.com/v2/shippings/list", {
2   headers: {
3     "Authorization": "Bearer YOUR_API_KEY",
4     "Accept": "application/json"
5   }
6 });
7 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/shippings/list")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Get.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 
13 response = https.request(request)
14 puts response.read_body

Responses

{
  "status": 200,
  "total_results": 12,
  "shippings": [
    {
      "id": "999e4567-e89b-12d3-a456-426614174000",
      "label": "Standard Delivery",
      "object": "shipping",
      "currency": "EUR",
      "destination": [
        "US",
        "GB",
        "DE"
      ],
      "price": 500,
      "has_bundling": true,
      "postcodes": [
        "90210",
        "10001"
      ],
      "states": [
        "CA",
        "NY"
      ],
      "bundling_rules": [
        {
          "type": "range",
          "cost": 200,
          "cost_rule": "fixed",
          "max": null,
          "from": 2,
          "to": 5
        }
      ],
      "active": true,
      "has_notes": false
    }
  ]
}

1	const response = await fetch("https://api.tamio.com/v2/shippings/list", {
2	headers: {
3	"Authorization": "Bearer YOUR_API_KEY",
4	"Accept": "application/json"
5	}
6	});
7	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/shippings/list")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Get.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12
13	response = https.request(request)
14	puts response.read_body