Services
Courier Services
Get Services by Carrier and Country
Returns the shipping service levels (e.g., ground, express, next-day) offered by a specific carrier in a given country. If no carrier is specified, returns all services for all carriers in that country.
When to use: Call this endpoint after selecting a carrier to populate the service-level dropdown in your shipping form, or to discover all available service tiers before requesting a quote.
Prerequisites:
- Valid JWT token in the Authorization header
- A valid two-letter ISO country code (e.g., MX, US, CO)
- Optionally, a carrier name obtained from the GET /carrier endpoint
Key behaviors:
- When carrier is omitted, returns services for all carriers in the specified country
- Each service object includes name (the service identifier used in quote/shipment requests), description, carrier, and active status
- The service name returned here is the exact value required by the Shipping API carrier_service field when creating a quote or shipment
- Only active services are returned by default
get/service
Query parameters
country_codestring required
Example:MX
Two-digit country code
carrierstring
Example:fedex
Carrier name (optional, if not provided returns all services for the country)
Response
Successful response
Example response
{
"data": [
{
"name": "ground",
"description": "FedEx Ground",
"carrier": "fedex",
"country_code": "MX",
"active": true
}
]
}