Skip to content
docs
ES
Fulfillment & ShippingMethods

List shipping methods

Lists shipping methods with search and active, checkout, type, and profile filters. With onlyAvailable enabled, filters by location capability; postalCode applies only to local-delivery coverage.

GET/v1/shipping/methods
Requires an access token with the settings:read permission.

Query Parameters

limit?integer

Maximum number of results to return.

Formatint32
cursor?string

Cursor from the previous response. Omit it on the first page.

search?string

Free-text search.

sortBy?string

Field to sort by.

sortDirection?string

Sort direction: asc or desc.

Value in

  • "asc"
  • "desc"
isActive?boolean

Only active items.

visibleInCheckout?boolean
onlyAvailable?boolean
postalCode?string
type?string

Only this type.

Value in

  • "regular"
  • "express"
  • "sameDay"
  • "pickup"
  • "localDelivery"
shippingProfileId?string

Identifier of the shipping profile.

Header Parameters

x-Store-Id?string

Store the request acts on. Not needed when the token is bound to a store.

Authorization*string

OAuth 2.0 bearer token.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://api.ecomiq.pe/api/v1/shipping/methods" \  -H "x-Store-Id: <store-id>" \  -H "Authorization: Bearer <token>"
{  "data": [    {      "id": "7204558912004321806",      "storeId": "7204558912004327977",      "sellerId": "7204558912004323447",      "name": "Envío estándar",      "displayName": "Envío estándar",      "type": "regular",      "isActive": true,      "visibleInCheckout": true,      "sortOrder": 1,      "shippingProfileId": "7204558912004329819",      "minOrderAmount": 178,      "maxOrderAmount": 178,      "minWeight": 0.3,      "maxWeight": 0.3,      "allowSplitFulfillment": false,      "availableDays": [        "monday"      ],      "basePrice": 89,      "currency": "PEN",      "estimatedDeliveryDays": 30,      "estimatedDeliveryHours": 1,      "metadata": {},      "connectionId": "7204558912004329542",      "pickupPointIds": [        "7204558912004324876"      ],      "rates": [        {          "id": "7204558912004321806",          "storeId": "7204558912004327977",          "sellerId": "7204558912004323447",          "shippingMethodId": "7204558912004325207",          "type": "flat",          "price": 89,          "currency": "PEN",          "minOrderPrice": 89,          "maxOrderPrice": 89,          "postalCodes": [            "15074"          ],          "isActive": true,          "description": "Polo de algodón pima para uso diario.",          "discountPercentage": 10,          "zoneCode": "LIMA",          "minWeight": 0.3,          "maxWeight": 0.3,          "minValue": 1,          "maxValue": 1,          "basePrice": 89,          "pricePerKg": 89,          "pricePerUnit": 89,          "taxIncluded": false,          "surcharge": 1,          "metadata": {},          "createdOn": "2026-09-28T15:30:00Z",          "updatedOn": "2026-09-28T15:30:00Z",          "baseLanguage": "Envío estándar",          "translations": {            "key": {              "description": "Polo de algodón pima para uso diario."            }          }        }      ],      "createdOn": "2026-09-28T15:30:00Z",      "updatedOn": "2026-09-28T15:30:00Z",      "baseLanguage": "Envío estándar",      "translations": {        "key": {          "displayName": "Envío estándar"        }      }    }  ],  "hasNextPage": true,  "nextCursor": "eyJpZCI6IjcyMDQ1NTg5MTIwMDQzMjUzMDEifQ",  "totalCount": 24}