Carriers and services

Read the service catalog and use exact codes when selecting a rate.

The catalog contains the services that SendIt can show in rate results. It is read-only: use it to populate selectors and validate a carrier and service combination.

Carriers Beta

The effective list for a route is the rates[] array returned when you rate a shipment.

Endpoints

List services

curl "https://api.sendit.mx/v1/carrier-services?carrierCode=FEDEX" \
  -H "X-API-Key: sk_test_..."

{
  "success": true,
  "data": [
    {
      "id": "cs_fedex_priority_overnight",
      "carrierCode": "FEDEX",
      "serviceCode": "PRIORITY_OVERNIGHT",
      "serviceName": "FedEx Priority Overnight",
      "serviceLevel": "overnight",
      "isInternational": false,
      "maxWeightKg": "68.00",
      "maxDimensionCm": "274.00",
      "minDays": 1,
      "maxDays": 1,
      "enabled": true,
      "countries": ["MX"]
    }
  ]
}

Get one exact service

curl https://api.sendit.mx/v1/carrier-services/FEDEX/PRIORITY_OVERNIGHT \
  -H "X-API-Key: sk_test_..."

The response contains the same service object as the list response.

Select by exact code

Each rate carries two different fields:

Send carrierCode + serviceCode to select an exact service when creating and purchasing a shipment. When buying an existing rate through the labels endpoint, send its rateId. Codes that are not yet in the catalog do not appear in customer rates.

Handle errors