Skip to content

ShipStation V1 API (Legacy) (1.0.0)

The ShipStation V1 API (Legacy) provides comprehensive functionality for managing orders, shipments, carriers, and more within the ShipStation platform.

Getting Started

New integrations should use ShipStation API V2 whenever possible. This V1 API is maintained for existing integrations.

Download OpenAPI description
Languages
Servers
Mock server
https://docs.shipstation.com/_mock/apis/shipstation-v1/openapi/
Production Server
https://ssapi.shipstation.com/

Accounts

Account management and tag operations

Operations

Carriers

Carrier information and package/service listings

Operations

Customers

Customer management

Operations

Fulfillments

Fulfillment operations

Operations

Orders

Order management and operations

Operations

Products

Product catalog management

Operations

List products

Request

Obtains a list of products that match the specified criteria

Security
basicAuth
Query
skustring

Returns products that match the specified SKU

namestring

Returns products that match the specified product name

productCategoryIdinteger

Returns products that match the specified productCategoryId

productTypeIdinteger

Returns products that match the specified productTypeId

tagIdinteger

Returns products that match the specified tagId

startDatestring(date-time)

Returns products created after the specified date

endDatestring(date-time)

Returns products created before the specified date

showInactiveboolean

Specifies whether to include inactive products

sortBystring

Sorts the order of the response

Enum"SKU""ModifyDate""CreateDate"
sortDirstring

Sort direction

Default "ASC"
Enum"ASC""DESC"
pageinteger>= 1

Page number

Default 1
pageSizeinteger[ 1 .. 500 ]

Number of results per page. Maximum 500.

Default 100
curl -i -X GET \
  -u <username>:<password> \
  'https://docs.shipstation.com/_mock/apis/shipstation-v1/openapi/products?sku=string&name=string&productCategoryId=0&productTypeId=0&tagId=0&startDate=2019-08-24T14%3A15%3A22Z&endDate=2019-08-24T14%3A15%3A22Z&showInactive=true&sortBy=SKU&sortDir=ASC&page=1&pageSize=100'

Responses

List of products retrieved successfully

Bodyapplication/json
productsArray of objects
totalinteger
pageinteger
pagesinteger
Response
application/json
{ "products": [ {} ], "total": 0, "page": 0, "pages": 0 }

Get product

Request

Retrieves a single product by its ID

Security
basicAuth
Path
productIdintegerrequired

The system-generated identifier for the Product

Example: 123456789
curl -i -X GET \
  -u <username>:<password> \
  https://docs.shipstation.com/_mock/apis/shipstation-v1/openapi/products/123456789

Responses

Product retrieved successfully

Bodyapplication/json
productIdinteger
Example: 123456789
skustring
Example: "BEAU-000"
namestring
Example: "Beautiful"
pricenumber
Example: 0
activeboolean
Example: true
Response
application/json
{ "productId": 123456789, "sku": "BEAU-000", "name": "Beautiful", "price": 0, "active": true }

Update product

Request

Updates an existing product. This call does not currently support partial updates. The entire resource must be provided in the body of the request.

Security
basicAuth
Path
productIdintegerrequired

The system-generated identifier for the Product

Example: 123456789
Bodyapplication/jsonrequired
productIdinteger
Example: 123456789
skustring
Example: "BEAU-000"
namestring
Example: "Beautiful"
pricenumber
Example: 0
activeboolean
Example: true
weightOznumber or null
Any of:
number
defaultCarrierCodestring or null
Any of:
string
defaultServiceCodestring or null
Any of:
string
curl -i -X PUT \
  -u <username>:<password> \
  https://docs.shipstation.com/_mock/apis/shipstation-v1/openapi/products/123456789 \
  -H 'Content-Type: application/json' \
  -d '{
    "productId": 123456789,
    "sku": "BEAU-000",
    "name": "Beautiful",
    "price": 0,
    "active": true,
    "weightOz": 0,
    "defaultCarrierCode": "string",
    "defaultServiceCode": "string"
  }'

Responses

Product updated successfully

Bodyapplication/json
productIdinteger
skustring
namestring
activeboolean
Response
application/json
{ "productId": 0, "sku": "string", "name": "string", "active": true }

Shipments

Shipment operations and rate shopping

Operations

Stores

Store configuration and management

Operations

Users

User management

Operations

Warehouses

Warehouse and fulfillment location management

Operations

Webhooks

Webhook subscription management

Operations