---
title: "Get Services by Carrier and Country"
method: GET
path: "/service"
tags: ["Services", "Courier Services"]
---

# Get Services by Carrier and Country

`GET /service`

## Request

- Base URL: `https://queries.test.envia.com`
- URL: `https://queries.test.envia.com/service`
- Auth: HTTP bearer

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

## Query parameters

- `country_code` string, required
- `carrier` string

## Response `200`

Successful response

- object
  - `data` object[]: List of services
    - `name` string: Service name
    - `description` string: Service description
    - `carrier` string: Carrier name
    - `country_code` string: Country code
    - `active` boolean: Whether the service is active

---

[API](https://skmtc.dev/envia/apis/envia-queries-api.md) - [All operations](https://skmtc.dev/envia/apis/envia-queries-api/llms.txt) - [OpenAPI document](https://skmtc.dev/envia/apis/envia-queries-api/revisions/56f601a52f3f?raw)