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

List customers

Request

Obtains a list of customers that match the specified criteria

Security
basicAuth
Query
stateCodestring

Returns customers that reside in the specified stateCode

countryCodestring

Returns customers that reside in the specified countryCode (two-letter ISO)

marketplaceIdinteger

Returns customers that purchased from the specified marketplaceId

tagIdinteger

Returns customers that have been tagged with the specified tagId

sortBystring

Sorts the order of the response

Enum"Name""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/customers?stateCode=string&countryCode=string&marketplaceId=0&tagId=0&sortBy=Name&sortDir=ASC&page=1&pageSize=100'

Responses

List of customers retrieved successfully

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

Get customer

Request

Retrieves a single customer by ID

Security
basicAuth
Path
customerIdintegerrequired

The system-generated identifier for the Customer

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

Responses

Customer retrieved successfully

Bodyapplication/json
customerIdinteger
Example: 12345678
namestring
Example: "Cam Newton"
companystring
Example: "Test Company"
street1string
Example: "123 War Eagle Lane"
citystring
Example: "Auburn"
statestring
Example: "AL"
postalCodestring
Example: "36830"
countryCodestring
Example: "US"
phonestring
Example: "555-555-5555"
emailstring
Example: "supermancam@example.com"
addressVerifiedstring
Example: "Verified"
Response
application/json
{ "customerId": 12345678, "name": "Cam Newton", "company": "Test Company", "street1": "123 War Eagle Lane", "city": "Auburn", "state": "AL", "postalCode": "36830", "countryCode": "US", "phone": "555-555-5555", "email": "supermancam@example.com", "addressVerified": "Verified" }

Fulfillments

Fulfillment operations

Operations

Orders

Order management and operations

Operations

Products

Product catalog management

Operations

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