# Shipments

## Get Rates

 - [POST /rates](https://docs.stallion.ca/v4/openapi/shipments/getrates.md): Validates shipment details and returns all available rates.

## Get Shipments

 - [GET /shipments](https://docs.stallion.ca/v4/openapi/shipments/getshipments.md): Get the list of paginated shipments by different search parameters.

## Create Shipment

 - [POST /shipments](https://docs.stallion.ca/v4/openapi/shipments/createshipment.md): Create a shipment and return the postage label.

## Track Shipment

 - [GET /track](https://docs.stallion.ca/v4/openapi/shipments/track.md): Fetch a shipment's tracking details by different search parameters. Send at least one of ship_code, tracking_code or order_id; omitting all three is a 422.

Lookups are scoped to the shipments your account owns. An identifier that belongs to another account is reported exactly like one that does not exist — 404 with No shipment found — so the response cannot be used to discover whether someone else's tracking number exists. A small allowlist of Stallion-operated tracking consumers (the stallion.ca tracking form, AfterShip) may resolve ship_code / tracking_code across accounts; order_id stays owner-scoped even for them, because order IDs are merchant-local and matched as a substring. If you integrate a cross-account tracking surface, ask Stallion support rather than expecting the unscoped behaviour this endpoint had before 2026-08-24.

## Track Shipment by Code

 - [GET /shipments/{ship_code}/track](https://docs.stallion.ca/v4/openapi/shipments/getshipmenttracking.md): Fetch a shipment's tracking details by a single identifier in the path. The {ship_code} segment matches either the ship_code or the tracking_code, so a carrier tracking number works here too. The response body is the same shape GET /track returns.

Scoped to the shipments your account owns, with the same trusted-consumer allowlist described on GET /track. An identifier belonging to another account returns 404 with No shipment found, identical to one that does not exist.

## Get Shipment

 - [GET /shipments/{ship_code}](https://docs.stallion.ca/v4/openapi/shipments/gettracking.md): Get a shipment

## Void Shipment

 - [GET /shipments/{ship_code}/void](https://docs.stallion.ca/v4/openapi/shipments/voidshipment.md): Requests a void for a shipment with the provided id.