---
title: "Get Containers"
method: GET
path: "/v4/containers"
tags: ["Containers"]
---

# Get Containers

`GET /v4/containers`

Retrieves a list of shipping containers associated with a specific carrier and shipping location. With this endpoint, you can access information about the containers used for shipments, ensuring effective logistics management.

## Query parameters

- `carrierCode` string
- `shippingLocationId` string
- `pageSize` integer
- `pageNumber` integer
- `sortBy` 'CreatedDateUtc' | 'ContainerId' | 'CarrierCode' | 'ShippingLocationAlias' | 'TotalWeight' | 'TotalShipments' | 'TotalPackages' — Sort By
- `sortDir` 'Ascending' | 'Descending' — Order Direction
- `containerStatus` 'Active' | 'Manifested' | 'All' — Container Status

## Response `200`

Returns a list of containers.

- ContainersPagedResponse — The paged response containing the entities for the requested page only, and the total number available.
  - `Containers` Container[], required — An array containing all shipping containers associated with the carrier and/or shipping location requested for the specific page only. Each object contains details about individual containers, such as identifiers and associated shipment data.
    - `ContainerId` string, nullable — An identifier for the shipping container, important for managing cargo and logistics at scale.
    - `ContainerStatus` 'Active' | 'Manifested' — Indicates the current status of the container, providing information on whether it is active or manifested.
    - `CreatedDateUtc` string, date-time — A timestamp indicating when each container was created, formatted in Coordinated Universal Time (UTC). This allows users to track the age and relevance of their container records.
    - `CarrierCode` string, nullable — The unique identifier for the carrier associated with each container. This confirms which carrier is linked to the container, essential for logistics tracking.
    - `ShippingLocationId` string, nullable — A unique identifier for the shipping location assigned by the system from which the container originates. With it, you can track and manage containers by a particular location.
    - `ShippingLocationAlias` string, nullable — A unique user-defined identifier for the shipping location associated with the container, making it easier to reference and identify locations.
    - `TotalWeight` number, double — The total weight of the shipments contained within the shipping container. This value is essential for understanding the logistics and capacity of the container.
    - `WeightUnitOfMeasure` 'KG' | 'Grams' — The unit of measurement for the weight provided, such as **TotalWeight**, indicating whether the weight is specified in kilograms (KG) or grams (G), ensuring clarity for shipping calculations. <br /> <br />***Note**: By default, this field is set to KG.*
    - `TotalShipments` integer — The total number of shipments contained within the specified container. This field helps users understand the shipping capacity and complexity of the container.
    - `TotalPackages` integer — An integer representing the total number of packages contained within the shipments linked to the container. This information helps users understand the volume of packages being transported.
  - `TotalCount` integer, required — An integer indicating the total number of containers that match the query criteria. This count provides you with an overview of how many container records are available in the system based on the filters applied.

## Other responses

- `400` — Invalid request response.
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.dev/proshipping/apis/pro-shipping-core-api.md) · [All operations](https://skmtc.dev/proshipping/apis/pro-shipping-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/proshipping/pro-shipping-core-api/revisions/ae5fc5e90109/schema)