Label Management

Operations

Get Rate

Request

Retrieve shipping rates for a given package and address.
Rate limit: 600 requests per minute.

Security

ApiTokenAuth

Bodyapplication/jsonrequired

request_idstring

Unique identifier for this API request. Used for tracking, debugging, and issue resolution. Must be a string up to 64 characters.

Example: "req_20251024_abcd1234ef567890"

carrierobject

Carrier information

fromobjectrequired

Shipper's address

from.namestringrequired

Example: "full name"

from.companystring

Example: "company name"

from.emailstring

Example: "xxx@gmail.com"

from.phonestring

Shipper's phone number. Required for international shipments.

Example: 1237771234

from.streetstringrequired

Example: "xxx Grand Ave"

from.street2string(street2)

Optional secondary address line (e.g., Apt, Suite, Unit, Floor).

Example: "Apt 5B"

from.citystringrequired

Example: "Los Angeles"

from.statestringrequired

Example: "CA"

from.zipstringrequired

Example: 90018

from.countrystring(country)required

2-letter code for origin country. This field’s value will be an ISO 3166-1 two-digit code.

Example: "US"

toobjectrequired

Recipient's address

to.namestringrequired

Example: "full name"

to.companystring

Example: "company name"

to.emailstring

Example: "xxx@gmail.com"

to.phonestring

Recipient's phone number. Required for international shipments.

Example: 1237771234

to.streetstringrequired

Example: "xxx Grand Ave"

to.street2string(street2)

Optional secondary address line (e.g., Apt, Suite, Unit, Floor).

Example: "Apt 5B"

to.citystringrequired

Example: "Los Angeles"

to.statestringrequired

Example: "CA"

to.zipstringrequired

Example: 90018

to.countrystring(country)required

2-letter code for origin country. This field’s value will be an ISO 3166-1 two-digit code.

Example: "US"

to.residentialboolean

Specifies if the address is residential, which can impact the quoted shipping rate.

Example: true

shipmentsArray of objectsrequired

List of shipments

shipments[].lengthnumberrequired

Package length (inch)

Example: 6

shipments[].widthnumberrequired

Package width (inch)

Example: 6

shipments[].heightnumberrequired

Package height (inch)

Example: 6

shipments[].weightnumberrequired

Package weight (pound)

Example: 1

shipments[].packagesArray of strings

This field accepts carrier predefined packages. Please refer to the Predefined Carrier Packages Table for supported values.

Example: ["usps_small_flat_rate_box"]

shipments[].insurance_amountnumber(float)

Amount for insured shipment. Must be used in conjunction with insurance_provider.

Example: 120

shipments[].custom_print1string

Customized print on label.If the label itself supports custom printing content, this field will be printed onto the label.

Example: "custom print1"

shipments[].custom_print2string

Customized print on label.If the label itself supports custom printing content, this field will be printed onto the label.

Example: "custom print2"

shipments[].contentsArray of objects

List of items filed for customs (*required for international)

orderobject

Order information

optionsobject

Additional shipping options

recipient_tax_idsArray of objects

Recipient's tax information

curl -i -X POST \
  'https://api.shipsaving.com/api/rates/list?api_token=YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "request_id": "req_20251024_abcd1234ef567890",
    "carrier": {
      "carrier_token": "ca_36f49ebbe91d4006a6583e17ceeec500"
    },
    "from": {
      "name": "full name",
      "company": "company name",
      "email": "xxx@gmail.com",
      "phone": 1237771234,
      "street": "xxx Grand Ave",
      "street2": "Apt 5B",
      "city": "Los Angeles",
      "state": "CA",
      "zip": 90018,
      "country": "US"
    },
    "to": {
      "name": "full name",
      "company": "company name",
      "email": "xxx@gmail.com",
      "phone": 1237771234,
      "street": "xxx Grand Ave",
      "street2": "Apt 5B",
      "city": "Los Angeles",
      "state": "CA",
      "zip": 90018,
      "country": "US",
      "residential": true
    },
    "shipments": [
      {
        "length": 6,
        "width": 6,
        "height": 6,
        "weight": 1,
        "packages": [
          "usps_small_flat_rate_box"
        ],
        "insurance_amount": 120,
        "custom_print1": "custom print1",
        "custom_print2": "custom print2",
        "contents": [
          {
            "weight": 1,
            "description": "T-shirt",
            "quantity": 2,
            "value": 29.99,
            "hs_tariff_number": "610910",
            "origin_country": "US"
          }
        ]
      }
    ],
    "order": {
      "warehouse_name": "WH",
      "store_name": "string",
      "order_number": "string",
      "status": "awaiting",
      "service_type": "usps_ground_advantage",
      "signature": "NO_SIGNATURE",
      "insurance_provider": "SHIPSURANCE",
      "contents_type": "GIFT",
      "non_delivery_option": "RETURN",
      "eel_pfc_type": "ITN",
      "eel_pfc_code": "X20250627012345",
      "tax_ids": [
        {
          "tax_id_type": "TIN",
          "tax_id_number": "string",
          "tax_id_country": "US"
        }
      ]
    },
    "options": {
      "ship_date": "2024-02-07T10:55:56-08:00",
      "require_saturday_delivery": false,
      "require_hazmat": false,
      "hazmat_code": "dhlecs_lithium_metal_alloy_contained",
      "label_type": "png",
      "require_qr_code": false
    },
    "recipient_tax_ids": [
      {
        "tax_id_type": "TIN",
        "tax_id_number": "string"
      }
    ]
  }'

Responses

Rate list retrieved successfully

Bodyapplication/json

ratesArray of objects

List of shipment rates

Response

application/json

{
  "rates": [
    { … }
  ]
}

Buy Label

Request

Purchase a shipping label based on the provided rate ID.
Rate limit: 600 requests per minute.

Security

ApiTokenAuth

Query

rate_idstringrequired

Unique identifier of the shipping rate.

curl -i -X GET \
  'https://api.shipsaving.com/api/rates/buy?rate_id=string&api_token=YOUR_API_KEY_HERE'

Responses

Label successfully purchased.

Bodyapplication/json

packing_slip_numberinteger

Example: 109169

master_tracking_codestring

Example: ""

prefix_tracking_codestring

Example: ""

tracking_codestring

Example: "1ZY50G652000880500"

label_sizestring

Example: "4x6"

label_typestring

Example: "label"

lengthnumber

Example: 12

widthnumber

Example: 12

heightnumber

Example: 7

weightnumber

Example: 14.99

insurancenumber

Example: 0

insurance_feenumber

Example: 0

signaturestring

Example: "NO_SIGNATURE"

custom_print1string

Example: ""

custom_print2string

Example: ""

delivery_daysstring

Example: "1"

service_feenumber

Example: 0.05

ratenumber

Example: 10.87

rebatenumber

Example: 0

from_namestring

Sender's name

Example: "sender name"

from_companystring

Sender's company

Example: "ShipSaving, LLC"

from_phonestring

Sender's phone

Example: ""

from_streetstring

Sender's address line 1

Example: "769 Broadview Avenue"

from_street2string

Sender's address line 2

Example: ""

from_citystring

Sender's city

Example: "Toronto"

from_statestring

Sender's state or province

Example: "ON"

from_zipstring

Sender's postal code

Example: "M4K 2P7"

from_countrystring

Sender's country code

Example: "CA"

to_namestring

Recipient's name

Example: "ShipSaving"

to_companystring

Recipient's company

Example: "UPS Plus"

to_phonestring

Recipient's phone

Example: ""

to_streetstring

Recipient's address line 1

Example: "961 Broadview Avenue"

to_street2string

Recipient's address line 2

Example: ""

to_citystring

Recipient's city

Example: "Toronto"

to_statestring

Recipient's state or province

Example: "ON"

to_zipstring

Recipient's postal code

Example: "M4K 2P7"

to_countrystring

Recipient's country code

Example: "CA"

label_statusstring

Example: "completed"

shipment_idinteger

Example: 1245627

warehouse_namestring

Example: "WH"

store_namestring

Example: ""

order_numberstring

Example: ""

providerstring

Example: "shipsaving"

carrierstring

Example: "UPS"

servicestring

Example: "UPS_GROUND"

packagestring

Example: "PACKAGE"

published_ratenumber

Example: 34.53

label_urlArray of strings

Example: ["https://...../labels/2025-06-30/0231b055b64044e6b7e027874e915361_0.pdf"]

commercial_invoice_urlstring or null

Example: null

Response

application/json

{
  "packing_slip_number": 109169,
  "master_tracking_code": "",
  "prefix_tracking_code": "",
  "tracking_code": "1ZY50G652000880500",
  "label_size": "4x6",
  "label_type": "label",
  "length": 12,
  "width": 12,
  "height": 7,
  "weight": 14.99,
  "insurance": 0,
  "insurance_fee": 0,
  "signature": "NO_SIGNATURE",
  "custom_print1": "",
  "custom_print2": "",
  "delivery_days": "1",
  "service_fee": 0.05,
  "rate": 10.87,
  "rebate": 0,
  "from_name": "sender name",
  "from_company": "ShipSaving, LLC",
  "from_phone": "",
  "from_street": "769 Broadview Avenue",
  "from_street2": "",
  "from_city": "Toronto",
  "from_state": "ON",
  "from_zip": "M4K 2P7",
  "from_country": "CA",
  "to_name": "ShipSaving",
  "to_company": "UPS Plus",
  "to_phone": "",
  "to_street": "961 Broadview Avenue",
  "to_street2": "",
  "to_city": "Toronto",
  "to_state": "ON",
  "to_zip": "M4K 2P7",
  "to_country": "CA",
  "label_status": "completed",
  "shipment_id": 1245627,
  "warehouse_name": "WH",
  "store_name": "",
  "order_number": "",
  "provider": "shipsaving",
  "carrier": "UPS",
  "service": "UPS_GROUND",
  "package": "PACKAGE",
  "published_rate": 34.53,
  "label_url": [
    "https://...../labels/2025-06-30/0231b055b64044e6b7e027874e915361_0.pdf"
  ],
  "commercial_invoice_url": null
}

Directly Buy Label

Request

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. If multiple carriers of the same type exist, use the Get Rate API to retrieve options, then call the Buy Label API to complete the purchase.
Rate limit: 600 requests per minute.

Security

ApiTokenAuth

Bodyapplication/jsonrequired

request_idstring

Unique identifier for this API request. Used for tracking, debugging, and issue resolution. Must be a string up to 64 characters.

Example: "req_20251024_abcd1234ef567890"

carrierobject

Carrier information

fromobjectrequired

Shipper's address

from.namestringrequired

Example: "full name"

from.companystring

Example: "company name"

from.emailstring

Example: "xxx@gmail.com"

from.phonestring

Shipper's phone number. Required for international shipments.

Example: 1237771234

from.streetstringrequired

Example: "xxx Grand Ave"

from.street2string(street2)

Optional secondary address line (e.g., Apt, Suite, Unit, Floor).

Example: "Apt 5B"

from.citystringrequired

Example: "Los Angeles"

from.statestringrequired

Example: "CA"

from.zipstringrequired

Example: 90018

from.countrystring(country)required

2-letter code for origin country. This field’s value will be an ISO 3166-1 two-digit code.

Example: "US"

toobjectrequired

Recipient's address

to.namestringrequired

Example: "full name"

to.companystring

Example: "company name"

to.emailstring

Example: "xxx@gmail.com"

to.phonestring

Recipient's phone number. Required for international shipments.

Example: 1237771234

to.streetstringrequired

Example: "xxx Grand Ave"

to.street2string(street2)

Optional secondary address line (e.g., Apt, Suite, Unit, Floor).

Example: "Apt 5B"

to.citystringrequired

Example: "Los Angeles"

to.statestringrequired

Example: "CA"

to.zipstringrequired

Example: 90018

to.countrystring(country)required

2-letter code for origin country. This field’s value will be an ISO 3166-1 two-digit code.

Example: "US"

to.residentialboolean

Specifies if the address is residential, which can impact the quoted shipping rate.

Example: true

shipmentsArray of objectsrequired

List of shipments

shipments[].lengthnumberrequired

Package length (inch)

Example: 6

shipments[].widthnumberrequired

Package width (inch)

Example: 6

shipments[].heightnumberrequired

Package height (inch)

Example: 6

shipments[].weightnumberrequired

Package weight (pound)

Example: 1

shipments[].packagesArray of strings

This field accepts carrier predefined packages. Please refer to the Predefined Carrier Packages Table for supported values.

Example: ["usps_small_flat_rate_box"]

shipments[].insurance_amountnumber(float)

Amount for insured shipment. Must be used in conjunction with insurance_provider.

Example: 120

shipments[].custom_print1string

Customized print on label.If the label itself supports custom printing content, this field will be printed onto the label.

Example: "custom print1"

shipments[].custom_print2string

Customized print on label.If the label itself supports custom printing content, this field will be printed onto the label.

Example: "custom print2"

shipments[].contentsArray of objects

List of items filed for customs (*required for international)

orderobject

Order information

optionsobject

Additional shipping options

recipient_tax_idsArray of objects

Recipient's tax information

curl -i -X POST \
  'https://api.shipsaving.com/api/rates/buy-label?api_token=YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "request_id": "req_20251024_abcd1234ef567890",
    "carrier": {
      "carrier_token": "ca_36f49ebbe91d4006a6583e17ceeec500"
    },
    "from": {
      "name": "full name",
      "company": "company name",
      "email": "xxx@gmail.com",
      "phone": 1237771234,
      "street": "xxx Grand Ave",
      "street2": "Apt 5B",
      "city": "Los Angeles",
      "state": "CA",
      "zip": 90018,
      "country": "US"
    },
    "to": {
      "name": "full name",
      "company": "company name",
      "email": "xxx@gmail.com",
      "phone": 1237771234,
      "street": "xxx Grand Ave",
      "street2": "Apt 5B",
      "city": "Los Angeles",
      "state": "CA",
      "zip": 90018,
      "country": "US",
      "residential": true
    },
    "shipments": [
      {
        "length": 6,
        "width": 6,
        "height": 6,
        "weight": 1,
        "packages": [
          "usps_small_flat_rate_box"
        ],
        "insurance_amount": 120,
        "custom_print1": "custom print1",
        "custom_print2": "custom print2",
        "contents": [
          {
            "weight": 1,
            "description": "T-shirt",
            "quantity": 2,
            "value": 29.99,
            "hs_tariff_number": "610910",
            "origin_country": "US"
          }
        ]
      }
    ],
    "order": {
      "warehouse_name": "WH",
      "store_name": "string",
      "order_number": "string",
      "status": "awaiting",
      "service_type": "usps_ground_advantage",
      "signature": "NO_SIGNATURE",
      "insurance_provider": "SHIPSURANCE",
      "contents_type": "GIFT",
      "non_delivery_option": "RETURN",
      "eel_pfc_type": "ITN",
      "eel_pfc_code": "X20250627012345",
      "tax_ids": [
        {
          "tax_id_type": "TIN",
          "tax_id_number": "string",
          "tax_id_country": "US"
        }
      ]
    },
    "options": {
      "ship_date": "2024-02-07T10:55:56-08:00",
      "require_saturday_delivery": false,
      "require_hazmat": false,
      "hazmat_code": "dhlecs_lithium_metal_alloy_contained",
      "label_type": "png",
      "require_qr_code": false
    },
    "recipient_tax_ids": [
      {
        "tax_id_type": "TIN",
        "tax_id_number": "string"
      }
    ]
  }'

Responses

Label successfully purchased

Bodyapplication/json

packing_slip_numberinteger

Example: 109169

master_tracking_codestring

Example: ""

prefix_tracking_codestring

Example: ""

tracking_codestring

Example: "1ZY50G652000880500"

label_sizestring

Example: "4x6"

label_typestring

Example: "label"

lengthnumber

Example: 12

widthnumber

Example: 12

heightnumber

Example: 7

weightnumber

Example: 14.99

insurancenumber

Example: 0

insurance_feenumber

Example: 0

signaturestring

Example: "NO_SIGNATURE"

custom_print1string

Example: ""

custom_print2string

Example: ""

delivery_daysstring

Example: "1"

service_feenumber

Example: 0.05

ratenumber

Example: 10.87

rebatenumber

Example: 0

from_namestring

Sender's name

Example: "sender name"

from_companystring

Sender's company

Example: "ShipSaving, LLC"

from_phonestring

Sender's phone

Example: ""

from_streetstring

Sender's address line 1

Example: "769 Broadview Avenue"

from_street2string

Sender's address line 2

Example: ""

from_citystring

Sender's city

Example: "Toronto"

from_statestring

Sender's state or province

Example: "ON"

from_zipstring

Sender's postal code

Example: "M4K 2P7"

from_countrystring

Sender's country code

Example: "CA"

to_namestring

Recipient's name

Example: "ShipSaving"

to_companystring

Recipient's company

Example: "UPS Plus"

to_phonestring

Recipient's phone

Example: ""

to_streetstring

Recipient's address line 1

Example: "961 Broadview Avenue"

to_street2string

Recipient's address line 2

Example: ""

to_citystring

Recipient's city

Example: "Toronto"

to_statestring

Recipient's state or province

Example: "ON"

to_zipstring

Recipient's postal code

Example: "M4K 2P7"

to_countrystring

Recipient's country code

Example: "CA"

label_statusstring

Example: "completed"

shipment_idinteger

Example: 1245627

warehouse_namestring

Example: "WH"

store_namestring

Example: ""

order_numberstring

Example: ""

providerstring

Example: "shipsaving"

carrierstring

Example: "UPS"

servicestring

Example: "UPS_GROUND"

packagestring

Example: "PACKAGE"

published_ratenumber

Example: 34.53

label_urlArray of strings

Example: ["https://...../labels/2025-06-30/0231b055b64044e6b7e027874e915361_0.pdf"]

commercial_invoice_urlstring or null

Example: null

Response

application/json

{
  "packing_slip_number": 109169,
  "master_tracking_code": "",
  "prefix_tracking_code": "",
  "tracking_code": "1ZY50G652000880500",
  "label_size": "4x6",
  "label_type": "label",
  "length": 12,
  "width": 12,
  "height": 7,
  "weight": 14.99,
  "insurance": 0,
  "insurance_fee": 0,
  "signature": "NO_SIGNATURE",
  "custom_print1": "",
  "custom_print2": "",
  "delivery_days": "1",
  "service_fee": 0.05,
  "rate": 10.87,
  "rebate": 0,
  "from_name": "sender name",
  "from_company": "ShipSaving, LLC",
  "from_phone": "",
  "from_street": "769 Broadview Avenue",
  "from_street2": "",
  "from_city": "Toronto",
  "from_state": "ON",
  "from_zip": "M4K 2P7",
  "from_country": "CA",
  "to_name": "ShipSaving",
  "to_company": "UPS Plus",
  "to_phone": "",
  "to_street": "961 Broadview Avenue",
  "to_street2": "",
  "to_city": "Toronto",
  "to_state": "ON",
  "to_zip": "M4K 2P7",
  "to_country": "CA",
  "label_status": "completed",
  "shipment_id": 1245627,
  "warehouse_name": "WH",
  "store_name": "",
  "order_number": "",
  "provider": "shipsaving",
  "carrier": "UPS",
  "service": "UPS_GROUND",
  "package": "PACKAGE",
  "published_rate": 34.53,
  "label_url": [
    "https://...../labels/2025-06-30/0231b055b64044e6b7e027874e915361_0.pdf"
  ],
  "commercial_invoice_url": null
}

Void Label

Request

Voids a purchased shipping label using the shipment’s tracking number.
Rate limit: 600 requests per minute.

Security

ApiTokenAuth

Bodyapplication/jsonrequired

tracking_codestringrequired

Shipment tracking number

curl -i -X POST \
  'https://api.shipsaving.com/api/shipments/void?api_token=YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "tracking_code": "9435811899562089111300"
  }'

Responses

Label voided successfully

Bodyapplication/json

tracking_codestring

The tracking number of the voided label

Response

application/json

{
  "tracking_code": "9435811899562089111300"
}

Order Management

Operations

Address Verification

Operations

SCAN Form

Operations

Carrier Management

Operations

Account Management

Operations

ShipSaving Legacy API (v1)CopyCopy for LLMCopy page as Markdown for LLMsView as MarkdownOpen this page as MarkdownOpen in ChatGPTGet insights from ChatGPTOpen in ClaudeGet insights from ClaudeConnect to CursorInstall MCP server on CursorConnect to VS CodeInstall MCP server on VS Code