# Stallion Express API

Access to the sandbox environment can be provided upon request. (Not all rates are available in the Sandbox environment). API token can be found under "Account Settings > API Token".

Version: 3.0

## Servers

Production server (uses live data)
```
https://ship.stallionexpress.ca/api/v3
```

Sandbox server (uses test data)
```
https://sandbox.stallionexpress.ca/api/v3
```

## Security

### bearerAuth

Type: http
Scheme: bearer

## Download OpenAPI description

[Stallion Express API](https://stallionexpress.redocly.app/_bundle/stallionexpress-v3.yaml)

## Postage Types

### Get Postage Types

 - [GET /postage-types](https://stallionexpress.redocly.app/stallionexpress-v3/postage-types/getpostagetypes.md): Get a list of all available postage types

## Shipments

### Get Rates

 - [POST /rates](https://stallionexpress.redocly.app/stallionexpress-v3/shipments/getrates.md): Validates shipment details and returns all available rates.

### Get Shipments

 - [GET /shipments](https://stallionexpress.redocly.app/stallionexpress-v3/shipments/getshipments.md): Get the list of paginated shipments by different search parameters.

### Create Shipment

 - [POST /shipments](https://stallionexpress.redocly.app/stallionexpress-v3/shipments/createshipment.md): Create a shipment and return the postage label.

### Create Return Label

 - [POST /shipments/return-label](https://stallionexpress.redocly.app/stallionexpress-v3/shipments/createreturnlabel.md): Create the return label for a previous shipment.

### Track a Shipment

 - [GET /track](https://stallionexpress.redocly.app/stallionexpress-v3/shipments/track.md): Fetch a shipment tracking details by different search parameters

### Get Shipment

 - [GET /shipments/{ship_code}](https://stallionexpress.redocly.app/stallionexpress-v3/shipments/gettracking.md): Get a shipment

### Void a Shipment

 - [GET /shipments/{ship_code}/void](https://stallionexpress.redocly.app/stallionexpress-v3/shipments/voidshipment.md): Requests a void for a shipment with the provided id.

## Batches

### Create a batch

 - [POST /batches](https://stallionexpress.redocly.app/stallionexpress-v3/batches/createbatch.md): Creates a new batch to be used when creating shipments.

## Locations

### Get Locations

 - [GET /locations](https://stallionexpress.redocly.app/stallionexpress-v3/locations/getlocations.md): Gets a list of all current Stallion Express locations.

## Credits

### Get Credits

 - [GET /credits](https://stallionexpress.redocly.app/stallionexpress-v3/credits/getcredits.md): Return the current account balance

### Add Credits

 - [POST /credits](https://stallionexpress.redocly.app/stallionexpress-v3/credits/addcredits.md): Add credits using hte account's default credit card