---
title: "Get Carriers by Country"
method: GET
path: "/carrier"
tags: ["Carriers"]
---

# Get Carriers by Country

`GET /carrier`

## Request

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

Returns the list of shipping carriers that are currently active and available for a given country. Use this endpoint to discover which carriers you can use when creating shipments.

**When to use:** Call this endpoint to populate carrier selection dropdowns in your shipping forms, or to programmatically determine which carriers are available before requesting a shipping quote.

**Prerequisites:**
- Valid JWT token in the Authorization header
- A valid two-letter ISO country code (e.g., `MX`, `US`, `CO`)

**Key behaviors:**
- Returns only carriers that are currently active for the specified country
- Each carrier object includes the carrier `name` (used as identifier in other API calls), a human-readable `description`, and an `active` status flag
- The carrier `name` value returned here is the exact identifier you must pass to the `/service` endpoint and the Shipping API when creating shipments

## Query parameters

- `country_code` string, required

## Response `200`

Successful response

- object
  - `data` object[]: List of carriers
    - `id` integer: Carrier id. Use it as `carrier_id` in `GET /carrier-action/{carrier_id}` and as `carrierId` in `POST /branches/{carrier}/{country_code}` live lookups.
    - `name` string: Carrier name
    - `description` string: Carrier description
    - `country_code` string: Country code
    - `active` boolean: Whether the carrier 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)