# UPS 4th Party API Integration

This document outlines the integration of ShipSaving APIs under the UPS 4th party account model, including account creation, label generation, and other workflows. 


Version: v1
License: Apache 2.0

## Servers

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

Sandbox server
```
https://ps-api.shipsaving.us
```

## Security

### BearerAuth

[object Object]

Type: http
Scheme: bearer

### ApiTokenAuth

[object Object]

Type: apiKey
In: query
Name: api_token

## Download OpenAPI description

 - [UPS 4th Party API Integration](https://docs.shipsaving.com/_bundle/v1/ps_openapi.yaml)

## Label Management

 - [POST /api/rates/list](https://docs.shipsaving.com/v1/ps_openapi/label-management/getratelist.md): Retrieve available shipping rates for the given package dimensions, weight, and origin/destination addresses. Returns rates across all active carrier accounts, sorted by price.
 - [GET /api/rates/buy](https://docs.shipsaving.com/v1/ps_openapi/label-management/buylabel.md): Purchase a shipping label using the `rate_id` returned by **Get Rates**.
 - [POST /api/shipments/void](https://docs.shipsaving.com/v1/ps_openapi/label-management/voidlabel.md): Void a previously purchased shipping label by tracking number.
 - [GET /api/shipments/status](https://docs.shipsaving.com/v1/ps_openapi/label-management/getshipmentstatus.md): Retrieve the carrier billing state and void state of a previously purchased label, looked up by tracking number.
## Address Validation

 - [POST /api/addresses/verify](https://docs.shipsaving.com/v1/ps_openapi/address-validation/verifyaddress.md): Validate and standardize a US shipping address against the address-service registry. Only the United States and its territories (PR, GU, VI, MP, MH, AS) are accepted — all other countries are rejected
## Carrier Management

 - [POST /api/carrier/create_ups_ghost_account](https://docs.shipsaving.com/v1/ps_openapi/carrier-management/createupsghostaccount.md): Create a UPS shipper account on behalf of a merchant through ShipSaving, without requiring manual registration on the UPS website. The account is automatically linked to the merchant's ShipSaving comp
## Account Management

 - [GET /api/balance](https://docs.shipsaving.com/v1/ps_openapi/account-management/querybalance.md): Retrieves real-time account balance in USD.