# ShipSaving Legacy API

Version: v1
License: Apache 2.0

## Servers

Production server
```
https://api.shipsaving.com
```

## Security

### ApiTokenAuth

Type: apiKey
In: query
Name: api_token

## Download OpenAPI description

 - [ShipSaving Legacy API](https://docs.shipsaving.com/_bundle/v1/openapi.yaml)

## Label Management

 - [POST /api/rates/list](https://docs.shipsaving.com/v1/openapi/label-management/getratelist.md): Retrieve shipping rates for a given package and address. </br> **Rate limit:** 600 requests per minute.
 - [GET /api/rates/buy](https://docs.shipsaving.com/v1/openapi/label-management/purchaselabel.md): Purchase a shipping label based on the provided rate ID.</br> **Rate limit:** 600 requests per minute.
 - [POST /api/rates/buy-label](https://docs.shipsaving.com/v1/openapi/label-management/directlybuylabel.md): Purchases a shipping label directly without comparing multiple carrier options. This endpoint is applicable only when there is a single carrier configured for each carrier type in the user's account.
 - [POST /api/shipments/void](https://docs.shipsaving.com/v1/openapi/label-management/voidlabel.md): Voids a purchased shipping label using the shipment’s tracking number. </br> **Rate limit:** 600 requests per minute.
## Order Management

 - [POST /api/orders/create](https://docs.shipsaving.com/v1/openapi/order-management/createorders.md): Creates a new order in the ShipSaving system. Typically used to pre-create orders before generating shipping labels.</br> **Rate limit:** 300 requests per minute.
 - [GET /api/shipments/get](https://docs.shipsaving.com/v1/openapi/order-management/checkorderlabels.md): Retrieves the shipment label details for a specified store and order number. Applicable only to orders with a purchased shipping label.</br> **Rate limit:** 120 requests per minute.
 - [DELETE /api/orders/delete](https://docs.shipsaving.com/v1/openapi/order-management/deleteorder.md): Deletes an existing order from the ShipSaving system by specifying both the store name and order number. This action is irreversible and will permanently remove the order and its associated data.</br>
## Address Verification

 - [POST /api/addresses/verify](https://docs.shipsaving.com/v1/openapi/address-verification/verifyaddress.md): Verifies and standardizes an address based on the provided details. This API checks for errors and returns suggestions or corrections. </br> **Rate limit:** 600 requests per minute.
## SCAN Form

 - [POST /api/shipments/scan-forms/create](https://docs.shipsaving.com/v1/openapi/scan-form/createscanforms.md): Creates a USPS SCAN Form for the provided list of shipment tracking codes. Only applicable to shipments with valid USPS tracking numbers. </br> **Rate limit:** 60 requests per minute.
 - [POST /api/shipments/scan-forms/dhl/ecommerce/create](https://docs.shipsaving.com/v1/openapi/scan-form/createecsscanforms.md): Initiates the asynchronous creation of a DHL eCommerce SCAN Form. Returns a request ID that can be used with the Get DHL eCommerce SCAN Form endpoint to retrieve the final manifest PDF. </br> **Rate
 - [GET /api/shipments/scan-forms/dhl/ecommerce/get](https://docs.shipsaving.com/v1/openapi/scan-form/getecsscanforms.md): Returns the DHL eCommerce SCAN Form PDF URL based on the request ID from the creation endpoint. </br> **Rate limit:** 60 requests per minute.
## Carrier Management

 - [GET /api/carrier-account/list](https://docs.shipsaving.com/v1/openapi/carrier-management/getcarrieraccountlist.md): Retrieves the list of carrier accounts associated with the authenticated API token.</br> **Rate limit:** 60 requests per minute.
## Account Management

 - [GET /api/balance](https://docs.shipsaving.com/v1/openapi/account-management/querybalance.md): Retrieves real-time account balance in USD.</br> **Rate limit:** 60 requests per minute.