Not a member of Pastebin yet?
Sign Up,
it unlocks many cool features!
- swagger: '2.0'
- info:
- version: '1.0'
- title: ShipStation Developer Portal
- description: 'TODO: Add a description'
- host: ssapi.shipstation.com
- basePath: /
- securityDefinitions:
- auth:
- type: basic
- x-testValue: []
- x-skip-client-authentication: false
- schemes:
- - https
- consumes:
- - application/json
- produces:
- - application/json
- paths:
- /accounts/registeraccount:
- post:
- description: "Creates a new ShipStation account and generates an apiKey and apiSecret to be used by the newly created account. PLEASE NOTE: This endpoint does not require API key and API Secret credentials. The Authorization header can be left off. Use of this specific endpoint requires approval, and is meant only for direct partners of ShipStation. This is the only endpoint to require approval. All other endpoints listed in this document can be accessed by submitting proper authorization credentials in the header of the request. To become a direct partner of ShipStation, or to request more information on becoming a direct partner, we recommend reaching out to our Partners and Integrations team here: https://info.shipstation.com/become-a-partner-api-and-custom-store-integrations\nThe body of this request has the following attributes:\nName |Data Type |Description\n-------------------|-------------------|-------------------\n``firstName`` | string, required | First Name\n``lastName`` | string, required | Last Name\n``email`` | string, required | Email address. This will also be the username of the account.\n``password`` | string, required | Password to set for account access.\n``companyName`` | string, optional | Name of Company.\n``addr1`` | string, optional | Company Address - Street 1\n``addr2`` | string, optional | Company Address - Street 2\n``city`` | string, optional | Company Address - City\n``state`` | string, optional | Company Address - State \n``zip`` | string, optional | Company Address - Zip Code\n``countryCode`` |string, optional | Company Address - Country. Please use a 2-character country code.\n``phone`` | string, optional | Company Phone number."
- summary: Register Account
- tags:
- - Accounts
- operationId: AccountsRegisteraccountPost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/RegisterAccountRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/RegisterAccountResponse'
- examples:
- application/json:
- message: ShipStation account created.
- sellerId: 123456
- success: true
- apiKey: abcdt9845hjmgfklj3498gkljdkuyekl
- apiSecret: 1234iou983lkj8mnxgfwu509hkhdy7u3
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /accounts/listtags:
- get:
- description: Lists all tags defined for this account.
- summary: List Tags
- tags:
- - Accounts
- operationId: AccountsListtagsGet
- produces:
- - application/json
- parameters: []
- responses:
- 200:
- description: ''
- schema:
- type: array
- items:
- $ref: '#/definitions/ListTagsResponse'
- examples:
- application/json:
- - tagId: 8362
- name: Backorder
- color: '#800080'
- - tagId: 8324
- name: Canada
- color: '#ff0000'
- - tagId: 8336
- name: Fragile
- color: '#33CCCC'
- - tagId: 8221
- name: Repeat Buyer
- color: '#CC99FF'
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /accounts/listtags
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: '[ { "tagId": 8362, "name": "Backorder", "color": "#800080" }, { "tagId": 8324, "name": "Canada", "color": "#ff0000" }, { "tagId": 8336, "name": "Fragile", "color": "#33CCCC" }, { "tagId": 8221, "name": "Repeat Buyer", "color": "#CC99FF" }]'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: List Tags1
- x-testDescription: Lists all tags defined for this account.
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /carriers:
- get:
- description: Lists all shipping providers connected to this account.
- summary: List Carriers
- tags:
- - Carriers
- operationId: CarriersGet
- produces:
- - application/json
- parameters: []
- responses:
- 200:
- description: ''
- schema:
- type: array
- items:
- $ref: '#/definitions/ListCarriersResponse'
- examples:
- application/json:
- - name: Express 1
- code: express_1
- accountNumber: fe71c33f
- requiresFundedAccount: true
- balance: 0.27000000000000002
- - name: Stamps.com
- code: stamps_com
- accountNumber: SS123
- requiresFundedAccount: true
- balance: 24.140000000000001
- - name: UPS
- code: ups
- accountNumber: ABCR80
- requiresFundedAccount: false
- balance: 0
- - name: FedEx
- code: fedex
- accountNumber: 297929999
- requiresFundedAccount: false
- balance: 0
- - name: Endicia
- code: endicia
- accountNumber: 913999
- requiresFundedAccount: true
- balance: 84.859999999999999
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /carriers
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: '[ { "name": "Express 1", "code": "express_1", "accountNumber": "fe71c33f", "requiresFundedAccount": true, "balance": 0.27 }, { "name": "Stamps.com", "code": "stamps_com", "accountNumber": "SS123", "requiresFundedAccount": true, "balance": 24.14 }, { "name": "UPS", "code": "ups", "accountNumber": "ABCR80", "requiresFundedAccount": false, "balance": 0 }, { "name": "FedEx", "code": "fedex", "accountNumber": "297929999", "requiresFundedAccount": false, "balance": 0 }, { "name": "Endicia", "code": "endicia", "accountNumber": "913999", "requiresFundedAccount": true, "balance": 84.86 }]'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: List Carriers1
- x-testDescription: Lists all shipping providers connected to this account.
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /carriers/getcarrier?carrierCode={carrierCode}:
- get:
- description: Retrieves the shipping carrier account details for the specified carrierCode. Use this method to determine a carrier's account balance.
- summary: Get Carrier
- tags:
- - Carriers
- operationId: CarriersGetcarrierByCarrierCodeGet
- produces:
- - application/json
- parameters:
- - name: carrierCode
- in: path
- required: true
- type: string
- description: The code for the carrier account to retrieve.
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/GetCarrierResponse'
- examples:
- application/json:
- name: Stamps.com
- code: stamps_com
- accountNumber: SS123
- requiresFundedAccount: true
- balance: 24.140000000000001
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /carriers/getcarrier?carrierCode=stamps_com
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: '{ "name": "Stamps.com", "code": "stamps_com", "accountNumber": "SS123", "requiresFundedAccount": true, "balance": 24.14}'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: Get Carrier1
- x-testDescription: Retrieves the shipping carrier account details for the specified carrierCode. Use this method to determine a carrier's account balance.
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /carriers/addfunds:
- post:
- description: >-
- Adds funds to a carrier account using the payment information on file. The body of this request should specify the following attributes:
- Name |Data Type |Description
- -------------------|-------------------|-------------------
- ``carrierCode`` | string, required | The carrier to add funds to.
- ``amount`` | number, required | The dollar amount to add to the account. The minimum value that can be added is $10.00. The maximum value is $10,000.00.
- summary: Add Funds
- tags:
- - Carriers
- operationId: CarriersAddfundsPost
- produces:
- - application/json
- parameters:
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/AddFundsRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/AddFundsResponse'
- examples:
- application/json:
- name: Stamps.com
- code: stamps_com
- accountNumber: SS123
- requiresFundedAccount: true
- balance: 24.140000000000001
- security:
- - auth: []
- x-unitTests:
- - request:
- method: POST
- uri: /carriers/addfunds
- headers:
- Content-Type: application/json
- body: '{ "carrierCode": "fedex", "amount": 20.00}'
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: '{ "name": "Stamps.com", "code": "stamps_com", "accountNumber": "SS123", "requiresFundedAccount": true, "balance": 24.14}'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: Add Funds1
- x-testDescription: >-
- Adds funds to a carrier account using the payment information on file. The body of this request should specify the following attributes:
- Name |Data Type |Description
- -------------------|-------------------|-------------------
- ``carrierCode`` | string, required | The carrier to add funds to.
- ``amount`` | number, required | The dollar amount to add to the account. The minimum value that can be added is $10.00. The maximum value is $10,000.00.
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /carriers/listpackages?carrierCode={carrierCode}:
- get:
- description: Retrieves a list of packages for the specified carrier
- summary: List Packages
- tags:
- - Carriers
- operationId: CarriersListpackagesByCarrierCodeGet
- produces:
- - application/json
- parameters:
- - name: carrierCode
- in: path
- required: true
- type: string
- description: The carrier's code
- responses:
- 200:
- description: ''
- schema:
- type: array
- items:
- $ref: '#/definitions/ListPackagesResponse'
- examples:
- application/json:
- - carrierCode: express_1
- code: cubic
- name: Cubic
- domestic: true
- international: false
- - carrierCode: express_1
- code: dvd_flat_rate_box
- name: DVD Flat Rate Box
- domestic: false
- international: true
- - carrierCode: express_1
- code: flat_rate_envelope
- name: Flat Rate Envelope
- domestic: true
- international: true
- - carrierCode: express_1
- code: flat_rate_legal_envelope
- name: Flat Rate Legal Envelope
- domestic: true
- international: true
- - carrierCode: express_1
- code: flat_rate_padded_envelope
- name: Flat Rate Padded Envelope
- domestic: true
- international: true
- - carrierCode: express_1
- code: large_envelope_or_flat
- name: Large Envelope or Flat
- domestic: true
- international: true
- - carrierCode: express_1
- code: large_flat_rate_box
- name: Large Flat Rate Box
- domestic: true
- international: true
- - carrierCode: express_1
- code: large_package
- name: Large Package (any side > 12")
- domestic: true
- international: true
- - carrierCode: express_1
- code: large_video_flat_rate_box
- name: Large Video Flat Rate Box
- domestic: false
- international: true
- - carrierCode: express_1
- code: letter
- name: Letter
- domestic: true
- international: true
- - carrierCode: express_1
- code: medium_flat_rate_box
- name: Medium Flat Rate Box
- domestic: true
- international: true
- - carrierCode: express_1
- code: package
- name: Package
- domestic: true
- international: true
- - carrierCode: express_1
- code: regional_rate_box_a
- name: Regional Rate Box A
- domestic: true
- international: false
- - carrierCode: express_1
- code: regional_rate_box_b
- name: Regional Rate Box B
- domestic: true
- international: false
- - carrierCode: express_1
- code: regional_rate_box_c
- name: Regional Rate Box C
- domestic: true
- international: false
- - carrierCode: express_1
- code: small_flat_rate_box
- name: Small Flat Rate Box
- domestic: true
- international: true
- - carrierCode: express_1
- code: thick_envelope
- name: Thick Envelope
- domestic: true
- international: true
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /carriers/listservices?carrierCode={carrierCode}:
- get:
- description: Retrieves the list of available shipping services provided by the specified carrier
- summary: List Services
- tags:
- - Carriers
- operationId: CarriersListservicesByCarrierCodeGet
- produces:
- - application/json
- parameters:
- - name: carrierCode
- in: path
- required: true
- type: string
- description: The carrier's code
- responses:
- 200:
- description: ''
- schema:
- type: array
- items:
- $ref: '#/definitions/ListServicesResponse'
- examples:
- application/json:
- - carrierCode: fedex
- code: fedex_ground
- name: FedEx Ground®
- domestic: true
- international: false
- - carrierCode: fedex
- code: fedex_home_delivery
- name: FedEx Home Delivery®
- domestic: true
- international: false
- - carrierCode: fedex
- code: fedex_2day
- name: FedEx 2Day®
- domestic: true
- international: false
- - carrierCode: fedex
- code: fedex_2day_am
- name: FedEx 2Day® A.M.
- domestic: true
- international: false
- - carrierCode: fedex
- code: fedex_express_saver
- name: FedEx Express Saver®
- domestic: true
- international: false
- - carrierCode: fedex
- code: fedex_standard_overnight
- name: FedEx Standard Overnight®
- domestic: true
- international: false
- - carrierCode: fedex
- code: fedex_priority_overnight
- name: FedEx Priority Overnight®
- domestic: true
- international: false
- - carrierCode: fedex
- code: fedex_first_overnight
- name: FedEx First Overnight®
- domestic: true
- international: false
- - carrierCode: fedex
- code: fedex_1_day_freight
- name: FedEx 1 Day® Freight
- domestic: true
- international: false
- - carrierCode: fedex
- code: fedex_2_day_freight
- name: FedEx 2 Day® Freight
- domestic: true
- international: false
- - carrierCode: fedex
- code: fedex_3_day_freight
- name: FedEx 3 Day® Freight
- domestic: true
- international: false
- - carrierCode: fedex
- code: fedex_first_overnight_freight
- name: FedEx First Overnight® Freight
- domestic: true
- international: false
- - carrierCode: fedex
- code: fedex_ground_international
- name: FedEx Ground® International
- domestic: false
- international: true
- - carrierCode: fedex
- code: fedex_international_economy
- name: FedEx International Economy®
- domestic: false
- international: true
- - carrierCode: fedex
- code: fedex_international_priority
- name: FedEx International Priority®
- domestic: false
- international: true
- - carrierCode: fedex
- code: fedex_international_first
- name: FedEx International First®
- domestic: false
- international: true
- - carrierCode: fedex
- code: fedex_europe_first
- name: FedEx Europe First®
- domestic: false
- international: true
- - carrierCode: fedex
- code: fedex_international_economy_freight
- name: FedEx International Economy® Freight
- domestic: false
- international: true
- - carrierCode: fedex
- code: fedex_international_priority_freight
- name: FedEx International Priority® Freight
- domestic: false
- international: true
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /customers/{customerId}:
- get:
- description: ''
- summary: Get Customer
- tags:
- - Customers
- operationId: CustomersByCustomerIdGet
- produces:
- - application/json
- parameters:
- - name: customerId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: The system generated identifier for the Customer.
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/GetCustomerResponse'
- examples:
- application/json:
- customerId: 12345678
- createDate: 2014-11-18T10:33:01.1900000
- modifyDate: 2014-11-18T10:33:01.1900000
- name: Cam Newton
- company: Test Company
- street1: 123 War Eagle Lane
- street2: ''
- city: Auburn
- state: AL
- postalCode: 36830
- countryCode: US
- phone: 555-555-5555
- email: supermancam@example.com
- addressVerified: Verified
- marketplaceUsernames:
- - customerUserId: 67195020
- customerId: 12345678
- createDate: 2015-04-27T12:35:03.8300000
- modifyDate: 2015-05-14T08:16:15.2700000
- marketplaceId: 0
- marketplace: ShipStation
- username: camtheman@gmail.com
- - customerUserId: 37568588
- customerId: 12345678
- createDate: 2014-11-18T10:33:01.1970000
- modifyDate: 2014-11-18T10:33:01.1970000
- marketplaceId: 36
- marketplace: WooCommerce
- username: supercam@example.com
- - customerUserId: 46038940
- customerId: 12345678
- createDate:
- modifyDate:
- marketplaceId: 67
- marketplace: TradeGecko
- username: camtheman@gmail.com
- tags:
- - tagId: 1234
- name: Expedited
- - tagId: 9725
- name: 00 BULK ORDERED
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /customers/12345678
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: ' { "customerId": 12345678, "createDate": "2014-11-18T10:33:01.1900000", "modifyDate": "2014-11-18T10:33:01.1900000", "name": "Cam Newton", "company": "Test Company", "street1": "123 War Eagle Lane", "street2": "", "city": "Auburn", "state": "AL", "postalCode": "36830", "countryCode": "US", "phone": "555-555-5555", "email": "supermancam@example.com", "addressVerified": "Verified", "marketplaceUsernames": [ { "customerUserId": 67195020, "customerId": 12345678, "createDate": "2015-04-27T12:35:03.8300000", "modifyDate": "2015-05-14T08:16:15.2700000", "marketplaceId": 0, "marketplace": "ShipStation", "username": "camtheman@gmail.com" }, { "customerUserId": 37568588, "customerId": 12345678, "createDate": "2014-11-18T10:33:01.1970000", "modifyDate": "2014-11-18T10:33:01.1970000", "marketplaceId": 36, "marketplace": "WooCommerce", "username": "supercam@example.com" }, { "customerUserId": 46038940, "customerId": 12345678, "createDate": null, "modifyDate": null, "marketplaceId": 67, "marketplace": "TradeGecko", "username": "camtheman@gmail.com" } ], "tags": [ { "tagId": 1234, "name": "Expedited" }, { "tagId": 9725, "name": "00 BULK ORDERED" } ] }'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: Get Customer1
- x-testDescription: Testcase for testing endpoint Get Customer
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- ? /customers?stateCode={stateCode}&countryCode={countryCode}&tagId={tagId}&marketplaceId={marketplaceId}&sortBy={sortBy}&sortDir={sortDir}&page={page}&pageSize={pageSize}
- : get:
- description: Obtains a list of customers that match the specified criteria.
- summary: List Customers
- tags:
- - Customers
- operationId: CustomersTagIdTagIdMarketplaceIdMarketplaceIdSortBySortBySortDirSortDirPagePagePageSizePageSizeByStateCodeAndCountryCodeGet
- produces:
- - application/json
- parameters:
- - name: stateCode
- in: path
- required: true
- type: string
- description: Returns customers that reside in the specified stateCode.
- - name: countryCode
- in: path
- required: true
- type: string
- description: Returns customers that reside in the specified countryCode.
- - name: marketplaceId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: Returns customers that purchased items from the specified marketplaceId.
- - name: tagId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: Returns customers that have been tagged with the specified tagId.
- - name: sortBy
- in: path
- required: true
- enum:
- - Name
- - ModifyDate
- - CreateDate
- x-enum-elements:
- - name: Name
- description: ''
- - name: ModifyDate
- description: ''
- - name: CreateDate
- description: ''
- type: string
- description: Sorts the order of the response based off the specified value.
- - name: sortDir
- in: path
- required: true
- enum:
- - ASC
- - DESC
- x-enum-elements:
- - name: ASC
- description: ''
- - name: DESC
- description: ''
- type: string
- description: Sets the direction of the sort order.
- - name: page
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: Page number.
- - name: pageSize
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: Requested page size. Max value is 500.
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/ListCustomersResponse'
- examples:
- application/json:
- customers:
- - customerId: 12345678
- createDate: 2014-11-18T10:33:01.1900000
- modifyDate: 2014-11-18T10:33:01.1900000
- name: Cam Newton
- company: Test Company
- street1: 123 War Eagle Lane
- street2: ''
- city: Auburn
- state: AL
- postalCode: 36830
- countryCode: US
- phone: 555-555-5555
- email: supermancam@example.com
- addressVerified: Verified
- marketplaceUsernames:
- - customerUserId: 67195020
- customerId: 12345678
- createDate: 2015-04-27T12:35:03.8300000
- modifyDate: 2015-05-14T08:16:15.2700000
- marketplaceId: 0
- marketplace: ShipStation
- username: camtheman@gmail.com
- - customerUserId: 37568588
- customerId: 12345678
- createDate: 2014-11-18T10:33:01.1970000
- modifyDate: 2014-11-18T10:33:01.1970000
- marketplaceId: 36
- marketplace: WooCommerce
- username: supercam@example.com
- - customerUserId: 46038940
- customerId: 12345678
- createDate:
- modifyDate:
- marketplaceId: 67
- marketplace: TradeGecko
- username: camtheman@gmail.com
- tags:
- - tagId: 1234
- name: Expedited
- - tagId: 9725
- name: 00 BULK ORDERED
- - customerId: 87654321
- createDate: 2015-06-21T12:48:07.5400000
- name: Bo Jackson
- company: Test Company
- street1: 456 Heisman Ave
- street2: ''
- city: Auburn
- state: AL
- postalCode: 36830
- countryCode: US
- phone: 555-555-5555
- email: boknows@example.com
- addressVerified: Verified
- marketplaceUsernames:
- - customerUserId: 77215410
- customerId: 87654321
- createDate: 2015-08-27T14:36:05.7500000
- modifyDate: 2015-09-01T09:18:25.3100000
- marketplaceId: 0
- marketplace: ShipStation
- username: boknows@gmail.com
- - customerUserId: 43759100
- customerId: 87654321
- createDate: 2015-07-05T11:38:01.1970000
- modifyDate: 2015-07-05T11:38:01.1970000
- marketplaceId: 36
- marketplace: WooCommerce
- username: boknows@example.com
- - customerUserId: 81565241
- customerId: 87654321
- createDate:
- modifyDate:
- marketplaceId: 67
- marketplace: TradeGecko
- username: bo@gmail.com
- tags:
- - tagId: 1234
- name: Expedited
- - tagId: 9725
- name: 00 BULK ORDERED
- total: 2
- page: 1
- pages: 1
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /customers?stateCode={stateCode}&countryCode={countryCode}&tagId={tagId}&marketplaceId={marketplaceId}&sortBy={sortBy}&sortDir={sortDir}&page={page}&pageSize={pageSize}
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: '{ "customers": [ { "customerId": 12345678, "createDate": "2014-11-18T10:33:01.1900000", "modifyDate": "2014-11-18T10:33:01.1900000", "name": "Cam Newton", "company": "Test Company", "street1": "123 War Eagle Lane", "street2": "", "city": "Auburn", "state": "AL", "postalCode": "36830", "countryCode": "US", "phone": "555-555-5555", "email": "supermancam@example.com", "addressVerified": "Verified", "marketplaceUsernames": [ { "customerUserId": 67195020, "customerId": 12345678, "createDate": "2015-04-27T12:35:03.8300000", "modifyDate": "2015-05-14T08:16:15.2700000", "marketplaceId": 0, "marketplace": "ShipStation", "username": "camtheman@gmail.com" }, { "customerUserId": 37568588, "customerId": 12345678, "createDate": "2014-11-18T10:33:01.1970000", "modifyDate": "2014-11-18T10:33:01.1970000", "marketplaceId": 36, "marketplace": "WooCommerce", "username": "supercam@example.com" }, { "customerUserId": 46038940, "customerId": 12345678, "createDate": null, "modifyDate": null, "marketplaceId": 67, "marketplace": "TradeGecko", "username": "camtheman@gmail.com" } ], "tags": [ { "tagId": 1234, "name": "Expedited" }, { "tagId": 9725, "name": "00 BULK ORDERED" } ] }, { "customerId": 87654321, "createDate": "2015-06-21T12:48:07.5400000", "name": "Bo Jackson", "company": "Test Company", "street1": "456 Heisman Ave", "street2": "", "city": "Auburn", "state": "AL", "postalCode": "36830", "countryCode": "US", "phone": "555-555-5555", "email": "boknows@example.com", "addressVerified": "Verified", "marketplaceUsernames": [ { "customerUserId": 77215410, "customerId": 87654321, "createDate": "2015-08-27T14:36:05.7500000", "modifyDate": "2015-09-01T09:18:25.3100000", "marketplaceId": 0, "marketplace": "ShipStation", "username": "boknows@gmail.com" }, { "customerUserId": 43759100, "customerId": 87654321, "createDate": "2015-07-05T11:38:01.1970000", "modifyDate": "2015-07-05T11:38:01.1970000", "marketplaceId": 36, "marketplace": "WooCommerce", "username": "boknows@example.com" }, { "customerUserId": 81565241, "customerId": 87654321, "createDate": null, "modifyDate": null, "marketplaceId": 67, "marketplace": "TradeGecko", "username": "bo@gmail.com" } ], "tags": [ { "tagId": 1234, "name": "Expedited" }, { "tagId": 9725, "name": "00 BULK ORDERED" } ] } ], "total": 2, "page": 1, "pages": 1}'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: List Customers1
- x-testDescription: Obtains a list of customers that match the specified criteria.
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /fulfillments:
- get:
- description: ''
- summary: List Fulfillments w/o parameters
- tags:
- - Fulfillments
- operationId: FulfillmentsGet
- produces:
- - application/json
- parameters: []
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/ListFulfillmentsW~1oParametersResponse'
- examples:
- application/json:
- fulfillments:
- - fulfillmentId: 33974374
- orderId: 191759016
- orderNumber: 101
- userId: c9f06d74-95de-4263-9b04-e87095cababf
- customerEmail: apisupport@shipstation.com
- trackingNumber: 783408231234
- createDate: 2016-06-07T08:50:50.0670000
- shipDate: 2016-06-07T00:00:00.0000000
- voidDate:
- deliveryDate:
- carrierCode: USPS
- fulfillmentProviderCode:
- fulfillmentServiceCode:
- fulfillmentFee: 0
- voidRequested: false
- voided: false
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Yoda
- company:
- street1: '3800 N Lamar Blvd # 220'
- street2:
- street3:
- city: AUSTIN
- state: TX
- postalCode: 78756
- country: US
- phone: 512-485-4282
- residential:
- addressVerified:
- - fulfillmentId: 246310
- orderId: 193699927
- orderNumber: 101
- userId: c9f06d74-95de-4263-9b04-e87095cababf
- customerEmail: apisupport@shipstation.com
- trackingNumber: 664756278745
- createDate: 2016-06-08T12:54:53.3470000
- shipDate: 2016-06-08T00:00:00.0000000
- voidDate:
- deliveryDate:
- carrierCode: FedEx
- fulfillmentProviderCode:
- fulfillmentServiceCode:
- fulfillmentFee: 0
- voidRequested: false
- voided: false
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Yoda
- company:
- street1: '3800 N Lamar Blvd # 220'
- street2:
- street3:
- city: AUSTIN
- state: TX
- postalCode: 78756
- country: US
- phone: 512-485-4282
- residential:
- addressVerified:
- total: 2
- page: 1
- pages: 0
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /fulfillments
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: '{ "fulfillments": [ { "fulfillmentId": 33974374, "orderId": 191759016, "orderNumber": "101", "userId": "c9f06d74-95de-4263-9b04-e87095cababf", "customerEmail": "apisupport@shipstation.com", "trackingNumber": "783408231234", "createDate": "2016-06-07T08:50:50.0670000", "shipDate": "2016-06-07T00:00:00.0000000", "voidDate": null, "deliveryDate": null, "carrierCode": "USPS", "fulfillmentProviderCode": null, "fulfillmentServiceCode": null, "fulfillmentFee": 0, "voidRequested": false, "voided": false, "marketplaceNotified": true, "notifyErrorMessage": null, "shipTo": { "name": "Yoda", "company": null, "street1": "3800 N Lamar Blvd # 220", "street2": null, "street3": null, "city": "AUSTIN", "state": "TX", "postalCode": "78756", "country": "US", "phone": "512-485-4282", "residential": null, "addressVerified": null } }, { "fulfillmentId": 246310, "orderId": 193699927, "orderNumber": "101", "userId": "c9f06d74-95de-4263-9b04-e87095cababf", "customerEmail": "apisupport@shipstation.com", "trackingNumber": "664756278745", "createDate": "2016-06-08T12:54:53.3470000", "shipDate": "2016-06-08T00:00:00.0000000", "voidDate": null, "deliveryDate": null, "carrierCode": "FedEx", "fulfillmentProviderCode": null, "fulfillmentServiceCode": null, "fulfillmentFee": 0, "voidRequested": false, "voided": false, "marketplaceNotified": true, "notifyErrorMessage": null, "shipTo": { "name": "Yoda", "company": null, "street1": "3800 N Lamar Blvd # 220", "street2": null, "street3": null, "city": "AUSTIN", "state": "TX", "postalCode": "78756", "country": "US", "phone": "512-485-4282", "residential": null, "addressVerified": null } } ], "total": 2, "page": 1, "pages": 0}'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: List Fulfillments w/o parameters1
- x-testDescription: Testcase for testing endpoint List Fulfillments w/o parameters
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- ? /fulfillments?fulfillmentId={fulfillmentId}&orderId={orderId}&orderNumber={orderNumber}&trackingNumber={trackingNumber}&recipientName={recipientName}&createDateStart={createDateStart}&createDateEnd={createDateEnd}&shipDateStart={shipDateStart}&shipDateEnd={shipDateEnd}&sortBy={sortBy}&sortDir={sortDir}&page={page}&pageSize={pageSize}
- : get:
- description: >-
- Obtains a list of fulfillments that match the specified criteria. Please note the following:
- - Orders that have been marked as shipped either through the UI or the API will appear in the response as they are considered fulfillments.
- All of the available filters are optional. They do not need to be included in the URL. If you do include them, here's what the URL may look like:
- Url format with filters:
- ```
- fulfillments?fulfillmentId={fulfillmentId}
- &orderId={orderId}
- &orderNumber={orderNumber}
- &trackingNumber={trackingNumber}
- &recipientName={recipientName}
- &createDateStart={createDateStart}
- &createDateEnd={createDateEnd}
- &shipDateStart={shipDateStart}
- &shipDateEnd={shipDateEnd}
- &sortBy={sortBy}
- &sortDir={sortDir}
- &page={page}
- &pageSize={pageSize}
- ```
- summary: List Fulfillments with parameters
- tags:
- - Fulfillments
- operationId: FulfillmentsOrderNumberOrderNumberTrackingNumberTrackingNumberRecipientNameRecipientNameCreateDateStartCreateDateStartCreateDateEndCreateDateEndShipDateStartShipDateStartShipDateEndShipDateEndSortBySortBySortDirSortDirPagePagePageSizePageSizeByFulfillmentIdAndOrderIdGet
- produces:
- - application/json
- parameters:
- - name: fulfillmentId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: Returns the fulfillment with the specified fulfillment ID.
- - name: orderId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: Returns fulfillments whose orders have the specified order ID.
- - name: orderNumber
- in: path
- required: true
- type: string
- description: Returns fulfillments whose orders have the specified order number.
- - name: trackingNumber
- in: path
- required: true
- type: string
- description: Returns fulfillments with the specified tracking number.
- - name: recipientName
- in: path
- required: true
- type: string
- description: Returns fulfillments shipped to the specified recipient name.
- - name: createDateStart
- in: path
- required: true
- type: string
- description: Returns fulfillments created on or after the specified ``createDate``
- - name: createDateEnd
- in: path
- required: true
- type: string
- description: Returns fulfillments created on or before the specified ``createDate``
- - name: shipDateStart
- in: path
- required: true
- type: string
- description: Returns fulfillments with the ``shipDate`` on or after the specified date
- - name: shipDateEnd
- in: path
- required: true
- type: string
- description: Returns fulfillments with the ``shipDate`` on or before the specified date
- - name: sortBy
- in: path
- required: true
- enum:
- - ShipDate
- - CreateDate
- x-enum-elements:
- - name: ShipDate
- description: ''
- - name: CreateDate
- description: ''
- type: string
- description: Sort the responses by a set value. The response will be sorted based off the ascending dates (oldest to most current.) If left empty, the response will be sorted by ascending ``createDate``.
- - name: sortDir
- in: path
- required: true
- enum:
- - ASC
- - DESC
- x-enum-elements:
- - name: ASC
- description: ''
- - name: DESC
- description: ''
- type: string
- description: Sets the direction of the sort order.
- - name: page
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: page number.
- - name: pageSize
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: page size.
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/ListFulfillmentsWithParametersResponse'
- examples:
- application/json:
- fulfillments:
- - fulfillmentId: 33974374
- orderId: 191759016
- orderNumber: 101
- userId: c9f06d74-95de-4263-9b04-e87095cababf
- customerEmail: apisupport@shipstation.com
- trackingNumber: 783408231234
- createDate: 2016-06-07T08:50:50.0670000
- shipDate: 2016-06-07T00:00:00.0000000
- voidDate:
- deliveryDate:
- carrierCode: USPS
- fulfillmentProviderCode:
- fulfillmentServiceCode:
- fulfillmentFee: 0
- voidRequested: false
- voided: false
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Yoda
- company:
- street1: '3800 N Lamar Blvd # 220'
- street2:
- street3:
- city: AUSTIN
- state: TX
- postalCode: 78756
- country: US
- phone: 512-485-4282
- residential:
- addressVerified:
- - fulfillmentId: 246310
- orderId: 193699927
- orderNumber: 101
- userId: c9f06d74-95de-4263-9b04-e87095cababf
- customerEmail: apisupport@shipstation.com
- trackingNumber: 664756278745
- createDate: 2016-06-08T12:54:53.3470000
- shipDate: 2016-06-08T00:00:00.0000000
- voidDate:
- deliveryDate:
- carrierCode: FedEx
- fulfillmentProviderCode:
- fulfillmentServiceCode:
- fulfillmentFee: 0
- voidRequested: false
- voided: false
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Yoda
- company:
- street1: '3800 N Lamar Blvd # 220'
- street2:
- street3:
- city: AUSTIN
- state: TX
- postalCode: 78756
- country: US
- phone: 512-485-4282
- residential:
- addressVerified:
- total: 2
- page: 1
- pages: 0
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /fulfillments?fulfillmentId={fulfillmentId}&orderId={orderId}&orderNumber={orderNumber}&trackingNumber={trackingNumber}&recipientName={recipientName}&createDateStart={createDateStart}&createDateEnd={createDateEnd}&shipDateStart={shipDateStart}&shipDateEnd={shipDateEnd}&sortBy={sortBy}&sortDir={sortDir}&page={page}&pageSize={pageSize}
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: '{ "fulfillments": [ { "fulfillmentId": 33974374, "orderId": 191759016, "orderNumber": "101", "userId": "c9f06d74-95de-4263-9b04-e87095cababf", "customerEmail": "apisupport@shipstation.com", "trackingNumber": "783408231234", "createDate": "2016-06-07T08:50:50.0670000", "shipDate": "2016-06-07T00:00:00.0000000", "voidDate": null, "deliveryDate": null, "carrierCode": "USPS", "fulfillmentProviderCode": null, "fulfillmentServiceCode": null, "fulfillmentFee": 0, "voidRequested": false, "voided": false, "marketplaceNotified": true, "notifyErrorMessage": null, "shipTo": { "name": "Yoda", "company": null, "street1": "3800 N Lamar Blvd # 220", "street2": null, "street3": null, "city": "AUSTIN", "state": "TX", "postalCode": "78756", "country": "US", "phone": "512-485-4282", "residential": null, "addressVerified": null } }, { "fulfillmentId": 246310, "orderId": 193699927, "orderNumber": "101", "userId": "c9f06d74-95de-4263-9b04-e87095cababf", "customerEmail": "apisupport@shipstation.com", "trackingNumber": "664756278745", "createDate": "2016-06-08T12:54:53.3470000", "shipDate": "2016-06-08T00:00:00.0000000", "voidDate": null, "deliveryDate": null, "carrierCode": "FedEx", "fulfillmentProviderCode": null, "fulfillmentServiceCode": null, "fulfillmentFee": 0, "voidRequested": false, "voided": false, "marketplaceNotified": true, "notifyErrorMessage": null, "shipTo": { "name": "Yoda", "company": null, "street1": "3800 N Lamar Blvd # 220", "street2": null, "street3": null, "city": "AUSTIN", "state": "TX", "postalCode": "78756", "country": "US", "phone": "512-485-4282", "residential": null, "addressVerified": null } } ], "total": 2, "page": 1, "pages": 0}'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: List Fulfillments with parameters1
- x-testDescription: >-
- Obtains a list of fulfillments that match the specified criteria. Please note the following:
- - Orders that have been marked as shipped either through the UI or the API will appear in the response as they are considered fulfillments.
- All of the available filters are optional. They do not need to be included in the URL. If you do include them, here's what the URL may look like:
- Url format with filters:
- ```
- fulfillments?fulfillmentId={fulfillmentId}
- &orderId={orderId}
- &orderNumber={orderNumber}
- &trackingNumber={trackingNumber}
- &recipientName={recipientName}
- &createDateStart={createDateStart}
- &createDateEnd={createDateEnd}
- &shipDateStart={shipDateStart}
- &shipDateEnd={shipDateEnd}
- &sortBy={sortBy}
- &sortDir={sortDir}
- &page={page}
- &pageSize={pageSize}
- ```
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /orders/{orderId}:
- get:
- description: Retrieves a single order from the database.
- summary: Get Order
- tags:
- - Orders
- operationId: OrdersByOrderIdGet
- produces:
- - application/json
- parameters:
- - name: orderId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: The system generated identifier for the order.
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/GetOrderResponse'
- examples:
- application/json:
- orderId: 94113592
- orderNumber: TEST-ORDER-API-DOCS
- orderKey: 0f6bec18-9-4771-83aa-f392d84f4c74
- orderDate: 2015-06-29T08:46:27.0000000
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-09-08T11:03:12.3800000
- paymentDate: 2015-06-29T08:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId: 37701499
- customerUsername: headhoncho@whitehouse.gov
- customerEmail: headhoncho@whitehouse.gov
- billTo:
- name: The President
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: The President
- company: US Govt
- street1: 1600 Pennsylvania Ave
- street2: Oval Office
- street3:
- city: Washington
- state: DC
- postalCode: 20500
- country: US
- phone: 555-555-5555
- residential: false
- addressVerified: Address validation warning
- items:
- - orderItemId: 128836912
- lineItemKey: vd08-MSLbtx
- sku: ABC123
- name: 'Test item #1'
- imageUrl:
- weight:
- value: 24
- units: ounces
- quantity: 2
- unitPrice: 99.989999999999995
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 1, Bin 7
- options:
- - name: Size
- value: Large
- productId: 7239919
- fulfillmentSku:
- adjustment: false
- upc:
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-07-16T14:00:34.8230000
- - orderItemId: 128836913
- lineItemKey:
- sku: DISCOUNT CODE
- name: 10% OFF
- imageUrl:
- weight:
- value: 0
- units: ounces
- quantity: 1
- unitPrice: -20.550000000000001
- taxAmount:
- shippingAmount:
- warehouseLocation:
- options: []
- productId:
- fulfillmentSku:
- adjustment: true
- upc:
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-07-16T14:00:34.8230000
- orderTotal: 194.43000000000001
- amountPaid: 218.72999999999999
- taxAmount: 5
- shippingAmount: 10
- customerNotes: Thanks for ordering!
- internalNotes: Customer called and would like to upgrade shipping
- gift: true
- giftMessage: Thank you!
- paymentMethod: Credit Card
- requestedShippingService: Priority Mail
- carrierCode: fedex
- serviceCode: fedex_home_delivery
- packageCode: package
- confirmation: delivery
- shipDate: 2015-07-02
- holdUntilDate:
- weight:
- value: 48
- units: ounces
- dimensions:
- units: inches
- length: 7
- width: 5
- height: 6
- insuranceOptions:
- provider: carrier
- insureShipment: true
- insuredValue: 200
- internationalOptions:
- contents:
- customsItems:
- nonDelivery:
- advancedOptions:
- warehouseId: 24079
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 26815
- customField1: 'Custom data that you can add to an order. See Custom Field #2 & #3 for more info!'
- customField2: Per UI settings, this information can appear on some carrier's shipping labels. See link below
- customField3: https://help.shipstation.com/hc/en-us/articles/206639957
- source: Webstore
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- userId:
- externallyFulfilled: false
- externallyFulfilledBy:
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /orders/123456789
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: "{ \"orderId\": 94113592, \"orderNumber\": \"TEST-ORDER-API-DOCS\", \"orderKey\": \"0f6bec18-9-4771-83aa-f392d84f4c74\", \"orderDate\": \"2015-06-29T08:46:27.0000000\", \"createDate\": \"2015-07-16T14:00:34.8230000\", \"modifyDate\": \"2015-09-08T11:03:12.3800000\", \"paymentDate\": \"2015-06-29T08:46:27.0000000\", \"shipByDate\": \"2015-07-05T00:00:00.0000000\", \"orderStatus\": \"awaiting_shipment\", \"customerId\": 37701499, \"customerUsername\": \"headhoncho@whitehouse.gov\", \"customerEmail\": \"headhoncho@whitehouse.gov\", \"billTo\": { \"name\": \"The President\", \"company\": null, \"street1\": null, \"street2\": null, \"street3\": null, \"city\": null, \"state\": null, \"postalCode\": null, \"country\": null, \"phone\": null, \"residential\": null, \"addressVerified\": null }, \"shipTo\": { \"name\": \"The President\", \"company\": \"US Govt\", \"street1\": \"1600 Pennsylvania Ave\", \"street2\": \"Oval Office\", \"street3\": null, \"city\": \"Washington\", \"state\": \"DC\", \"postalCode\": \"20500\", \"country\": \"US\", \"phone\": \"555-555-5555\", \"residential\": false, \"addressVerified\": \"Address validation warning\" }, \"items\": [ { \"orderItemId\": 128836912, \"lineItemKey\": \"vd08-MSLbtx\", \"sku\": \"ABC123\", \"name\": \"Test item #1\", \"imageUrl\": null, \"weight\": { \"value\": 24, \"units\": \"ounces\" }, \"quantity\": 2, \"unitPrice\": 99.99, \"taxAmount\": null, \"shippingAmount\": null, \"warehouseLocation\": \"Aisle 1, Bin 7\", \"options\": [ { \"name\": \"Size\", \"value\": \"Large\" } ], \"productId\": 7239919, \"fulfillmentSku\": null, \"adjustment\": false, \"upc\": null, \"createDate\": \"2015-07-16T14:00:34.823\", \"modifyDate\": \"2015-07-16T14:00:34.823\" }, { \"orderItemId\": 128836913, \"lineItemKey\": null, \"sku\": \"DISCOUNT CODE\", \"name\": \"10% OFF\", \"imageUrl\": null, \"weight\": { \"value\": 0, \"units\": \"ounces\" }, \"quantity\": 1, \"unitPrice\": -20.55, \"taxAmount\": null, \"shippingAmount\": null, \"warehouseLocation\": null, \"options\": [], \"productId\": null, \"fulfillmentSku\": null, \"adjustment\": true, \"upc\": null, \"createDate\": \"2015-07-16T14:00:34.823\", \"modifyDate\": \"2015-07-16T14:00:34.823\" } ], \"orderTotal\": 194.43, \"amountPaid\": 218.73, \"taxAmount\": 5, \"shippingAmount\": 10, \"customerNotes\": \"Thanks for ordering!\", \"internalNotes\": \"Customer called and would like to upgrade shipping\", \"gift\": true, \"giftMessage\": \"Thank you!\", \"paymentMethod\": \"Credit Card\", \"requestedShippingService\": \"Priority Mail\", \"carrierCode\": \"fedex\", \"serviceCode\": \"fedex_home_delivery\", \"packageCode\": \"package\", \"confirmation\": \"delivery\", \"shipDate\": \"2015-07-02\", \"holdUntilDate\": null, \"weight\": { \"value\": 48, \"units\": \"ounces\" }, \"dimensions\": { \"units\": \"inches\", \"length\": 7, \"width\": 5, \"height\": 6 }, \"insuranceOptions\": { \"provider\": \"carrier\", \"insureShipment\": true, \"insuredValue\": 200 }, \"internationalOptions\": { \"contents\": null, \"customsItems\": null, \"nonDelivery\": null }, \"advancedOptions\": { \"warehouseId\": 24079, \"nonMachinable\": false, \"saturdayDelivery\": false, \"containsAlcohol\": false, \"mergedOrSplit\": false, \"mergedIds\": [], \"parentId\": null, \"storeId\": 26815, \"customField1\": \"Custom data that you can add to an order. See Custom Field #2 & #3 for more info!\", \"customField2\": \"Per UI settings, this information can appear on some carrier's shipping labels. See link below\", \"customField3\": \"https://help.shipstation.com/hc/en-us/articles/206639957\", \"source\": \"Webstore\", \"billToParty\": null, \"billToAccount\": null, \"billToPostalCode\": null, \"billToCountryCode\": null }, \"tagIds\": null, \"userId\": null, \"externallyFulfilled\": false, \"externallyFulfilledBy\": null }"
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: Get Order1
- x-testDescription: Retrieves a single order from the database.
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- delete:
- description: Removes order from ShipStation's UI. Note this is a "soft" delete action so the order will still exist in the database, but will be set to ``inactive``
- summary: Delete Order
- tags:
- - Orders
- operationId: OrdersByOrderIdDelete
- produces:
- - application/json
- parameters:
- - name: orderId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: The system generated identifier for the order.
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/DeleteOrderResponse'
- examples:
- application/json:
- success: true
- message: The requested order has been deleted.
- security:
- - auth: []
- x-unitTests:
- - request:
- method: DELETE
- uri: /orders/123456789
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers: {}
- body: '{ "success": true, "message": "The requested order has been deleted."}'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: Delete Order1
- x-testDescription: Removes order from ShipStation's UI. Note this is a "soft" delete action so the order will still exist in the database, but will be set to ``inactive``
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /orders/addtag:
- post:
- description: >-
- Adds a tag to an order. The body of this request should specify the following attributes:
- Name |Data Type |Description
- -------------------|-------------------|-------------------
- ``orderId`` | number, required | Identifies the order that will be tagged.
- ``tagId`` | number, required | Identifies the tag that will be applied to the order.
- summary: Add Tag to Order
- tags:
- - Orders
- operationId: OrdersAddtagPost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/AddTagToOrderRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/AddTagToOrderResponse'
- examples:
- application/json:
- success: true
- message: Tag added successfully.
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /orders/assignuser:
- post:
- description: >-
- Assigns a user to an order. The body of this request should specify the following attributes:
- Name |Data Type |Description
- -------------------|-------------------|-------------------
- ``orderIds`` | number, required | Identifies set of orders that will be assigned the user. Please note that if ANY of the orders within the array are not found, no orders will have a user assigned to them.
- ``userId`` | number, required | Identifies the user that will be applied to the orders. It should contain a GUID of the user to be assigned to the array of orders.
- summary: Assign User to Order
- tags:
- - Orders
- operationId: OrdersAssignuserPost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/AssignUserToOrderRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/AssignUserToOrderResponse'
- examples:
- application/json:
- success: true
- message: User assigned successfully.
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /orders/createlabelfororder:
- post:
- description: >-
- Creates a shipping label for a given order. The ``labelData`` field returned in the response is a base64 encoded PDF value. Simply decode and save the output as a PDF file to retrieve a printable label. The body of this request should specify the following attributes:
- Name |Data Type |Description
- -------------------|-------------------|-------------------
- ``orderId`` | number, required | Identifies the order that will be shipped.
- ``carrierCode`` | string, required | The code for the carrier that is to be used for the label.
- ``serviceCode`` | string, required | The code for the shipping service that is to be used for the label.
- ``confirmation`` | string, required | The type of delivery confirmation that is to be used once the shipment is created. Possible values: ``none``, ``delivery``, ``signature``, ``adult_signature``, and ``direct_signature``. ``direct_signature`` is available for FedEx only.
- ``shipDate`` | string, required | The date the order should be shipped.
- ``weight`` | Weight, optional | Weight of the order. Use the [**Weight**](http://www.shipstation.com/developer-api/#/reference/model-weight) model.
- ``dimensions`` | Dimensions, optional | Dimensions of the order. Use [**Dimensions**](http://www.shipstation.com/developer-api/#/reference/model-dimensions) model.
- ``insuranceOptions`` | InsuranceOptions, optional | The shipping insurance information associated with this label. Use the [**InsuranceOptions**](http://www.shipstation.com/developer-api/#/reference/model-insuranceoptions) model.
- ``internationalOptions`` | InternationalOptions, optional | Customs information that can be used to generate customs documents for international orders. Use the [**InternationalOptions**](http://www.shipstation.com/developer-api/#/reference/model-internationaloptions) model.
- ``advancedOptions`` | AdvancedOptions, optional | Various advanced options that may be available depending on the shipping carrier that is used to ship the order. Use the Customs information that can be used to generate customs documents for international orders. Use the [**AdvancedOptions**](http://www.shipstation.com/developer-api/#/reference/model-advancedoptions) model.
- ``testLabel`` | boolean, required | Specifies whether a test label should be created.
- summary: Create Label for Order
- tags:
- - Orders
- operationId: OrdersCreatelabelfororderPost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/CreateLabelForOrderRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/CreateLabelForOrderResponse'
- examples:
- application/json:
- shipmentId: 72513480
- shipmentCost: 7.2999999999999998
- insuranceCost: 0
- trackingNumber: 248201115029520
- labelData: JVBERi0xLjQKJeLjz9MKMiAwIG9iago8PC9MZW5ndGggNjIvRmlsdGVyL0ZsYXRlRGVjb2RlPj5zdHJlYW0KeJwr5HIK4TI2UzC2NFMISeFyDeEK5CpUMFQwAEJDBV0jCz0LBV1jY0M9I4XkXAX9iDRDBZd8hUAuAEdGC7cKZW5kc3RyZWFtCmVuZG9iago0IDAgb2JqCjw8L1R5cGUvUGFnZS9NZWRpYUJveFswIDAgMjg4IDQzMl0vUmVzb3VyY2VzPDwvUHJvY1NldCBbL1BERiAvVGV4dCAvSW1hZ2VCIC9JbWFnZUMgL0ltYWdlSV0vWE9iamVjdDw8L1hmMSAxIDAgUj4+Pj4vQ29udGVudHMgMiAwIFIvUGFyZW50....
- formData:
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /orders/createorder:
- post:
- description: "If the ``orderKey`` is specified, the method becomes idempotent and the existing order with that key will be updated. Note: Only orders in an open status in ShipStation (``awaiting_payment``,``awaiting_shipment``, and ``on_hold``) can be updated through this method. ``cancelled`` and ``shipped`` are locked from modification through the API. The body of this request should specify an [**Order**](https://www.shipstation.com/developer-api/#/reference/model-order) object:\nName |Data Type |Description\n-------------------|-------------------|-------------------\n``orderNumber`` | string, required | A user-defined order number used to identify an order.\n``orderKey`` | string, optional | A user-provided key that should be unique to each order. If an orderKey is not provided, ShipStation will create a new order and generate a unique orderKey for that order. If the orderKey *is* provided, the **createorder** method will either: create a new order if the provided orderKey is not found, or, update the existing order if the orderKey is found.\n``orderDate`` | string, required | The date the order was placed.\n``paymentDate`` | string, optional | The date the order was paid for.\n``shipByDate`` | string, optional | The date the order is to be shipped before or on. This field is a suggested value generated by the order source/platform/cart and passed to ShipStation.\n``orderStatus`` | string, required | The order's status. Possible values: ``awaiting_payment``, ``awaiting_shipment``, ``shipped``, ``on_hold``, ``cancelled``\n``customerUsername`` | string, optional | The customer's username.\n``customerEmail`` | string, optional | The customer's email address.\n``billTo`` | Address, required | The recipients billing address. Use the [**Address**](https://www.shipstation.com/developer-api/#/reference/model-address) model.\n``shipTo`` | Address, required | The recipient's shipping address. Use the [**Address**](http://www.shipstation.com/developer-api/#/reference/model-address) model.\n``items`` | OrderItem, optional | An array of item objects. Use an array of [**OrderItem**](http://www.shipstation.com/developer-api/#/reference/model-orderitem) models.\n``amountPaid`` | number, optional | The total amount paid for the Order.\n``taxAmount`` | number, optional | The total tax amount for the Order.\n``shippingAmount`` | number, optional | Shipping amount paid by the customer, if any.\n``customerNotes`` | string, optional | Notes left by the customer when placing the order.\n``internalNotes`` | string, optional | Private notes that are only visible to the seller.\n``gift`` | boolean, optional | Specifies whether or not this Order is a gift\n``giftMessage`` | string, optional | Gift message left by the customer when placing the order.\n``paymentMethod`` | string, optional | Method of payment used by the customer.\n``requestedShippingService`` | string, optional |Identifies the shipping service selected by the customer when placing this order. This value is given to ShipStation by the marketplace/cart and helps identify what shipping service the customer selected upon checkout.\n``carrierCode`` | string, optional | The code for the carrier that is to be used(or was used) when this order is shipped(was shipped).\n``serviceCode`` | string, optional | The code for the shipping service that is to be used(or was used) when this order is shipped(was shipped).\n``packageCode`` | string, optional | The code for the package type that is to be used(or was used) when this order is shipped(was shipped).\n``confirmation`` | string, optional | The type of delivery confirmation that is to be used(or was used) when this order is shipped(was shipped). Possible values: ``none``, ``delivery``, ``signature``, ``adult_signature``, and ``direct_signature``. ``direct_signature`` is available for FedEx only. \n``shipDate`` | string, optional | The date the order was shipped.\n``weight`` | Weight, optional | Weight of the order. Use the [**Weight**](http://www.shipstation.com/developer-api/#/reference/model-weight) model.\n``dimensions`` | Dimensions, optional | Dimensions of the order. Use the [**Dimensions**](http://www.shipstation.com/developer-api/#/reference/model-dimensions) model.\n``insuranceOptions`` | InsuranceOptions, optional | The shipping insurance information associated with this order. Use the [**InsuranceOptions**](http://www.shipstation.com/developer-api/#/reference/model-insuranceoptions) model.\n``internationalOptions`` | InternationalOptions, optional | Customs information that can be used to generate customs documents for international orders. Use the [**InternationalOptions**](http://www.shipstation.com/developer-api/#/reference/model-internationaloptions) model.\n``advancedOptions`` | AdvancedOptions, optional | Various advanced options that may be available depending on the shipping carrier that is used to ship the order. Use the [**AdvancedOptions**](http://www.shipstation.com/developer-api/#/reference/model-advancedoptions) model."
- summary: Create/Update Order
- tags:
- - Orders
- operationId: OrdersCreateorderPost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/Create~1updateOrderRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/Create~1updateOrderResponse'
- examples:
- application/json:
- orderId: 140335319
- orderNumber: TEST-ORDER-API-DOCS
- orderKey: 0f6bec18-3e89-4881-83aa-f392d84f4c74
- orderDate: 2015-06-29T08:46:27.0000000
- createDate: 2016-02-16T15:16:53.7070000
- modifyDate: 2016-02-16T15:16:53.7070000
- paymentDate: 2015-06-29T08:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId:
- customerUsername: headhoncho@whitehouse.gov
- customerEmail: headhoncho@whitehouse.gov
- billTo:
- name: The President
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: The President
- company: US Govt
- street1: 1600 Pennsylvania Ave
- street2: Oval Office
- street3:
- city: Washington
- state: DC
- postalCode: 20500
- country: US
- phone: 555-555-5555
- residential: false
- addressVerified: Address validation warning
- items:
- - orderItemId: 192210956
- lineItemKey: vd08-MSLbtx
- sku: ABC123
- name: 'Test item #1'
- imageUrl:
- weight:
- value: 24
- units: ounces
- quantity: 2
- unitPrice: 99.989999999999995
- taxAmount: 2.5
- shippingAmount: 5
- warehouseLocation: Aisle 1, Bin 7
- options:
- - name: Size
- value: Large
- productId:
- fulfillmentSku:
- adjustment: false
- upc: 32-65-98
- createDate: 2016-02-16T15:16:53.7070000
- modifyDate: 2016-02-16T15:16:53.7070000
- - orderItemId: 192210957
- lineItemKey:
- sku: DISCOUNT CODE
- name: 10% OFF
- imageUrl:
- weight:
- value: 0
- units: ounces
- quantity: 1
- unitPrice: -20.550000000000001
- taxAmount:
- shippingAmount:
- warehouseLocation:
- options: []
- productId:
- fulfillmentSku: SKU-Discount
- adjustment: true
- upc:
- createDate: 2016-02-16T15:16:53.7070000
- modifyDate: 2016-02-16T15:16:53.7070000
- orderTotal: 194.43000000000001
- amountPaid: 218.72999999999999
- taxAmount: 5
- shippingAmount: 10
- customerNotes: Thanks for ordering!
- internalNotes: Customer called and would like to upgrade shipping
- gift: true
- giftMessage: Thank you!
- paymentMethod: Credit Card
- requestedShippingService: Priority Mail
- carrierCode: fedex
- serviceCode: fedex_2day
- packageCode: package
- confirmation: delivery
- shipDate: 2015-07-02
- holdUntilDate:
- weight:
- value: 25
- units: ounces
- dimensions:
- units: inches
- length: 7
- width: 5
- height: 6
- insuranceOptions:
- provider: carrier
- insureShipment: true
- insuredValue: 200
- internationalOptions:
- contents:
- customsItems:
- nonDelivery:
- advancedOptions:
- warehouseId: 9876
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'Custom data that you can add to an order. See Custom Field #2 & #3 for more info!'
- customField2: Per UI settings, this information can appear on some carrier's shipping labels. See link below
- customField3: https://help.shipstation.com/hc/en-us/articles/206639957
- source: Webstore
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- userId:
- externallyFulfilled: false
- externallyFulfilledBy:
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /orders/createorders:
- post:
- description: >-
- This endpoint can be used to create or update multiple orders in one request. If the ``orderKey`` is specified in an order, the existing order with that key will be updated. Note: Only orders in an open status in ShipStation (``awaiting_payment``,``awaiting_shipment``, and ``on_hold``) can be updated through this method. ``cancelled`` and ``shipped`` are locked from modification through the API.
- Data Type |Description
- -------------------|-------------------
- Order, required | An array of [**Order**](http://www.shipstation.com/developer-api/#/reference/model-order) objects (maximum of 100 per request)
- summary: Create/Update Multiple Orders
- tags:
- - Orders
- operationId: OrdersCreateordersPost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- type: array
- items:
- $ref: '#/definitions/Create~1updateMultipleOrdersRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/Create~1updateMultipleOrdersResponse'
- examples:
- application/json:
- hasErrors: false
- results:
- - orderId: 58345234
- orderNumber: TEST-ORDER-API-DOCS
- orderKey: 0f6bec18-3e89-4881-83aa-f392d84f4c74
- success: true
- errorMessage:
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /orders/holduntil:
- post:
- description: >-
- This method will change the status of the given order to On Hold until the date specified, when the status will automatically change to Awaiting Shipment.
- The body of this request should specify the following attributes:
- Name |Data Type |Description
- -------------------|-------------------|-------------------
- ``orderId`` | number, required | Identifies the order that will be held.
- ``holdUntilDate`` | string, required | Date when order is moved from ``on_hold`` status to ``awaiting_shipment``.
- summary: Hold Order Until
- tags:
- - Orders
- operationId: OrdersHolduntilPost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/HoldOrderUntilRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/HoldOrderUntilResponse'
- examples:
- application/json:
- success: true
- message: Order held successfully.
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /orders:
- get:
- description: ''
- summary: List Orders w/o parameters
- tags:
- - Orders
- operationId: OrdersGet
- produces:
- - application/json
- parameters: []
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/ListOrdersW~1oParametersResponse'
- examples:
- application/json:
- orders:
- - orderId: 987654321
- orderNumber: Test-International-API-DOCS
- orderKey: Test-International-API-DOCS
- orderDate: 2015-06-28T17:46:27.0000000
- createDate: 2015-08-17T09:24:14.7800000
- modifyDate: 2015-08-17T09:24:16.4800000
- paymentDate: 2015-06-28T17:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId: 63310475
- customerUsername: sholmes1854@methodsofdetection.com
- customerEmail: sholmes1854@methodsofdetection.com
- billTo:
- name: Sherlock Holmes
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: Sherlock Holmes
- company: ''
- street1: 221 B Baker St
- street2: ''
- street3:
- city: London
- state: ''
- postalCode: NW1 6XE
- country: GB
- phone:
- residential: true
- addressVerified: Address not yet validated
- items:
- - orderItemId: 136282568
- lineItemKey:
- sku: Ele-1234
- name: Elementary Disguise Kit
- imageUrl:
- weight:
- value: 12
- units: ounces
- quantity: 2
- unitPrice: 49.990000000000002
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 1, Bin 7
- options: []
- productId: 11780610
- fulfillmentSku: Ele-1234
- adjustment: false
- upc:
- createDate: 2015-08-17T09:24:14.7800000
- modifyDate: 2015-08-17T09:24:14.7800000
- - orderItemId: 136282569
- lineItemKey:
- sku: CN-9876
- name: Fine White Oak Cane
- imageUrl:
- weight:
- value: 80
- units: ounces
- quantity: 1
- unitPrice: 225
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 7, Bin 34
- options: []
- productId: 11780609
- fulfillmentSku:
- adjustment: false
- upc:
- createDate: 2015-08-17T09:24:14.7800000
- modifyDate: 2015-08-17T09:24:14.7800000
- orderTotal: 387.97000000000003
- amountPaid: 412.97000000000003
- taxAmount: 27.989999999999998
- shippingAmount: 35
- customerNotes: Please be careful when packing the disguise kits in with the cane.
- internalNotes: Mr. Holmes called to upgrade his shipping to expedited
- gift: false
- giftMessage:
- paymentMethod:
- requestedShippingService: Priority Mail Int
- carrierCode: stamps_com
- serviceCode: usps_priority_mail_international
- packageCode: package
- confirmation: delivery
- shipDate: 2015-04-25
- holdUntilDate:
- weight:
- value: 104
- units: ounces
- dimensions:
- units: inches
- length: 40
- width: 7
- height: 5
- insuranceOptions:
- provider:
- insureShipment: false
- insuredValue: 0
- internationalOptions:
- contents: merchandise
- customsItems:
- - customsItemId: 11558268
- description: Fine White Oak Cane
- quantity: 1
- value: 225
- harmonizedTariffCode:
- countryOfOrigin: US
- - customsItemId: 11558267
- description: Elementary Disguise Kit
- quantity: 2
- value: 49.990000000000002
- harmonizedTariffCode:
- countryOfOrigin: US
- nonDelivery: return_to_sender
- advancedOptions:
- warehouseId: 98765
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'SKU: CN-9876 x 1'
- customField2: 'SKU: Ele-123 x 2'
- customField3:
- source:
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- userId:
- externallyFulfilled: false
- externallyFulfilledBy:
- - orderId: 123456789
- orderNumber: TEST-ORDER-API-DOCS
- orderKey: 0f6bec18-9-4771-83aa-f392d84f4c74
- orderDate: 2015-06-29T08:46:27.0000000
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-08-17T09:21:59.4430000
- paymentDate: 2015-06-29T08:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId: 37701499
- customerUsername: headhoncho@whitehouse.gov
- customerEmail: headhoncho@whitehouse.gov
- billTo:
- name: The President
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: The President
- company: US Govt
- street1: 1600 Pennsylvania Ave
- street2: Oval Office
- street3:
- city: Washington
- state: DC
- postalCode: 20500
- country: US
- phone: 555-555-5555
- residential: false
- addressVerified: Address validation warning
- items:
- - orderItemId: 128836912
- lineItemKey: vd08-MSLbtx
- sku: ABC123
- name: 'Test item #1'
- imageUrl:
- weight:
- value: 24
- units: ounces
- quantity: 2
- unitPrice: 99.989999999999995
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 1, Bin 7
- options:
- - name: Size
- value: Large
- productId: 7239919
- fulfillmentSku:
- adjustment: false
- upc:
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-07-16T14:00:34.8230000
- - orderItemId: 128836913
- lineItemKey:
- sku: DISCOUNT CODE
- name: 10% OFF
- imageUrl:
- weight:
- value: 0
- units: ounces
- quantity: 1
- unitPrice: -20.550000000000001
- taxAmount:
- shippingAmount:
- warehouseLocation:
- options: []
- productId:
- fulfillmentSku:
- adjustment: true
- upc:
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-07-16T14:00:34.8230000
- orderTotal: 194.43000000000001
- amountPaid: 218.72999999999999
- taxAmount: 5
- shippingAmount: 10
- customerNotes: Thanks for ordering!
- internalNotes: Customer called and would like to upgrade shipping
- gift: true
- giftMessage: Thank you!
- paymentMethod: Credit Card
- requestedShippingService: Priority Mail
- carrierCode: fedex
- serviceCode: fedex_home_delivery
- packageCode: package
- confirmation: delivery
- shipDate: 2015-07-02
- holdUntilDate:
- weight:
- value: 48
- units: ounces
- dimensions:
- units: inches
- length: 7
- width: 5
- height: 6
- insuranceOptions:
- provider: carrier
- insureShipment: true
- insuredValue: 200
- internationalOptions:
- contents:
- customsItems:
- nonDelivery:
- advancedOptions:
- warehouseId: 98765
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'Custom data that you can add to an order. See Custom Field #2 & #3 for more info!'
- customField2: Per UI settings, this information can appear on some carrier's shipping labels. See link below
- customField3: https://help.shipstation.com/hc/en-us/articles/206639957
- source: Webstore
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- userId:
- externallyFulfilled: false
- externallyFulfilledBy:
- total: 2
- page: 1
- pages: 0
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /orders
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: "{ \"orders\": [ { \"orderId\": 987654321, \"orderNumber\": \"Test-International-API-DOCS\", \"orderKey\": \"Test-International-API-DOCS\", \"orderDate\": \"2015-06-28T17:46:27.0000000\", \"createDate\": \"2015-08-17T09:24:14.7800000\", \"modifyDate\": \"2015-08-17T09:24:16.4800000\", \"paymentDate\": \"2015-06-28T17:46:27.0000000\", \"shipByDate\": \"2015-07-05T00:00:00.0000000\", \"orderStatus\": \"awaiting_shipment\", \"customerId\": 63310475, \"customerUsername\": \"sholmes1854@methodsofdetection.com\", \"customerEmail\": \"sholmes1854@methodsofdetection.com\", \"billTo\": { \"name\": \"Sherlock Holmes\", \"company\": null, \"street1\": null, \"street2\": null, \"street3\": null, \"city\": null, \"state\": null, \"postalCode\": null, \"country\": null, \"phone\": null, \"residential\": null, \"addressVerified\": null }, \"shipTo\": { \"name\": \"Sherlock Holmes\", \"company\": \"\", \"street1\": \"221 B Baker St\", \"street2\": \"\", \"street3\": null, \"city\": \"London\", \"state\": \"\", \"postalCode\": \"NW1 6XE\", \"country\": \"GB\", \"phone\": null, \"residential\": true, \"addressVerified\": \"Address not yet validated\" }, \"items\": [ { \"orderItemId\": 136282568, \"lineItemKey\": null, \"sku\": \"Ele-1234\", \"name\": \"Elementary Disguise Kit\", \"imageUrl\": null, \"weight\": { \"value\": 12, \"units\": \"ounces\" }, \"quantity\": 2, \"unitPrice\": 49.99, \"taxAmount\": null, \"shippingAmount\": null, \"warehouseLocation\": \"Aisle 1, Bin 7\", \"options\": [], \"productId\": 11780610, \"fulfillmentSku\": \"Ele-1234\", \"adjustment\": false, \"upc\": null, \"createDate\": \"2015-08-17T09:24:14.78\", \"modifyDate\": \"2015-08-17T09:24:14.78\" }, { \"orderItemId\": 136282569, \"lineItemKey\": null, \"sku\": \"CN-9876\", \"name\": \"Fine White Oak Cane\", \"imageUrl\": null, \"weight\": { \"value\": 80, \"units\": \"ounces\" }, \"quantity\": 1, \"unitPrice\": 225, \"taxAmount\": null, \"shippingAmount\": null, \"warehouseLocation\": \"Aisle 7, Bin 34\", \"options\": [], \"productId\": 11780609, \"fulfillmentSku\": null, \"adjustment\": false, \"upc\": null, \"createDate\": \"2015-08-17T09:24:14.78\", \"modifyDate\": \"2015-08-17T09:24:14.78\" } ], \"orderTotal\": 387.97, \"amountPaid\": 412.97, \"taxAmount\": 27.99, \"shippingAmount\": 35, \"customerNotes\": \"Please be careful when packing the disguise kits in with the cane.\", \"internalNotes\": \"Mr. Holmes called to upgrade his shipping to expedited\", \"gift\": false, \"giftMessage\": null, \"paymentMethod\": null, \"requestedShippingService\": \"Priority Mail Int\", \"carrierCode\": \"stamps_com\", \"serviceCode\": \"usps_priority_mail_international\", \"packageCode\": \"package\", \"confirmation\": \"delivery\", \"shipDate\": \"2015-04-25\", \"holdUntilDate\": null, \"weight\": { \"value\": 104, \"units\": \"ounces\" }, \"dimensions\": { \"units\": \"inches\", \"length\": 40, \"width\": 7, \"height\": 5 }, \"insuranceOptions\": { \"provider\": null, \"insureShipment\": false, \"insuredValue\": 0 }, \"internationalOptions\": { \"contents\": \"merchandise\", \"customsItems\": [ { \"customsItemId\": 11558268, \"description\": \"Fine White Oak Cane\", \"quantity\": 1, \"value\": 225, \"harmonizedTariffCode\": null, \"countryOfOrigin\": \"US\" }, { \"customsItemId\": 11558267, \"description\": \"Elementary Disguise Kit\", \"quantity\": 2, \"value\": 49.99, \"harmonizedTariffCode\": null, \"countryOfOrigin\": \"US\" } ], \"nonDelivery\": \"return_to_sender\" }, \"advancedOptions\": { \"warehouseId\": 98765, \"nonMachinable\": false, \"saturdayDelivery\": false, \"containsAlcohol\": false, \"mergedOrSplit\": false, \"mergedIds\": [], \"parentId\": null, \"storeId\": 12345, \"customField1\": \"SKU: CN-9876 x 1\", \"customField2\": \"SKU: Ele-123 x 2\", \"customField3\": null, \"source\": null, \"billToParty\": null, \"billToAccount\": null, \"billToPostalCode\": null, \"billToCountryCode\": null }, \"tagIds\": null, \"userId\": null, \"externallyFulfilled\": false, \"externallyFulfilledBy\": null }, { \"orderId\": 123456789, \"orderNumber\": \"TEST-ORDER-API-DOCS\", \"orderKey\": \"0f6bec18-9-4771-83aa-f392d84f4c74\", \"orderDate\": \"2015-06-29T08:46:27.0000000\", \"createDate\": \"2015-07-16T14:00:34.8230000\", \"modifyDate\": \"2015-08-17T09:21:59.4430000\", \"paymentDate\": \"2015-06-29T08:46:27.0000000\", \"shipByDate\": \"2015-07-05T00:00:00.0000000\", \"orderStatus\": \"awaiting_shipment\", \"customerId\": 37701499, \"customerUsername\": \"headhoncho@whitehouse.gov\", \"customerEmail\": \"headhoncho@whitehouse.gov\", \"billTo\": { \"name\": \"The President\", \"company\": null, \"street1\": null, \"street2\": null, \"street3\": null, \"city\": null, \"state\": null, \"postalCode\": null, \"country\": null, \"phone\": null, \"residential\": null, \"addressVerified\": null }, \"shipTo\": { \"name\": \"The President\", \"company\": \"US Govt\", \"street1\": \"1600 Pennsylvania Ave\", \"street2\": \"Oval Office\", \"street3\": null, \"city\": \"Washington\", \"state\": \"DC\", \"postalCode\": \"20500\", \"country\": \"US\", \"phone\": \"555-555-5555\", \"residential\": false, \"addressVerified\": \"Address validation warning\" }, \"items\": [ { \"orderItemId\": 128836912, \"lineItemKey\": \"vd08-MSLbtx\", \"sku\": \"ABC123\", \"name\": \"Test item #1\", \"imageUrl\": null, \"weight\": { \"value\": 24, \"units\": \"ounces\" }, \"quantity\": 2, \"unitPrice\": 99.99, \"taxAmount\": null, \"shippingAmount\": null, \"warehouseLocation\": \"Aisle 1, Bin 7\", \"options\": [ { \"name\": \"Size\", \"value\": \"Large\" } ], \"productId\": 7239919, \"fulfillmentSku\": null, \"adjustment\": false, \"upc\": null, \"createDate\": \"2015-07-16T14:00:34.823\", \"modifyDate\": \"2015-07-16T14:00:34.823\" }, { \"orderItemId\": 128836913, \"lineItemKey\": null, \"sku\": \"DISCOUNT CODE\", \"name\": \"10% OFF\", \"imageUrl\": null, \"weight\": { \"value\": 0, \"units\": \"ounces\" }, \"quantity\": 1, \"unitPrice\": -20.55, \"taxAmount\": null, \"shippingAmount\": null, \"warehouseLocation\": null, \"options\": [], \"productId\": null, \"fulfillmentSku\": null, \"adjustment\": true, \"upc\": null, \"createDate\": \"2015-07-16T14:00:34.823\", \"modifyDate\": \"2015-07-16T14:00:34.823\" } ], \"orderTotal\": 194.43, \"amountPaid\": 218.73, \"taxAmount\": 5, \"shippingAmount\": 10, \"customerNotes\": \"Thanks for ordering!\", \"internalNotes\": \"Customer called and would like to upgrade shipping\", \"gift\": true, \"giftMessage\": \"Thank you!\", \"paymentMethod\": \"Credit Card\", \"requestedShippingService\": \"Priority Mail\", \"carrierCode\": \"fedex\", \"serviceCode\": \"fedex_home_delivery\", \"packageCode\": \"package\", \"confirmation\": \"delivery\", \"shipDate\": \"2015-07-02\", \"holdUntilDate\": null, \"weight\": { \"value\": 48, \"units\": \"ounces\" }, \"dimensions\": { \"units\": \"inches\", \"length\": 7, \"width\": 5, \"height\": 6 }, \"insuranceOptions\": { \"provider\": \"carrier\", \"insureShipment\": true, \"insuredValue\": 200 }, \"internationalOptions\": { \"contents\": null, \"customsItems\": null, \"nonDelivery\": null }, \"advancedOptions\": { \"warehouseId\": 98765, \"nonMachinable\": false, \"saturdayDelivery\": false, \"containsAlcohol\": false, \"mergedOrSplit\": false, \"mergedIds\": [], \"parentId\": null, \"storeId\": 12345, \"customField1\": \"Custom data that you can add to an order. See Custom Field #2 & #3 for more info!\", \"customField2\": \"Per UI settings, this information can appear on some carrier's shipping labels. See link below\", \"customField3\": \"https://help.shipstation.com/hc/en-us/articles/206639957\", \"source\": \"Webstore\", \"billToParty\": null, \"billToAccount\": null, \"billToPostalCode\": null, \"billToCountryCode\": null }, \"tagIds\": null, \"userId\": null, \"externallyFulfilled\": false, \"externallyFulfilledBy\": null } ], \"total\": 2, \"page\": 1, \"pages\": 0}"
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: List Orders w/o parameters1
- x-testDescription: Testcase for testing endpoint List Orders w/o parameters
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- ? /orders?customerName={customerName}&itemKeyword={itemKeyword}&createDateStart={createDateStart}&createDateEnd={createDateEnd}&modifyDateStart={modifyDateStart}&modifyDateEnd={modifyDateEnd}&orderDateStart={orderDateStart}&orderDateEnd={orderDateEnd}&orderNumber={orderNumber}&orderStatus={orderStatus}&paymentDateStart={paymentDateStart}&paymentDateEnd={paymentDateEnd}&storeId={storeId}&sortBy={sortBy}&sortDir={sortDir}&page={page}&pageSize={pageSize}
- : get:
- description: >-
- Obtains a list of orders that match the specified criteria. All of the available filters are optional. They do not need to be included in the URL. If you do include them, here's what the URL may look like:
- Url format with filters:
- ```
- /orders?customerName={customerName}
- &itemKeyword={itemKeyword}
- &createDateStart={createDateStart}
- &createDateEnd={createDateEnd}
- &modifyDateStart={modifyDateStart}
- &modifyDateEnd={modifyDateEnd}
- &orderDateStart={orderDateStart}
- &orderDateEnd={orderDateEnd}
- &orderNumber={orderNumber}
- &orderStatus={orderStatus}
- &paymentDateStart={paymentDateStart}
- &paymentDateEnd={paymentDateEnd}
- &storeId={storeId}
- &sortBy={sortBy}
- &sortDir={sortDir}
- &page={page}
- &pageSize={pageSize}
- ```
- summary: List Orders with parameters
- tags:
- - Orders
- operationId: OrdersCreateDateStartCreateDateStartCreateDateEndCreateDateEndModifyDateStartModifyDateStartModifyDateEndModifyDateEndOrderDateStartOrderDateStartOrderDateEndOrderDateEndOrderNumberOrderNumberOrderStatusOrderStatusPaymentDateStartPaymentDateStartPaymentDateEndPaymentDateEndStoreIdStoreIdSortBySortBySortDirSortDirPagePagePageSizePageSizeByCustomerNameAndItemKeywordGet
- produces:
- - application/json
- parameters:
- - name: customerName
- in: path
- required: true
- type: string
- description: Returns orders that match the specified name.
- - name: itemKeyword
- in: path
- required: true
- type: string
- description: Returns orders that contain items that match the specified keyword. Fields searched are Sku, Description, and Options
- - name: createDateStart
- in: path
- required: true
- type: string
- description: Returns orders that were created in ShipStation after the specified date
- - name: createDateEnd
- in: path
- required: true
- type: string
- description: Returns orders that were created in ShipStation before the specified date
- - name: modifyDateStart
- in: path
- required: true
- type: string
- description: Returns orders that were modified after the specified date
- - name: modifyDateEnd
- in: path
- required: true
- type: string
- description: Returns orders that were modified before the specified date
- - name: orderDateStart
- in: path
- required: true
- type: string
- description: Returns orders greater than the specified date
- - name: orderDateEnd
- in: path
- required: true
- type: string
- description: Returns orders less than or equal to the specified date
- - name: orderNumber
- in: path
- required: true
- type: string
- description: Filter by order number, performs a "starts with" search.
- - name: orderStatus
- in: path
- required: true
- enum:
- - awaiting_payment
- - awaiting_shipment
- - pending_fulfillment
- - shipped
- - on_hold
- - cancelled
- x-enum-elements:
- - name: awaiting_payment
- description: ''
- - name: awaiting_shipment
- description: ''
- - name: pending_fulfillment
- description: ''
- - name: shipped
- description: ''
- - name: on_hold
- description: ''
- - name: cancelled
- description: ''
- type: string
- description: Filter by order status. If left empty, orders of all statuses are returned.
- - name: paymentDateStart
- in: path
- required: true
- type: string
- description: Returns orders that were paid after the specified date
- - name: paymentDateEnd
- in: path
- required: true
- type: string
- description: Returns orders that were paid before the specified date
- - name: storeId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: Filters orders to a single store. Call List Stores to obtain a list of store Ids.
- - name: sortBy
- in: path
- required: true
- enum:
- - OrderDate
- - ModifyDate
- - CreateDate
- x-enum-elements:
- - name: OrderDate
- description: ''
- - name: ModifyDate
- description: ''
- - name: CreateDate
- description: ''
- type: string
- description: Sort the responses by a set value. The response will be sorted based off the ascending dates (oldest to most current.) If left empty, the response will be sorted by ascending ``orderId``.
- - name: sortDir
- in: path
- required: true
- enum:
- - ASC
- - DESC
- x-enum-elements:
- - name: ASC
- description: ''
- - name: DESC
- description: ''
- type: string
- description: Sets the direction of the sort order.
- - name: page
- in: path
- required: true
- type: string
- description: Page number
- - name: pageSize
- in: path
- required: true
- type: string
- description: Requested page size. Max value is 500.
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/ListOrdersWithParametersResponse'
- examples:
- application/json:
- orders:
- - orderId: 987654321
- orderNumber: Test-International-API-DOCS
- orderKey: Test-International-API-DOCS
- orderDate: 2015-06-28T17:46:27.0000000
- createDate: 2015-08-17T09:24:14.7800000
- modifyDate: 2015-08-17T09:24:16.4800000
- paymentDate: 2015-06-28T17:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId: 63310475
- customerUsername: sholmes1854@methodsofdetection.com
- customerEmail: sholmes1854@methodsofdetection.com
- billTo:
- name: Sherlock Holmes
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: Sherlock Holmes
- company: ''
- street1: 221 B Baker St
- street2: ''
- street3:
- city: London
- state: ''
- postalCode: NW1 6XE
- country: GB
- phone:
- residential: true
- addressVerified: Address not yet validated
- items:
- - orderItemId: 136282568
- lineItemKey:
- sku: Ele-1234
- name: Elementary Disguise Kit
- imageUrl:
- weight:
- value: 12
- units: ounces
- quantity: 2
- unitPrice: 49.990000000000002
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 1, Bin 7
- options: []
- productId: 11780610
- fulfillmentSku: Ele-1234
- adjustment: false
- upc:
- createDate: 2015-08-17T09:24:14.7800000
- modifyDate: 2015-08-17T09:24:14.7800000
- - orderItemId: 136282569
- lineItemKey:
- sku: CN-9876
- name: Fine White Oak Cane
- imageUrl:
- weight:
- value: 80
- units: ounces
- quantity: 1
- unitPrice: 225
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 7, Bin 34
- options: []
- productId: 11780609
- fulfillmentSku:
- adjustment: false
- upc:
- createDate: 2015-08-17T09:24:14.7800000
- modifyDate: 2015-08-17T09:24:14.7800000
- orderTotal: 387.97000000000003
- amountPaid: 412.97000000000003
- taxAmount: 27.989999999999998
- shippingAmount: 35
- customerNotes: Please be careful when packing the disguise kits in with the cane.
- internalNotes: Mr. Holmes called to upgrade his shipping to expedited
- gift: false
- giftMessage:
- paymentMethod:
- requestedShippingService: Priority Mail Int
- carrierCode: stamps_com
- serviceCode: usps_priority_mail_international
- packageCode: package
- confirmation: delivery
- shipDate: 2015-04-25
- holdUntilDate:
- weight:
- value: 104
- units: ounces
- dimensions:
- units: inches
- length: 40
- width: 7
- height: 5
- insuranceOptions:
- provider:
- insureShipment: false
- insuredValue: 0
- internationalOptions:
- contents: merchandise
- customsItems:
- - customsItemId: 11558268
- description: Fine White Oak Cane
- quantity: 1
- value: 225
- harmonizedTariffCode:
- countryOfOrigin: US
- - customsItemId: 11558267
- description: Elementary Disguise Kit
- quantity: 2
- value: 49.990000000000002
- harmonizedTariffCode:
- countryOfOrigin: US
- nonDelivery: return_to_sender
- advancedOptions:
- warehouseId: 98765
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'SKU: CN-9876 x 1'
- customField2: 'SKU: Ele-123 x 2'
- customField3:
- source:
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- userId:
- externallyFulfilled: false
- externallyFulfilledBy:
- - orderId: 123456789
- orderNumber: TEST-ORDER-API-DOCS
- orderKey: 0f6bec18-9-4771-83aa-f392d84f4c74
- orderDate: 2015-06-29T08:46:27.0000000
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-08-17T09:21:59.4430000
- paymentDate: 2015-06-29T08:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId: 37701499
- customerUsername: headhoncho@whitehouse.gov
- customerEmail: headhoncho@whitehouse.gov
- billTo:
- name: The President
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: The President
- company: US Govt
- street1: 1600 Pennsylvania Ave
- street2: Oval Office
- street3:
- city: Washington
- state: DC
- postalCode: 20500
- country: US
- phone: 555-555-5555
- residential: false
- addressVerified: Address validation warning
- items:
- - orderItemId: 128836912
- lineItemKey: vd08-MSLbtx
- sku: ABC123
- name: 'Test item #1'
- imageUrl:
- weight:
- value: 24
- units: ounces
- quantity: 2
- unitPrice: 99.989999999999995
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 1, Bin 7
- options:
- - name: Size
- value: Large
- productId: 7239919
- fulfillmentSku:
- adjustment: false
- upc:
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-07-16T14:00:34.8230000
- - orderItemId: 128836913
- lineItemKey:
- sku: DISCOUNT CODE
- name: 10% OFF
- imageUrl:
- weight:
- value: 0
- units: ounces
- quantity: 1
- unitPrice: -20.550000000000001
- taxAmount:
- shippingAmount:
- warehouseLocation:
- options: []
- productId:
- fulfillmentSku:
- adjustment: true
- upc:
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-07-16T14:00:34.8230000
- orderTotal: 194.43000000000001
- amountPaid: 218.72999999999999
- taxAmount: 5
- shippingAmount: 10
- customerNotes: Thanks for ordering!
- internalNotes: Customer called and would like to upgrade shipping
- gift: true
- giftMessage: Thank you!
- paymentMethod: Credit Card
- requestedShippingService: Priority Mail
- carrierCode: fedex
- serviceCode: fedex_home_delivery
- packageCode: package
- confirmation: delivery
- shipDate: 2015-07-02
- holdUntilDate:
- weight:
- value: 48
- units: ounces
- dimensions:
- units: inches
- length: 7
- width: 5
- height: 6
- insuranceOptions:
- provider: carrier
- insureShipment: true
- insuredValue: 200
- internationalOptions:
- contents:
- customsItems:
- nonDelivery:
- advancedOptions:
- warehouseId: 98765
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'Custom data that you can add to an order. See Custom Field #2 & #3 for more info!'
- customField2: Per UI settings, this information can appear on some carrier's shipping labels. See link below
- customField3: https://help.shipstation.com/hc/en-us/articles/206639957
- source: Webstore
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- userId:
- externallyFulfilled: false
- externallyFulfilledBy:
- total: 2
- page: 1
- pages: 0
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /orders?customerName={customerName}&itemKeyword={itemKeyword}&createDateStart={createDateStart}&createDateEnd={createDateEnd}&modifyDateStart={modifyDateStart}&modifyDateEnd={modifyDateEnd}&orderDateStart={orderDateStart}&orderDateEnd={orderDateEnd}&orderNumber={orderNumber}&orderStatus={orderStatus}&paymentDateStart={paymentDateStart}&paymentDateEnd={paymentDateEnd}&storeId={storeId}&sortBy={sortBy}&sortDir={sortDir}&page={page}&pageSize={pageSize}
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: "{ \"orders\": [ { \"orderId\": 987654321, \"orderNumber\": \"Test-International-API-DOCS\", \"orderKey\": \"Test-International-API-DOCS\", \"orderDate\": \"2015-06-28T17:46:27.0000000\", \"createDate\": \"2015-08-17T09:24:14.7800000\", \"modifyDate\": \"2015-08-17T09:24:16.4800000\", \"paymentDate\": \"2015-06-28T17:46:27.0000000\", \"shipByDate\": \"2015-07-05T00:00:00.0000000\", \"orderStatus\": \"awaiting_shipment\", \"customerId\": 63310475, \"customerUsername\": \"sholmes1854@methodsofdetection.com\", \"customerEmail\": \"sholmes1854@methodsofdetection.com\", \"billTo\": { \"name\": \"Sherlock Holmes\", \"company\": null, \"street1\": null, \"street2\": null, \"street3\": null, \"city\": null, \"state\": null, \"postalCode\": null, \"country\": null, \"phone\": null, \"residential\": null, \"addressVerified\": null }, \"shipTo\": { \"name\": \"Sherlock Holmes\", \"company\": \"\", \"street1\": \"221 B Baker St\", \"street2\": \"\", \"street3\": null, \"city\": \"London\", \"state\": \"\", \"postalCode\": \"NW1 6XE\", \"country\": \"GB\", \"phone\": null, \"residential\": true, \"addressVerified\": \"Address not yet validated\" }, \"items\": [ { \"orderItemId\": 136282568, \"lineItemKey\": null, \"sku\": \"Ele-1234\", \"name\": \"Elementary Disguise Kit\", \"imageUrl\": null, \"weight\": { \"value\": 12, \"units\": \"ounces\" }, \"quantity\": 2, \"unitPrice\": 49.99, \"taxAmount\": null, \"shippingAmount\": null, \"warehouseLocation\": \"Aisle 1, Bin 7\", \"options\": [], \"productId\": 11780610, \"fulfillmentSku\": \"Ele-1234\", \"adjustment\": false, \"upc\": null, \"createDate\": \"2015-08-17T09:24:14.78\", \"modifyDate\": \"2015-08-17T09:24:14.78\" }, { \"orderItemId\": 136282569, \"lineItemKey\": null, \"sku\": \"CN-9876\", \"name\": \"Fine White Oak Cane\", \"imageUrl\": null, \"weight\": { \"value\": 80, \"units\": \"ounces\" }, \"quantity\": 1, \"unitPrice\": 225, \"taxAmount\": null, \"shippingAmount\": null, \"warehouseLocation\": \"Aisle 7, Bin 34\", \"options\": [], \"productId\": 11780609, \"fulfillmentSku\": null, \"adjustment\": false, \"upc\": null, \"createDate\": \"2015-08-17T09:24:14.78\", \"modifyDate\": \"2015-08-17T09:24:14.78\" } ], \"orderTotal\": 387.97, \"amountPaid\": 412.97, \"taxAmount\": 27.99, \"shippingAmount\": 35, \"customerNotes\": \"Please be careful when packing the disguise kits in with the cane.\", \"internalNotes\": \"Mr. Holmes called to upgrade his shipping to expedited\", \"gift\": false, \"giftMessage\": null, \"paymentMethod\": null, \"requestedShippingService\": \"Priority Mail Int\", \"carrierCode\": \"stamps_com\", \"serviceCode\": \"usps_priority_mail_international\", \"packageCode\": \"package\", \"confirmation\": \"delivery\", \"shipDate\": \"2015-04-25\", \"holdUntilDate\": null, \"weight\": { \"value\": 104, \"units\": \"ounces\" }, \"dimensions\": { \"units\": \"inches\", \"length\": 40, \"width\": 7, \"height\": 5 }, \"insuranceOptions\": { \"provider\": null, \"insureShipment\": false, \"insuredValue\": 0 }, \"internationalOptions\": { \"contents\": \"merchandise\", \"customsItems\": [ { \"customsItemId\": 11558268, \"description\": \"Fine White Oak Cane\", \"quantity\": 1, \"value\": 225, \"harmonizedTariffCode\": null, \"countryOfOrigin\": \"US\" }, { \"customsItemId\": 11558267, \"description\": \"Elementary Disguise Kit\", \"quantity\": 2, \"value\": 49.99, \"harmonizedTariffCode\": null, \"countryOfOrigin\": \"US\" } ], \"nonDelivery\": \"return_to_sender\" }, \"advancedOptions\": { \"warehouseId\": 98765, \"nonMachinable\": false, \"saturdayDelivery\": false, \"containsAlcohol\": false, \"mergedOrSplit\": false, \"mergedIds\": [], \"parentId\": null, \"storeId\": 12345, \"customField1\": \"SKU: CN-9876 x 1\", \"customField2\": \"SKU: Ele-123 x 2\", \"customField3\": null, \"source\": null, \"billToParty\": null, \"billToAccount\": null, \"billToPostalCode\": null, \"billToCountryCode\": null }, \"tagIds\": null, \"userId\": null, \"externallyFulfilled\": false, \"externallyFulfilledBy\": null }, { \"orderId\": 123456789, \"orderNumber\": \"TEST-ORDER-API-DOCS\", \"orderKey\": \"0f6bec18-9-4771-83aa-f392d84f4c74\", \"orderDate\": \"2015-06-29T08:46:27.0000000\", \"createDate\": \"2015-07-16T14:00:34.8230000\", \"modifyDate\": \"2015-08-17T09:21:59.4430000\", \"paymentDate\": \"2015-06-29T08:46:27.0000000\", \"shipByDate\": \"2015-07-05T00:00:00.0000000\", \"orderStatus\": \"awaiting_shipment\", \"customerId\": 37701499, \"customerUsername\": \"headhoncho@whitehouse.gov\", \"customerEmail\": \"headhoncho@whitehouse.gov\", \"billTo\": { \"name\": \"The President\", \"company\": null, \"street1\": null, \"street2\": null, \"street3\": null, \"city\": null, \"state\": null, \"postalCode\": null, \"country\": null, \"phone\": null, \"residential\": null, \"addressVerified\": null }, \"shipTo\": { \"name\": \"The President\", \"company\": \"US Govt\", \"street1\": \"1600 Pennsylvania Ave\", \"street2\": \"Oval Office\", \"street3\": null, \"city\": \"Washington\", \"state\": \"DC\", \"postalCode\": \"20500\", \"country\": \"US\", \"phone\": \"555-555-5555\", \"residential\": false, \"addressVerified\": \"Address validation warning\" }, \"items\": [ { \"orderItemId\": 128836912, \"lineItemKey\": \"vd08-MSLbtx\", \"sku\": \"ABC123\", \"name\": \"Test item #1\", \"imageUrl\": null, \"weight\": { \"value\": 24, \"units\": \"ounces\" }, \"quantity\": 2, \"unitPrice\": 99.99, \"taxAmount\": null, \"shippingAmount\": null, \"warehouseLocation\": \"Aisle 1, Bin 7\", \"options\": [ { \"name\": \"Size\", \"value\": \"Large\" } ], \"productId\": 7239919, \"fulfillmentSku\": null, \"adjustment\": false, \"upc\": null, \"createDate\": \"2015-07-16T14:00:34.823\", \"modifyDate\": \"2015-07-16T14:00:34.823\" }, { \"orderItemId\": 128836913, \"lineItemKey\": null, \"sku\": \"DISCOUNT CODE\", \"name\": \"10% OFF\", \"imageUrl\": null, \"weight\": { \"value\": 0, \"units\": \"ounces\" }, \"quantity\": 1, \"unitPrice\": -20.55, \"taxAmount\": null, \"shippingAmount\": null, \"warehouseLocation\": null, \"options\": [], \"productId\": null, \"fulfillmentSku\": null, \"adjustment\": true, \"upc\": null, \"createDate\": \"2015-07-16T14:00:34.823\", \"modifyDate\": \"2015-07-16T14:00:34.823\" } ], \"orderTotal\": 194.43, \"amountPaid\": 218.73, \"taxAmount\": 5, \"shippingAmount\": 10, \"customerNotes\": \"Thanks for ordering!\", \"internalNotes\": \"Customer called and would like to upgrade shipping\", \"gift\": true, \"giftMessage\": \"Thank you!\", \"paymentMethod\": \"Credit Card\", \"requestedShippingService\": \"Priority Mail\", \"carrierCode\": \"fedex\", \"serviceCode\": \"fedex_home_delivery\", \"packageCode\": \"package\", \"confirmation\": \"delivery\", \"shipDate\": \"2015-07-02\", \"holdUntilDate\": null, \"weight\": { \"value\": 48, \"units\": \"ounces\" }, \"dimensions\": { \"units\": \"inches\", \"length\": 7, \"width\": 5, \"height\": 6 }, \"insuranceOptions\": { \"provider\": \"carrier\", \"insureShipment\": true, \"insuredValue\": 200 }, \"internationalOptions\": { \"contents\": null, \"customsItems\": null, \"nonDelivery\": null }, \"advancedOptions\": { \"warehouseId\": 98765, \"nonMachinable\": false, \"saturdayDelivery\": false, \"containsAlcohol\": false, \"mergedOrSplit\": false, \"mergedIds\": [], \"parentId\": null, \"storeId\": 12345, \"customField1\": \"Custom data that you can add to an order. See Custom Field #2 & #3 for more info!\", \"customField2\": \"Per UI settings, this information can appear on some carrier's shipping labels. See link below\", \"customField3\": \"https://help.shipstation.com/hc/en-us/articles/206639957\", \"source\": \"Webstore\", \"billToParty\": null, \"billToAccount\": null, \"billToPostalCode\": null, \"billToCountryCode\": null }, \"tagIds\": null, \"userId\": null, \"externallyFulfilled\": false, \"externallyFulfilledBy\": null } ], \"total\": 2, \"page\": 1, \"pages\": 0}"
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: List Orders with parameters1
- x-testDescription: >-
- Obtains a list of orders that match the specified criteria. All of the available filters are optional. They do not need to be included in the URL. If you do include them, here's what the URL may look like:
- Url format with filters:
- ```
- /orders?customerName={customerName}
- &itemKeyword={itemKeyword}
- &createDateStart={createDateStart}
- &createDateEnd={createDateEnd}
- &modifyDateStart={modifyDateStart}
- &modifyDateEnd={modifyDateEnd}
- &orderDateStart={orderDateStart}
- &orderDateEnd={orderDateEnd}
- &orderNumber={orderNumber}
- &orderStatus={orderStatus}
- &paymentDateStart={paymentDateStart}
- &paymentDateEnd={paymentDateEnd}
- &storeId={storeId}
- &sortBy={sortBy}
- &sortDir={sortDir}
- &page={page}
- &pageSize={pageSize}
- ```
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /orders/listbytag?orderStatus={orderStatus}&tagId={tagId}&page={page}&pageSize={pageSize}:
- get:
- description: >-
- Lists all orders that match the specified status and tag ID.
- Url format with filters:
- ```
- /listbytag?orderStatus={orderStatus}
- &tagId={tagId}
- &page={page}
- &pageSize={pageSize}
- ```
- summary: List Orders by Tag
- tags:
- - Orders
- operationId: OrdersListbytagPagePagePageSizePageSizeByOrderStatusAndTagIdGet
- produces:
- - application/json
- parameters:
- - name: orderStatus
- in: path
- required: true
- enum:
- - awaiting_payment
- - awaiting_shipment
- - pending_fulfillment
- - shipped
- - on_hold
- - cancelled
- x-enum-elements:
- - name: awaiting_payment
- description: ''
- - name: awaiting_shipment
- description: ''
- - name: pending_fulfillment
- description: ''
- - name: shipped
- description: ''
- - name: on_hold
- description: ''
- - name: cancelled
- description: ''
- type: string
- description: The order's status.
- - name: tagId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: ID of the tag. Call Accounts/ListTags to obtain a list of tags for this account.
- - name: page
- in: path
- required: true
- type: string
- description: Page number
- - name: pageSize
- in: path
- required: true
- type: string
- description: Requested page size. Max value is 500.
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/ListOrdersByTagResponse'
- examples:
- application/json:
- orders:
- - orderId: 123456789
- orderNumber: TEST-ORDER-API-DOCS
- orderKey: 0f6bec18-3e89-4881-83aa-f392d84f4c74
- orderDate: 2015-06-29T08:46:27.0000000
- createDate: 2015-08-17T09:43:03.0500000
- modifyDate: 2015-08-17T09:43:12.5500000
- paymentDate: 2015-06-29T08:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId: 37701499
- customerUsername: headhoncho@whitehouse.gov
- customerEmail: headhoncho@whitehouse.gov
- billTo:
- name: The President
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: The President
- company: US Govt
- street1: 1600 Pennsylvania Ave
- street2: Oval Office
- street3:
- city: Washington
- state: DC
- postalCode: 20500
- country: US
- phone: 555-555-5555
- residential: false
- addressVerified: Address validation warning
- items:
- - orderItemId: 136289188
- lineItemKey: vd08-MSLbtx
- sku: ABC123
- name: 'Test item #1'
- imageUrl:
- weight:
- value: 24
- units: ounces
- quantity: 2
- unitPrice: 99.989999999999995
- taxAmount: 2.5
- shippingAmount: 5
- warehouseLocation: Aisle 1, Bin 7
- options:
- - name: Size
- value: Large
- productId: 7239919
- fulfillmentSku:
- adjustment: false
- upc: 32-65-98
- createDate: 2015-08-17T09:43:03.0500000
- modifyDate: 2015-08-17T09:43:03.0500000
- - orderItemId: 136289189
- lineItemKey:
- sku: DISCOUNT CODE
- name: 10% OFF
- imageUrl:
- weight:
- value: 0
- units: ounces
- quantity: 1
- unitPrice: -20.550000000000001
- taxAmount:
- shippingAmount:
- warehouseLocation:
- options: []
- productId:
- fulfillmentSku: SKU-Discount
- adjustment: true
- upc:
- createDate: 2015-08-17T09:43:03.0500000
- modifyDate: 2015-08-17T09:43:03.0500000
- orderTotal: 194.43000000000001
- amountPaid: 218.72999999999999
- taxAmount: 5
- shippingAmount: 10
- customerNotes: Thanks for ordering!
- internalNotes: Customer called and would like to upgrade shipping
- gift: true
- giftMessage: Thank you!
- paymentMethod: Credit Card
- requestedShippingService: Priority Mail
- carrierCode: fedex
- serviceCode: fedex_2day
- packageCode: package
- confirmation: delivery
- shipDate: 2015-07-02
- holdUntilDate:
- weight:
- value: 48
- units: ounces
- dimensions:
- units: inches
- length: 7
- width: 5
- height: 6
- insuranceOptions:
- provider: carrier
- insureShipment: true
- insuredValue: 200
- internationalOptions:
- contents:
- customsItems:
- nonDelivery:
- advancedOptions:
- warehouseId: 98765
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'Custom data that you can add to an order. See Custom Field #2 & #3 for more info!'
- customField2: Per UI settings, this information can appear on some carrier's shipping labels. See link below
- customField3: https://help.shipstation.com/hc/en-us/articles/206639957
- source: Webstore
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- - 831
- userId: b854f701-e0c2-4156-90fe-19c77cdef27c
- externallyFulfilled: false
- externallyFulfilledBy:
- total: 1
- page: 1
- pages: 1
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /orders/markasshipped:
- post:
- description: >-
- Marks an order as shipped without creating a label in ShipStation. The body of this request has the following attributes:
- Name |Data Type |Description
- -------------------|-------------------|-------------------
- ``orderId`` | number, required | Identifies the order that will be marked as shipped.
- ``carrierCode`` | string, required | Code of the carrier that is marked as having shipped the order.
- ``shipDate`` | string, optional | Date order was shipped.
- ``trackingNumber`` | string, optional | Tracking number of shipment.
- ``notifyCustomer`` | boolean, optional | Specifies whether the customer should be notified of the shipment. Default value: false
- ``notifySalesChannel`` | boolean, optional | Specifies whether the sales channel should be notified of the shipment. Default value: false
- summary: Mark an Order as Shipped
- tags:
- - Orders
- operationId: OrdersMarkasshippedPost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/MarkAnOrderAsShippedRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/MarkAnOrderAsShippedResponse'
- examples:
- application/json:
- orderId: 123456789
- orderNumber: ABC123
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /orders/removetag:
- post:
- description: >-
- Removes a tag from the specified order. The body of this request has the following attributes:
- Name |Data Type |Description
- -------------------|-------------------|-------------------
- ``orderId`` | number, required | Identifies the order whose tag will be removed.
- ``tagId`` | number, required | Identifies the tag to remove.
- summary: Remove Tag from Order
- tags:
- - Orders
- operationId: OrdersRemovetagPost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/RemoveTagFromOrderRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/RemoveTagFromOrderResponse'
- examples:
- application/json:
- success: true
- message: Tag removed successfully.
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /orders/restorefromhold:
- post:
- description: >-
- This method will change the status of the given order from On Hold to Awaiting Shipment. This endpoint is used when a holdUntil Date is attached to an order.
- The body of this request should specify the following attributes:
- Name |Data Type |Description
- -------------------|-------------------|-------------------
- ``orderId`` | number, required | Identifies the order that will be restored to ``awaiting_shipment`` from ``on_hold``.
- summary: Restore Order from On Hold
- tags:
- - Orders
- operationId: OrdersRestorefromholdPost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/RestoreOrderFromOnHoldRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/RestoreOrderFromOnHoldResponse'
- examples:
- application/json:
- success: true
- message: The requested order has been restored
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /orders/unassignuser:
- post:
- description: >-
- Unassigns a user from an order. The body of this request should specify the following attributes:
- Name |Data Type |Description
- -------------------|-------------------|-------------------
- ``orderIds`` | number, required | Identifies set of orders that will have the user unassigned. Please note that if ANY of the orders within the array are not found, then no orders will have their users unassigned.
- summary: Unassign User from Order
- tags:
- - Orders
- operationId: OrdersUnassignuserPost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/UnassignUserFromOrderRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/UnassignUserFromOrderResponse'
- examples:
- application/json:
- success: true
- message: User unassigned successfully.
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /products/{productId}:
- get:
- description: ''
- summary: Get Product
- tags:
- - Products
- operationId: ProductsByProductIdGet
- produces:
- - application/json
- parameters:
- - name: productId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: The system generated identifier for the Product.
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/GetProductResponse'
- examples:
- application/json:
- aliases:
- productId: 12345678
- sku: 1004
- name: Coffee Mug
- price: 26
- defaultCost: 0
- length: 3
- width: 3
- height: 3
- weightOz: 26
- internalNotes:
- fulfillmentSku: F1004
- createDate: 2014-09-04T09:18:01.2930000
- modifyDate: 2014-09-18T12:38:43.8930000
- active: true
- productCategory:
- categoryId: 9999
- name: Door Closers
- productType:
- warehouseLocation: Bin 22
- defaultCarrierCode: fedex
- defaultServiceCode: fedex_home_delivery
- defaultPackageCode: package
- defaultIntlCarrierCode: ups
- defaultIntlServiceCode: ups_worldwide_saver
- defaultIntlPackageCode: package
- defaultConfirmation: direct_signature
- defaultIntlConfirmation: adult_signature
- customsDescription:
- customsValue:
- customsTariffNo:
- customsCountryCode:
- noCustoms:
- tags:
- - tagId: 9180
- name: APItest
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /products/12345678
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers: {}
- body: '{ "aliases": null, "productId": 12345678, "sku": "1004", "name": "Coffee Mug", "price": 26, "defaultCost": 0, "length": 3, "width": 3, "height": 3, "weightOz": 26, "internalNotes": null, "fulfillmentSku": "F1004", "createDate": "2014-09-04T09:18:01.293", "modifyDate": "2014-09-18T12:38:43.893", "active": true, "productCategory": { "categoryId": 9999, "name": "Door Closers" }, "productType": null, "warehouseLocation": "Bin 22", "defaultCarrierCode": "fedex", "defaultServiceCode": "fedex_home_delivery", "defaultPackageCode": "package", "defaultIntlCarrierCode": "ups", "defaultIntlServiceCode": "ups_worldwide_saver", "defaultIntlPackageCode": "package", "defaultConfirmation": "direct_signature", "defaultIntlConfirmation": "adult_signature", "customsDescription": null, "customsValue": null, "customsTariffNo": null, "customsCountryCode": null, "noCustoms": null, "tags": [ { "tagId": 9180, "name": "APItest" } ] }'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: Get Product1
- x-testDescription: Testcase for testing endpoint Get Product
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- put:
- description: Updates an existing product. This call does not currently support partial updates. The entire resource must be provided in the body of the request.
- summary: Update Product
- tags:
- - Products
- operationId: ProductsByProductIdPut
- produces:
- - application/json
- parameters:
- - name: productId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: The system generated identifier for the Product.
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/UpdateProductRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/UpdateProductResponse'
- examples:
- application/json:
- success: true
- message: The requested product has been updated
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /products:
- get:
- description: ''
- summary: List Products w/o parameters
- tags:
- - Products
- operationId: ProductsGet
- produces:
- - application/json
- parameters: []
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/ListProductsW~1oParametersResponse'
- examples:
- application/json:
- products:
- - aliases:
- productId: 7854008
- sku: 1004
- name: Coffee Mug
- price: 26
- defaultCost: 0
- length: 3
- width: 3
- height: 3
- weightOz: 26
- internalNotes:
- fulfillmentSku: F1004
- createDate: 2014-09-04T09:18:01.2930000
- modifyDate: 2014-09-18T12:38:43.8930000
- active: true
- productCategory:
- categoryId: 9999
- name: Door Closers
- productType:
- warehouseLocation: Bin 22
- defaultCarrierCode: fedex
- defaultServiceCode: fedex_home_delivery
- defaultPackageCode: package
- defaultIntlCarrierCode: ups
- defaultIntlServiceCode: ups_worldwide_saver
- defaultIntlPackageCode: package
- defaultConfirmation: direct_signature
- defaultIntlConfirmation: adult_signature
- customsDescription:
- customsValue:
- customsTariffNo:
- customsCountryCode:
- noCustoms:
- tags:
- - tagId: 9180
- name: APItest
- - aliases:
- productId: 7984482
- sku: FirstSKU
- name: Product Name 123
- price: 10
- defaultCost:
- length: 2
- width: 3
- height: 4
- weightOz: 96
- internalNotes:
- fulfillmentSku: fSkuFill
- createDate: 2014-09-18T08:17:28.6470000
- modifyDate: 2014-09-18T12:32:40.2570000
- active: true
- productCategory:
- categoryId: 9690
- name: Floor Matting
- productType:
- warehouseLocation: Bin 100
- defaultCarrierCode: ups
- defaultServiceCode: ups_ground
- defaultPackageCode: package
- defaultIntlCarrierCode:
- defaultIntlServiceCode:
- defaultIntlPackageCode: package
- defaultConfirmation: delivery
- defaultIntlConfirmation:
- customsDescription: customs declaration
- customsValue: 100
- customsTariffNo: 1234567
- customsCountryCode: US
- noCustoms:
- tags:
- - tagId: 9180
- name: APItest
- total: 2
- page: 1
- pages: 0
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /products
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: ' { "products":[ { "aliases": null, "productId":7854008, "sku":"1004", "name":"Coffee Mug", "price":26, "defaultCost":0, "length":3, "width":3, "height":3, "weightOz":26, "internalNotes":null, "fulfillmentSku":"F1004", "createDate":"2014-09-04T09:18:01.293", "modifyDate":"2014-09-18T12:38:43.893", "active":true, "productCategory":{ "categoryId":9999, "name":"Door Closers" }, "productType":null, "warehouseLocation":"Bin 22", "defaultCarrierCode":"fedex", "defaultServiceCode":"fedex_home_delivery", "defaultPackageCode":"package", "defaultIntlCarrierCode":"ups", "defaultIntlServiceCode":"ups_worldwide_saver", "defaultIntlPackageCode":"package", "defaultConfirmation":"direct_signature", "defaultIntlConfirmation":"adult_signature", "customsDescription":null, "customsValue":null, "customsTariffNo":null, "customsCountryCode":null, "noCustoms":null, "tags":[ { "tagId":9180, "name":"APItest" } ] }, { "aliases": null, "productId":7984482, "sku":"FirstSKU", "name":"Product Name 123", "price":10, "defaultCost":null, "length":2, "width":3, "height":4, "weightOz":96, "internalNotes":null, "fulfillmentSku":"fSkuFill", "createDate":"2014-09-18T08:17:28.647", "modifyDate":"2014-09-18T12:32:40.257", "active":true, "productCategory":{ "categoryId":9690, "name":"Floor Matting" }, "productType":null, "warehouseLocation":"Bin 100", "defaultCarrierCode":"ups", "defaultServiceCode":"ups_ground", "defaultPackageCode":"package", "defaultIntlCarrierCode":null, "defaultIntlServiceCode":null, "defaultIntlPackageCode":"package", "defaultConfirmation":"delivery", "defaultIntlConfirmation":null, "customsDescription":"customs declaration", "customsValue":100, "customsTariffNo":"1234567", "customsCountryCode":"US", "noCustoms":null, "tags":[ { "tagId":9180, "name":"APItest" } ] } ], "total":2, "page":1, "pages":0 }'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: List Products w/o parameters1
- x-testDescription: Testcase for testing endpoint List Products w/o parameters
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- ? /products?sku={sku}&name={name}&productCategoryId={productCategoryId}&productTypeId={productTypeId}&tagId={tagId}&startDate={startDate}&endDate={endDate}&showInactive={showInactive}&sortBy={sortBy}&sortDir={sortDir}&page={page}&pageSize={pageSize}
- : get:
- description: >-
- Obtains a list of products that match the specified criteria. All of the available filters are optional. They do not need to be included in the URL. If you do include them, here's what the URL may look like:
- Url format with filters:
- ```
- /products?sku={sku}
- &name={name}
- &productCategoryId={productCategoryId}
- &productTypeId={productTypeId}
- &tagId={tagId}
- &startDate={startDate}
- &endDate={endDate}
- &showInactive={showInactive}
- &sortBy={sortBy}
- &sortDir={sortDir}
- &page={page}
- &pageSize={pageSize}
- ```
- summary: List Products with parameters
- tags:
- - Products
- operationId: ProductsProductCategoryIdProductCategoryIdProductTypeIdProductTypeIdTagIdTagIdStartDateStartDateEndDateEndDateShowInactiveShowInactiveSortBySortBySortDirSortDirPagePagePageSizePageSizeBySkuAndNameGet
- produces:
- - application/json
- parameters:
- - name: sku
- in: path
- required: true
- type: string
- description: Returns products that match the specified SKU.
- - name: name
- in: path
- required: true
- type: string
- description: Returns products that match the specified product name.
- - name: productCategoryId
- in: path
- required: true
- type: string
- description: Returns products that match the specified productCategoryId.
- - name: productTypeId
- in: path
- required: true
- type: string
- description: Returns products that match the specified productTypeId.
- - name: tagId
- in: path
- required: true
- type: string
- description: Returns products that match the specified tagId.
- - name: startDate
- in: path
- required: true
- type: string
- description: Returns products that were created after the specified date.
- - name: endDate
- in: path
- required: true
- type: string
- description: Returns products that were created before the specified date.
- - name: sortBy
- in: path
- required: true
- enum:
- - SKU
- - ModifyDate
- - CreateDate
- x-enum-elements:
- - name: SKU
- description: ''
- - name: ModifyDate
- description: ''
- - name: CreateDate
- description: ''
- type: string
- description: Sorts the order of the response based off the specified value.
- - name: sortDir
- in: path
- required: true
- enum:
- - ASC
- - DESC
- x-enum-elements:
- - name: ASC
- description: ''
- - name: DESC
- description: ''
- type: string
- description: Sets the direction of the sort order.
- - name: page
- in: path
- required: true
- type: string
- description: Page number.
- - name: pageSize
- in: path
- required: true
- type: string
- description: Requested page size. Max value is 500.
- - name: showInactive
- in: path
- required: true
- type: string
- description: Specifies whether the list should include inactive products.
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/ListProductsWithParametersResponse'
- examples:
- application/json:
- products:
- - aliases:
- productId: 7854008
- sku: 1004
- name: Coffee Mug
- price: 26
- defaultCost: 0
- length: 3
- width: 3
- height: 3
- weightOz: 26
- internalNotes:
- fulfillmentSku: F1004
- createDate: 2014-09-04T09:18:01.2930000
- modifyDate: 2014-09-18T12:38:43.8930000
- active: true
- productCategory:
- categoryId: 9999
- name: Door Closers
- productType:
- warehouseLocation: Bin 22
- defaultCarrierCode: fedex
- defaultServiceCode: fedex_home_delivery
- defaultPackageCode: package
- defaultIntlCarrierCode: ups
- defaultIntlServiceCode: ups_worldwide_saver
- defaultIntlPackageCode: package
- defaultConfirmation: direct_signature
- defaultIntlConfirmation: adult_signature
- customsDescription:
- customsValue:
- customsTariffNo:
- customsCountryCode:
- noCustoms:
- tags:
- - tagId: 9180
- name: APItest
- - aliases:
- productId: 7984482
- sku: FirstSKU
- name: Product Name 123
- price: 10
- defaultCost:
- length: 2
- width: 3
- height: 4
- weightOz: 96
- internalNotes:
- fulfillmentSku: fSkuFill
- createDate: 2014-09-18T08:17:28.6470000
- modifyDate: 2014-09-18T12:32:40.2570000
- active: true
- productCategory:
- categoryId: 9690
- name: Floor Matting
- productType:
- warehouseLocation: Bin 100
- defaultCarrierCode: ups
- defaultServiceCode: ups_ground
- defaultPackageCode: package
- defaultIntlCarrierCode:
- defaultIntlServiceCode:
- defaultIntlPackageCode: package
- defaultConfirmation: delivery
- defaultIntlConfirmation:
- customsDescription: customs declaration
- customsValue: 100
- customsTariffNo: 1234567
- customsCountryCode: US
- noCustoms:
- tags:
- - tagId: 9180
- name: APItest
- total: 2
- page: 1
- pages: 0
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /products?sku={sku}&name={name}&productCategoryId={productCategoryId}&productTypeId={productTypeId}&tagId={tagId}&startDate={startDate}&endDate={endDate}&showInactive={showInactive}&sortBy={sortBy}&sortDir={sortDir}&page={page}&pageSize={pageSize}
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: ' { "products":[ { "aliases": null, "productId":7854008, "sku":"1004", "name":"Coffee Mug", "price":26, "defaultCost":0, "length":3, "width":3, "height":3, "weightOz":26, "internalNotes":null, "fulfillmentSku":"F1004", "createDate":"2014-09-04T09:18:01.293", "modifyDate":"2014-09-18T12:38:43.893", "active":true, "productCategory":{ "categoryId":9999, "name":"Door Closers" }, "productType":null, "warehouseLocation":"Bin 22", "defaultCarrierCode":"fedex", "defaultServiceCode":"fedex_home_delivery", "defaultPackageCode":"package", "defaultIntlCarrierCode":"ups", "defaultIntlServiceCode":"ups_worldwide_saver", "defaultIntlPackageCode":"package", "defaultConfirmation":"direct_signature", "defaultIntlConfirmation":"adult_signature", "customsDescription":null, "customsValue":null, "customsTariffNo":null, "customsCountryCode":null, "noCustoms":null, "tags":[ { "tagId":9180, "name":"APItest" } ] }, { "aliases": null, "productId":7984482, "sku":"FirstSKU", "name":"Product Name 123", "price":10, "defaultCost":null, "length":2, "width":3, "height":4, "weightOz":96, "internalNotes":null, "fulfillmentSku":"fSkuFill", "createDate":"2014-09-18T08:17:28.647", "modifyDate":"2014-09-18T12:32:40.257", "active":true, "productCategory":{ "categoryId":9690, "name":"Floor Matting" }, "productType":null, "warehouseLocation":"Bin 100", "defaultCarrierCode":"ups", "defaultServiceCode":"ups_ground", "defaultPackageCode":"package", "defaultIntlCarrierCode":null, "defaultIntlServiceCode":null, "defaultIntlPackageCode":"package", "defaultConfirmation":"delivery", "defaultIntlConfirmation":null, "customsDescription":"customs declaration", "customsValue":100, "customsTariffNo":"1234567", "customsCountryCode":"US", "noCustoms":null, "tags":[ { "tagId":9180, "name":"APItest" } ] } ], "total":2, "page":1, "pages":0 }'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: List Products with parameters1
- x-testDescription: >-
- Obtains a list of products that match the specified criteria. All of the available filters are optional. They do not need to be included in the URL. If you do include them, here's what the URL may look like:
- Url format with filters:
- ```
- /products?sku={sku}
- &name={name}
- &productCategoryId={productCategoryId}
- &productTypeId={productTypeId}
- &tagId={tagId}
- &startDate={startDate}
- &endDate={endDate}
- &showInactive={showInactive}
- &sortBy={sortBy}
- &sortDir={sortDir}
- &page={page}
- &pageSize={pageSize}
- ```
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /shipments:
- get:
- description: ''
- summary: List Shipments w/o parameters
- tags:
- - Shipments
- operationId: ShipmentsGet
- produces:
- - application/json
- parameters: []
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/ListShipmentsW~1oParametersResponse'
- examples:
- application/json:
- shipments:
- - shipmentId: 33974374
- orderId: 43945660
- userId: 123456AB-ab12-3c4d-5e67-89f1abc1defa
- orderNumber: 100038-1
- createDate: 2014-10-03T06:51:33.6270000
- shipDate: 2014-10-03
- shipmentCost: 1.9299999999999999
- insuranceCost: 0
- trackingNumber: 9400111899561704681189
- isReturnLabel: false
- batchNumber: 100301
- carrierCode: stamps_com
- serviceCode: usps_first_class_mail
- packageCode: package
- confirmation: delivery
- warehouseId: 16079
- voided: false
- voidDate:
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Yoda
- company: ''
- street1: 12223 LOWDEN LN
- street2: ''
- street3:
- city: MANCHACA
- state: TX
- postalCode: 78652-3602
- country: US
- phone: 2101235544
- residential:
- weight:
- value: 1
- units: ounces
- dimensions:
- insuranceOptions:
- provider:
- insureShipment: false
- insuredValue: 0
- advancedOptions:
- shipmentItems:
- - orderItemId: 56568665
- lineItemKey:
- sku: SQ3785739
- name: Potato Kitten -
- imageUrl:
- weight:
- quantity: 1
- unitPrice: 1
- warehouseLocation:
- options:
- productId: 7565777
- fulfillmentSku:
- labelData:
- formData:
- - shipmentId: 33974373
- orderId: 43337328
- userId: 123456AB-ab12-3c4d-5e67-89f1abc1defa
- orderNumber: 100028
- createDate: 2014-10-03T06:51:59.9430000
- shipDate: 2014-10-03
- shipmentCost: 1.9299999999999999
- insuranceCost: 0
- trackingNumber: 9400111899561704681196
- isReturnLabel: false
- batchNumber: 100300
- carrierCode: stamps_com
- serviceCode: usps_first_class_mail
- packageCode: package
- confirmation: delivery
- warehouseId: 14265
- voided: false
- voidDate:
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Luke Skywalker
- company: SS
- street1: 2815 EXPOSITION BLVD
- street2: ''
- street3:
- city: AUSTIN
- state: TX
- postalCode: 78703-1221
- country: US
- phone: ''
- residential:
- weight:
- value: 1
- units: ounces
- dimensions:
- insuranceOptions:
- provider:
- insureShipment: false
- insuredValue: 0
- advancedOptions:
- shipmentItems:
- - orderItemId: 55827278
- lineItemKey:
- sku: test
- name: test
- imageUrl:
- weight:
- quantity: 1
- unitPrice: 1
- warehouseLocation:
- options:
- productId: 7541107
- fulfillmentSku:
- labelData:
- formData:
- total: 2
- page: 1
- pages: 0
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /shipments
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: '{ "shipments": [ { "shipmentId": 33974374, "orderId": 43945660, "userId": "123456AB-ab12-3c4d-5e67-89f1abc1defa", "orderNumber": "100038-1", "createDate": "2014-10-03T06:51:33.6270000", "shipDate": "2014-10-03", "shipmentCost": 1.93, "insuranceCost": 0, "trackingNumber": "9400111899561704681189", "isReturnLabel": false, "batchNumber": "100301", "carrierCode": "stamps_com", "serviceCode": "usps_first_class_mail", "packageCode": "package", "confirmation": "delivery", "warehouseId": 16079, "voided": false, "voidDate": null, "marketplaceNotified": true, "notifyErrorMessage": null, "shipTo": { "name": "Yoda", "company": "", "street1": "12223 LOWDEN LN", "street2": "", "street3": null, "city": "MANCHACA", "state": "TX", "postalCode": "78652-3602", "country": "US", "phone": "2101235544", "residential": null }, "weight": { "value": 1, "units": "ounces" }, "dimensions": null, "insuranceOptions": { "provider": null, "insureShipment": false, "insuredValue": 0 }, "advancedOptions": null, "shipmentItems": [ { "orderItemId": 56568665, "lineItemKey": null, "sku": "SQ3785739", "name": "Potato Kitten -", "imageUrl": null, "weight": null, "quantity": 1, "unitPrice": 1, "warehouseLocation": null, "options": null, "productId": 7565777, "fulfillmentSku": null } ], "labelData": null, "formData": null }, { "shipmentId": 33974373, "orderId": 43337328, "userId": "123456AB-ab12-3c4d-5e67-89f1abc1defa", "orderNumber": "100028", "createDate": "2014-10-03T06:51:59.9430000", "shipDate": "2014-10-03", "shipmentCost": 1.93, "insuranceCost": 0, "trackingNumber": "9400111899561704681196", "isReturnLabel": false, "batchNumber": "100300", "carrierCode": "stamps_com", "serviceCode": "usps_first_class_mail", "packageCode": "package", "confirmation": "delivery", "warehouseId": 14265, "voided": false, "voidDate": null, "marketplaceNotified": true, "notifyErrorMessage": null, "shipTo": { "name": "Luke Skywalker", "company": "SS", "street1": "2815 EXPOSITION BLVD", "street2": "", "street3": null, "city": "AUSTIN", "state": "TX", "postalCode": "78703-1221", "country": "US", "phone": "", "residential": null }, "weight": { "value": 1, "units": "ounces" }, "dimensions": null, "insuranceOptions": { "provider": null, "insureShipment": false, "insuredValue": 0 }, "advancedOptions": null, "shipmentItems": [ { "orderItemId": 55827278, "lineItemKey": null, "sku": "test", "name": "test", "imageUrl": null, "weight": null, "quantity": 1, "unitPrice": 1, "warehouseLocation": null, "options": null, "productId": 7541107, "fulfillmentSku": null } ], "labelData": null, "formData": null } ], "total": 2, "page": 1, "pages": 0}'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: List Shipments w/o parameters1
- x-testDescription: Testcase for testing endpoint List Shipments w/o parameters
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- ? /shipments?recipientName={recipientName}&recipientCountryCode={recipientCountryCode}&orderNumber={orderNumber}&orderId={orderId}&carrierCode={carrierCode}&serviceCode={serviceCode}&trackingNumber={trackingNumber}&createDateStart={createDateStart}&createDateEnd={createDateEnd}&shipDateStart={shipDateStart}&shipDateEnd={shipDateEnd}&voidDateStart={voidDateStart}&voidDateEnd={voidDateEnd}&includeShipmentItems={includeShipmentItems}&sortBy={sortBy}&sortDir={sortDir}&page={page}&pageSize={pageSize}
- : get:
- description: >-
- Obtains a list of shipments that match the specified criteria. Please note the following:
- - Only valid shipments with labels generated in ShipStation will be returned in the response. Orders that have been marked as shipped either through the UI or the API will not appear as they are considered external shipments.
- - To include every shipment's associated shipmentItems in the response, be sure to set the `includeShipmentItems` parameter to `true`.
- All of the available filters are optional. They do not need to be included in the URL. If you do include them, here's what the URL may look like:
- Url format with filters:
- ```
- shipments?recipientName={recipientName}
- &recipientCountryCode={recipientCountryCode}
- &orderNumber={orderNumber}
- &orderId={orderId}
- &carrierCode={carrierCode}
- &serviceCode={serviceCode}
- &trackingNumber={trackingNumber}
- &createDateStart={createDateStart}
- &createDateEnd={createDateEnd}
- &shipDateStart={shipDateStart}
- &shipDateEnd={shipDateEnd}
- &voidDateStart={voidDateStart}
- &voidDateEnd={voidDateEnd}
- &includeShipmentItems={includeShipmentItems}
- &sortBy={sortBy}
- &sortDir={sortDir}
- &page={page}
- &pageSize={pageSize}
- ```
- summary: List Shipments with parameters
- tags:
- - Shipments
- operationId: ShipmentsOrderNumberOrderNumberOrderIdOrderIdCarrierCodeCarrierCodeServiceCodeServiceCodeTrackingNumberTrackingNumberCreateDateStartCreateDateStartCreateDateEndCreateDateEndShipDateStartShipDateStartShipDateEndShipDateEndVoidDateStartVoidDateStartVoidDateEndVoidDateEndIncludeShipmentItemsIncludeShipmentItemsSortBySortBySortDirSortDirPagePagePageSizePageSizeByRecipientNameAndRecipientCountryCodeGet
- produces:
- - application/json
- parameters:
- - name: recipientName
- in: path
- required: true
- type: string
- description: Returns shipments shipped to the specified recipient name.
- - name: recipientCountryCode
- in: path
- required: true
- type: string
- description: Returns shipments shipped to the specified country code.
- - name: orderNumber
- in: path
- required: true
- type: string
- description: Returns shipments whose orders have the specified order number.
- - name: orderId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: Returns shipments whose orders have the specified order ID.
- - name: carrierCode
- in: path
- required: true
- type: string
- description: Returns shipments shipped with the specified carrier.
- - name: serviceCode
- in: path
- required: true
- type: string
- description: Returns shipments shipped with the specified shipping service.
- - name: trackingNumber
- in: path
- required: true
- type: string
- description: Returns shipments with the specified tracking number.
- - name: createDateStart
- in: path
- required: true
- type: string
- description: Returns shipments created on or after the specified ``createDate``
- - name: createDateEnd
- in: path
- required: true
- type: string
- description: Returns shipments created on or before the specified ``createDate``
- - name: shipDateStart
- in: path
- required: true
- type: string
- description: Returns shipments with the ``shipDate`` on or after the specified date
- - name: shipDateEnd
- in: path
- required: true
- type: string
- description: Returns shipments with the ``shipDate`` on or before the specified date
- - name: voidDateStart
- in: path
- required: true
- type: string
- description: Returns shipments voided on or after the specified date
- - name: voidDateEnd
- in: path
- required: true
- type: string
- description: Returns shipments voided on or before the specified date
- - name: includeShipmentItems
- in: path
- required: true
- type: boolean
- description: 'Specifies whether to include shipment items with results Default value: false.'
- - name: sortBy
- in: path
- required: true
- enum:
- - ShipDate
- - CreateDate
- x-enum-elements:
- - name: ShipDate
- description: ''
- - name: CreateDate
- description: ''
- type: string
- description: Sort the responses by a set value. The response will be sorted based off the ascending dates (oldest to most current.) If left empty, the response will be sorted by ascending ``createDate``.
- - name: sortDir
- in: path
- required: true
- enum:
- - ASC
- - DESC
- x-enum-elements:
- - name: ASC
- description: ''
- - name: DESC
- description: ''
- type: string
- description: Sets the direction of the sort order.
- - name: page
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: page number.
- - name: pageSize
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: page size.
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/ListShipmentsWithParametersResponse'
- examples:
- application/json:
- shipments:
- - shipmentId: 33974374
- orderId: 43945660
- userId: 123456AB-ab12-3c4d-5e67-89f1abc1defa
- orderNumber: 100038-1
- createDate: 2014-10-03T06:51:33.6270000
- shipDate: 2014-10-03
- shipmentCost: 1.9299999999999999
- insuranceCost: 0
- trackingNumber: 9400111899561704681189
- isReturnLabel: false
- batchNumber: 100301
- carrierCode: stamps_com
- serviceCode: usps_first_class_mail
- packageCode: package
- confirmation: delivery
- warehouseId: 16079
- voided: false
- voidDate:
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Yoda
- company: ''
- street1: 12223 LOWDEN LN
- street2: ''
- street3:
- city: MANCHACA
- state: TX
- postalCode: 78652-3602
- country: US
- phone: 2101235544
- residential:
- weight:
- value: 1
- units: ounces
- dimensions:
- insuranceOptions:
- provider:
- insureShipment: false
- insuredValue: 0
- advancedOptions:
- shipmentItems:
- - orderItemId: 56568665
- lineItemKey:
- sku: SQ3785739
- name: Potato Kitten -
- imageUrl:
- weight:
- quantity: 1
- unitPrice: 1
- warehouseLocation:
- options:
- productId: 7565777
- fulfillmentSku:
- labelData:
- formData:
- - shipmentId: 33974373
- orderId: 43337328
- userId: 123456AB-ab12-3c4d-5e67-89f1abc1defa
- orderNumber: 100028
- createDate: 2014-10-03T06:51:59.9430000
- shipDate: 2014-10-03
- shipmentCost: 1.9299999999999999
- insuranceCost: 0
- trackingNumber: 9400111899561704681196
- isReturnLabel: false
- batchNumber: 100300
- carrierCode: stamps_com
- serviceCode: usps_first_class_mail
- packageCode: package
- confirmation: delivery
- warehouseId: 14265
- voided: false
- voidDate:
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Luke Skywalker
- company: SS
- street1: 2815 EXPOSITION BLVD
- street2: ''
- street3:
- city: AUSTIN
- state: TX
- postalCode: 78703-1221
- country: US
- phone: ''
- residential:
- weight:
- value: 1
- units: ounces
- dimensions:
- insuranceOptions:
- provider:
- insureShipment: false
- insuredValue: 0
- advancedOptions:
- shipmentItems:
- - orderItemId: 55827278
- lineItemKey:
- sku: test
- name: test
- imageUrl:
- weight:
- quantity: 1
- unitPrice: 1
- warehouseLocation:
- options:
- productId: 7541107
- fulfillmentSku:
- labelData:
- formData:
- total: 2
- page: 1
- pages: 0
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /shipments?recipientName={recipientName}&recipientCountryCode={recipientCountryCode}&orderNumber={orderNumber}&orderId={orderId}&carrierCode={carrierCode}&serviceCode={serviceCode}&trackingNumber={trackingNumber}&createDateStart={createDateStart}&createDateEnd={createDateEnd}&shipDateStart={shipDateStart}&shipDateEnd={shipDateEnd}&voidDateStart={voidDateStart}&voidDateEnd={voidDateEnd}&includeShipmentItems={includeShipmentItems}&sortBy={sortBy}&sortDir={sortDir}&page={page}&pageSize={pageSize}
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: '{ "shipments": [ { "shipmentId": 33974374, "orderId": 43945660, "userId": "123456AB-ab12-3c4d-5e67-89f1abc1defa", "orderNumber": "100038-1", "createDate": "2014-10-03T06:51:33.6270000", "shipDate": "2014-10-03", "shipmentCost": 1.93, "insuranceCost": 0, "trackingNumber": "9400111899561704681189", "isReturnLabel": false, "batchNumber": "100301", "carrierCode": "stamps_com", "serviceCode": "usps_first_class_mail", "packageCode": "package", "confirmation": "delivery", "warehouseId": 16079, "voided": false, "voidDate": null, "marketplaceNotified": true, "notifyErrorMessage": null, "shipTo": { "name": "Yoda", "company": "", "street1": "12223 LOWDEN LN", "street2": "", "street3": null, "city": "MANCHACA", "state": "TX", "postalCode": "78652-3602", "country": "US", "phone": "2101235544", "residential": null }, "weight": { "value": 1, "units": "ounces" }, "dimensions": null, "insuranceOptions": { "provider": null, "insureShipment": false, "insuredValue": 0 }, "advancedOptions": null, "shipmentItems": [ { "orderItemId": 56568665, "lineItemKey": null, "sku": "SQ3785739", "name": "Potato Kitten -", "imageUrl": null, "weight": null, "quantity": 1, "unitPrice": 1, "warehouseLocation": null, "options": null, "productId": 7565777, "fulfillmentSku": null } ], "labelData": null, "formData": null }, { "shipmentId": 33974373, "orderId": 43337328, "userId": "123456AB-ab12-3c4d-5e67-89f1abc1defa", "orderNumber": "100028", "createDate": "2014-10-03T06:51:59.9430000", "shipDate": "2014-10-03", "shipmentCost": 1.93, "insuranceCost": 0, "trackingNumber": "9400111899561704681196", "isReturnLabel": false, "batchNumber": "100300", "carrierCode": "stamps_com", "serviceCode": "usps_first_class_mail", "packageCode": "package", "confirmation": "delivery", "warehouseId": 14265, "voided": false, "voidDate": null, "marketplaceNotified": true, "notifyErrorMessage": null, "shipTo": { "name": "Luke Skywalker", "company": "SS", "street1": "2815 EXPOSITION BLVD", "street2": "", "street3": null, "city": "AUSTIN", "state": "TX", "postalCode": "78703-1221", "country": "US", "phone": "", "residential": null }, "weight": { "value": 1, "units": "ounces" }, "dimensions": null, "insuranceOptions": { "provider": null, "insureShipment": false, "insuredValue": 0 }, "advancedOptions": null, "shipmentItems": [ { "orderItemId": 55827278, "lineItemKey": null, "sku": "test", "name": "test", "imageUrl": null, "weight": null, "quantity": 1, "unitPrice": 1, "warehouseLocation": null, "options": null, "productId": 7541107, "fulfillmentSku": null } ], "labelData": null, "formData": null } ], "total": 2, "page": 1, "pages": 0}'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: List Shipments with parameters1
- x-testDescription: >-
- Obtains a list of shipments that match the specified criteria. Please note the following:
- - Only valid shipments with labels generated in ShipStation will be returned in the response. Orders that have been marked as shipped either through the UI or the API will not appear as they are considered external shipments.
- - To include every shipment's associated shipmentItems in the response, be sure to set the `includeShipmentItems` parameter to `true`.
- All of the available filters are optional. They do not need to be included in the URL. If you do include them, here's what the URL may look like:
- Url format with filters:
- ```
- shipments?recipientName={recipientName}
- &recipientCountryCode={recipientCountryCode}
- &orderNumber={orderNumber}
- &orderId={orderId}
- &carrierCode={carrierCode}
- &serviceCode={serviceCode}
- &trackingNumber={trackingNumber}
- &createDateStart={createDateStart}
- &createDateEnd={createDateEnd}
- &shipDateStart={shipDateStart}
- &shipDateEnd={shipDateEnd}
- &voidDateStart={voidDateStart}
- &voidDateEnd={voidDateEnd}
- &includeShipmentItems={includeShipmentItems}
- &sortBy={sortBy}
- &sortDir={sortDir}
- &page={page}
- &pageSize={pageSize}
- ```
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /shipments/createlabel:
- post:
- description: "Creates a shipping label. The ``labelData`` field returned in the response is a base64 encoded PDF value. Simply decode and save the output as a PDF file to retrieve a printable label. The body of this request has the following attributes:\nName |Data Type |Description\n-------------------|-------------------|-------------------\n ``carrierCode`` | string, required | Identifies the carrier to be used for this label.\n ``serviceCode`` | string, required | Identifies the shipping service to be used for this label.\n ``packageCode`` | string, required | Identifies the packing type that should be used for this label.\n ``confirmation`` | string, optional | Identifies the delivery confirmation type to be used for this label.\n ``shipDate`` | string, required | The date the shipment will be shipped.\n ``weight`` | Weight, required | Shipment's weight. Use the [**Weight**](https://www.shipstation.com/developer-api/#/reference/model-weight) model.\n ``dimensions`` | Dimensions, optional | Shipment's dimensions. Use the [**Dimensions**](https://www.shipstation.com/developer-api/#/reference/model-dimensions) model.\n ``shipFrom`` | Address, required | Address indicating shipment's origin. Use the [**Address**](https://www.shipstation.com/developer-api/#/reference/model-address) model.\n ``shipTo`` | Address, required | Address indicating shipment's destination. Use the [**Address**](https://www.shipstation.com/developer-api/#/reference/model-address) model.\n ``insuranceOptions`` | InsuranceOptions, optional | The shipping insurance information associated with this order. \n ``internationalOptions`` | InternationalOptions, optional | Customs information that can be used to generate customs documents for international orders. Use the [**InternationalOptions**](https://www.shipstation.com/developer-api/#/reference/model-internationaloptions) model.\n ``advancedOptions`` | AdvancedOptions, optional | Various advanced options that may be available depending on the shipping carrier that is used to ship the order. Use the [**AdvancedOptions**](https://www.shipstation.com/developer-api/#/reference/model-advancedoptions) model. \n ``testLabel`` | boolean, optional | Specifies whether a test label should be created. Default value: false."
- summary: Create Shipment Label
- tags:
- - Shipments
- operationId: ShipmentsCreatelabelPost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/CreateShipmentLabelRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/CreateShipmentLabelResponse'
- examples:
- application/json:
- shipmentId: 123456789
- orderId:
- userId:
- customerEmail:
- orderNumber:
- createDate: 2016-04-03T12:11:36.8630000
- shipDate: 2016-04-03
- shipmentCost: 9.0600000000000005
- insuranceCost: 0
- trackingNumber: 782390443992
- isReturnLabel: false
- batchNumber:
- carrierCode: fedex
- serviceCode: fedex_ground
- packageCode: package
- confirmation: delivery
- warehouseId:
- voided: false
- voidDate:
- marketplaceNotified: false
- notifyErrorMessage:
- shipTo:
- weight:
- dimensions:
- insuranceOptions:
- advancedOptions:
- shipmentItems:
- labelData: JVBERi0xLjQKJeLjz9MKMiAwIG9iago8PC9MZW5ndGggNjIvRmlsdGVyL0ZsYXRlRGVjb2RlPj5zdHJlYW0KeJwr5HIK4TI2U...
- formData:
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /shipments/getrates:
- post:
- description: "Retrieves shipping rates for the specified shipping details. The body of this request should specify the following attributes:\nName |Data Type |Description\n-------------------|-------------------|-------------------\n ``carrierCode`` | string, required | Returns rates for the specified carrier.\n ``serviceCode`` | string, optional | Returns rates for the specified shipping service.\n ``packageCode`` | string, optional | Returns rates for the specified package type.\n ``fromPostalCode`` | string, required | Originating postal code.\n ``toState`` | string, optional | Destination State/Province. Please use two-character state/province abbreviation. Note this field is required for the following carriers: UPS\n ``toCountry`` | string, required | Destination Country. Please use the two-character ISO country code.\n ``toPostalCode`` | string, required | Destination Postal Code.\n ``toCity`` | string, optional | Destination City.\n ``weight`` | Weight, required | Shipment's weight. Use ``Weight`` object.\n ``dimensions`` | Dimensions, optional | Shipment's dimensions. Use ``Dimensions`` object. \n ``confirmation`` | string, optional | Returns rates that account for the specified delivery confirmation type.\n ``residential`` | boolean, optional | Returns rates that account for the specified delivery confirmation type. Default value: false"
- summary: Get Rates
- tags:
- - Shipments
- operationId: ShipmentsGetratesPost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/GetRatesRequest'
- responses:
- 200:
- description: ''
- schema:
- type: array
- items:
- $ref: '#/definitions/GetRatesResponse'
- examples:
- application/json:
- - serviceName: FedEx First Overnight®
- serviceCode: fedex_first_overnight
- shipmentCost: 87.799999999999997
- otherCost: 2.6299999999999999
- - serviceName: FedEx Priority Overnight®
- serviceCode: fedex_priority_overnight
- shipmentCost: 50.229999999999997
- otherCost: 1.51
- - serviceName: FedEx Standard Overnight®
- serviceCode: fedex_standard_overnight
- shipmentCost: 46.960000000000001
- otherCost: 1.4099999999999999
- - serviceName: FedEx 2Day® A.M.
- serviceCode: fedex_2day_am
- shipmentCost: 23.039999999999999
- otherCost: 0.68999999999999995
- - serviceName: FedEx 2Day®
- serviceCode: fedex_2day
- shipmentCost: 20.030000000000001
- otherCost: 0.59999999999999998
- - serviceName: FedEx Express Saver®
- serviceCode: fedex_express_saver
- shipmentCost: 14.279999999999999
- otherCost: 0.42999999999999999
- - serviceName: FedEx Ground®
- serviceCode: fedex_ground
- shipmentCost: 8.25
- otherCost: 0.33000000000000002
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /shipments/voidlabel:
- post:
- description: >-
- Voids the specified label by shipmentId. The body of this request should specify the following attributes:
- Name |Data Type |Description
- -------------------|-------------------|-------------------
- ``shipmentId`` | number, required | ID of the shipment to void.
- summary: Void Label
- tags:
- - Shipments
- operationId: ShipmentsVoidlabelPost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/VoidLabelRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/VoidLabelResponse'
- examples:
- application/json:
- approved: true
- message: Label voided successfully
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /stores/{storeId}:
- get:
- description: ''
- summary: Get Store
- tags:
- - Stores
- operationId: StoresByStoreIdGet
- produces:
- - application/json
- parameters:
- - name: storeId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: A unique ID generated by ShipStation and assigned to each store.
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/GetStoreResponse'
- examples:
- application/json:
- storeId: 12345
- storeName: WooCommerce Store
- marketplaceId: 36
- marketplaceName: WooCommerce
- accountName:
- email:
- integrationUrl: http://shipstation-test.wpengine.com
- active: true
- companyName: ''
- phone: ''
- publicEmail: ''
- website: ''
- refreshDate: 2014-12-16T17:47:05.4570000
- lastRefreshAttempt: 2014-12-16T09:47:05.4570000
- createDate: 2014-11-06T15:21:13.2230000
- modifyDate: 2014-11-10T08:02:19.1170000
- autoRefresh: true
- statusMappings:
- - orderStatus: awaiting_payment
- statusKey: Pending
- - orderStatus: awaiting_shipment
- statusKey: Processing
- - orderStatus: shipped
- statusKey: Completed
- - orderStatus: cancelled
- statusKey: Cancelled
- - orderStatus: on_hold
- statusKey: On-hold
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /stores/12345
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- Authorization: < Enter your Basic Authorization string here >
- body: '{ "storeId": 12345, "storeName": "WooCommerce Store", "marketplaceId": 36, "marketplaceName": "WooCommerce", "accountName": null, "email": null, "integrationUrl": "http://shipstation-test.wpengine.com", "active": true, "companyName": "", "phone": "", "publicEmail": "", "website": "", "refreshDate": "2014-12-16T17:47:05.457", "lastRefreshAttempt": "2014-12-16T09:47:05.457", "createDate": "2014-11-06T15:21:13.223", "modifyDate": "2014-11-10T08:02:19.117", "autoRefresh": true, "statusMappings": [ { "orderStatus": "awaiting_payment", "statusKey": "Pending" }, { "orderStatus": "awaiting_shipment", "statusKey": "Processing" }, { "orderStatus": "shipped", "statusKey": "Completed" }, { "orderStatus": "cancelled", "statusKey": "Cancelled" }, { "orderStatus": "on_hold", "statusKey": "On-hold" } ]}'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: Get Store1
- x-testDescription: Testcase for testing endpoint Get Store
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- put:
- description: Updates an existing store. This call does not currently support partial updates. The entire resource must be provided in the body of the request.
- summary: Update Store
- tags:
- - Stores
- operationId: StoresByStoreIdPut
- produces:
- - application/json
- parameters:
- - name: storeId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: A unique ID generated by ShipStation and assigned to each store.
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/UpdateStoreRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/UpdateStoreResponse'
- examples:
- application/json:
- storeId: 12345
- storeName: WooCommerce Store
- marketplaceId: 36
- marketplaceName: WooCommerce
- accountName:
- email:
- integrationUrl: http://shipstation-test.wpengine.com
- active: true
- companyName: ''
- phone: ''
- publicEmail: ''
- website: ''
- refreshDate: 2014-12-16T17:47:05.4570000
- lastRefreshAttempt: 2014-12-16T09:47:05.4570000
- createDate: 2014-11-06T15:21:13.2230000
- modifyDate: 2014-11-10T08:02:19.1170000
- autoRefresh: true
- statusMappings:
- - orderStatus: awaiting_payment
- statusKey: Pending
- - orderStatus: awaiting_shipment
- statusKey: Processing
- - orderStatus: shipped
- statusKey: Completed
- - orderStatus: cancelled
- statusKey: Cancelled
- - orderStatus: on_hold
- statusKey: On-hold
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /stores/getrefreshstatus?storeId={storeId}:
- get:
- description: Retrieves the refresh status of a given store.
- summary: Get Store Refresh Status
- tags:
- - Stores
- operationId: StoresGetrefreshstatusByStoreIdGet
- produces:
- - application/json
- parameters:
- - name: storeId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: Specifies the store whose status will be retrieved.
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/GetStoreRefreshStatusResponse'
- examples:
- application/json:
- storeId: 12345
- refreshStatusId: 2
- refreshStatus: Updating orders
- lastRefreshAttempt: 8-13-2014
- refreshDate: 8-13-2014
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /stores/getrefreshstatus?storeId=12345
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: '{ "storeId": 12345, "refreshStatusId": 2, "refreshStatus": "Updating orders", "lastRefreshAttempt": "8-13-2014", "refreshDate": "8-13-2014"}'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: Get Store Refresh Status1
- x-testDescription: Retrieves the refresh status of a given store.
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /stores/refreshstore?storeId={storeId}&refreshDate={refreshDate}:
- post:
- description: Initiates a store refresh.
- summary: Refresh Store
- tags:
- - Stores
- operationId: StoresRefreshstoreByStoreIdAndRefreshDatePost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/RefreshStoreRequest'
- - name: storeId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: Specifies the store which will get refreshed. If the storeId is not specified, a store refresh will be initiated for all refreshable stores on that account.
- - name: refreshDate
- in: path
- required: true
- type: string
- description: Specifies the starting date for new order imports. If the refreshDate is not specified, ShipStation will use the last recorded refreshDate for that store.
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/RefreshStoreResponse'
- examples:
- application/json:
- success: true
- message: A store refresh has been initiated for Store ID 12345
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /stores?showInactive={showInactive}&marketplaceId={marketplaceId}:
- get:
- description: Retrieve the list of installed stores on the account.
- summary: List Stores
- tags:
- - Stores
- operationId: StoresByShowInactiveAndMarketplaceIdGet
- produces:
- - application/json
- parameters:
- - name: showInactive
- in: path
- required: true
- type: boolean
- description: Determines whether inactive stores will be returned in the list of stores.
- - name: marketplaceId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: Returns stores of this marketplace type.
- responses:
- 200:
- description: ''
- schema:
- type: array
- items:
- $ref: '#/definitions/ListStoresResponse'
- examples:
- application/json:
- - storeId: 22766
- storeName: ShipStation Manual Store
- marketplaceId: 0
- marketplaceName: ShipStation
- accountName:
- email:
- integrationUrl:
- active: true
- companyName: ''
- phone: ''
- publicEmail: testemail@email.com
- website: ''
- refreshDate: 2014-12-03T11:46:11.2830000
- lastRefreshAttempt: 2014-12-03T11:46:53.4330000
- createDate: 2014-07-25T11:05:55.3070000
- modifyDate: 2014-11-12T08:45:20.5500000
- autoRefresh: false
- - storeId: 25748
- storeName: Ashley's Test WooCommerce
- marketplaceId: 36
- marketplaceName: WooCommerce
- accountName:
- email:
- integrationUrl: http://shipstation.wpengine.com/
- active: true
- companyName: ''
- phone: ''
- publicEmail: ''
- website: ''
- refreshDate: 2014-11-26T22:28:14.0700000
- lastRefreshAttempt: 2014-11-26T14:28:14.0700000
- createDate: 2014-11-10T08:53:48.0770000
- modifyDate: 2014-12-03T14:53:50.5570000
- autoRefresh: true
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /stores?showInactive={showInactive}&marketplaceId={marketplaceId}
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: "[ { \"storeId\": 22766, \"storeName\": \"ShipStation Manual Store\", \"marketplaceId\": 0, \"marketplaceName\": \"ShipStation\", \"accountName\": null, \"email\": null, \"integrationUrl\": null, \"active\": true, \"companyName\": \"\", \"phone\": \"\", \"publicEmail\": \"testemail@email.com\", \"website\": \"\", \"refreshDate\": \"2014-12-03T11:46:11.283\", \"lastRefreshAttempt\": \"2014-12-03T11:46:53.433\", \"createDate\": \"2014-07-25T11:05:55.307\", \"modifyDate\": \"2014-11-12T08:45:20.55\", \"autoRefresh\": false }, { \"storeId\": 25748, \"storeName\": \"Ashley's Test WooCommerce\", \"marketplaceId\": 36, \"marketplaceName\": \"WooCommerce\", \"accountName\": null, \"email\": null, \"integrationUrl\": \"http://shipstation.wpengine.com/\", \"active\": true, \"companyName\": \"\", \"phone\": \"\", \"publicEmail\": \"\", \"website\": \"\", \"refreshDate\": \"2014-11-26T22:28:14.07\", \"lastRefreshAttempt\": \"2014-11-26T14:28:14.07\", \"createDate\": \"2014-11-10T08:53:48.077\", \"modifyDate\": \"2014-12-03T14:53:50.557\", \"autoRefresh\": true }]"
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: List Stores1
- x-testDescription: Retrieve the list of installed stores on the account.
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /stores/marketplaces:
- get:
- description: Lists the marketplaces that can be integrated with ShipStation.
- summary: List Marketplaces
- tags:
- - Stores
- operationId: StoresMarketplacesGet
- produces:
- - application/json
- parameters: []
- responses:
- 200:
- description: ''
- schema:
- type: array
- items:
- $ref: '#/definitions/ListMarketplacesResponse'
- examples:
- application/json:
- - name: 3DCart
- marketplaceId: 23
- canRefresh: true
- supportsCustomMappings: true
- supportsCustomStatuses: false
- canConfirmShipments: true
- - name: Amazon
- marketplaceId: 2
- canRefresh: true
- supportsCustomMappings: true
- supportsCustomStatuses: false
- canConfirmShipments: true
- - name: Amazon CA
- marketplaceId: 32
- canRefresh: true
- supportsCustomMappings: true
- supportsCustomStatuses: false
- canConfirmShipments: true
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /stores/marketplaces
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: '[ { "name": "3DCart", "marketplaceId": 23, "canRefresh": true, "supportsCustomMappings": true, "supportsCustomStatuses": false, "canConfirmShipments": true }, { "name": "Amazon", "marketplaceId": 2, "canRefresh": true, "supportsCustomMappings": true, "supportsCustomStatuses": false, "canConfirmShipments": true }, { "name": "Amazon CA", "marketplaceId": 32, "canRefresh": true, "supportsCustomMappings": true, "supportsCustomStatuses": false, "canConfirmShipments": true }]'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: List Marketplaces1
- x-testDescription: Lists the marketplaces that can be integrated with ShipStation.
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /stores/deactivate:
- post:
- description: >-
- Deactivates the specified store.
- The body of this request has the following attributes:
- Name |Data Type |Description
- -------------------|-------------------|-------------------
- ``storeId`` | number, required | ID of the store to deactivate.
- summary: Deactivate Store
- tags:
- - Stores
- operationId: StoresDeactivatePost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/DeactivateStoreRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/DeactivateStoreResponse'
- examples:
- application/json:
- success: true
- message: The requested store has been reactivated.
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /stores/reactivate:
- post:
- description: >-
- Reactivates the specified store. Note: stores are active by default
- The body of this request has the following attributes:
- Name |Data Type |Description
- -------------------|-------------------|-------------------
- ``storeId`` | number, required | ID of the store to reactivate.
- summary: Reactivate Store
- tags:
- - Stores
- operationId: StoresReactivatePost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/ReactivateStoreRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/ReactivateStoreResponse'
- examples:
- application/json:
- success: true
- message: The requested store has been reactivated.
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /users?showInactive={showInactive}:
- get:
- description: ''
- summary: List Users
- tags:
- - Users
- operationId: UsersByShowInactiveGet
- produces:
- - application/json
- parameters:
- - name: showInactive
- in: path
- required: true
- type: boolean
- description: Determines whether inactive users will be returned in the response.
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/ListUsersResponse'
- examples:
- application/json:
- userId: 123456AB-ab12-3c4d-5e67-89f1abc1defa
- userName: SS-user1
- name: Shipping Employee 1
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /users?showInactive=false
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- Authorization: < Enter your Basic Authorization string here >
- body: '{ "userId": "123456AB-ab12-3c4d-5e67-89f1abc1defa", "userName": "SS-user1", "name": "Shipping Employee 1"}'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: List Users1
- x-testDescription: Testcase for testing endpoint List Users
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /warehouses/{warehouseId}:
- get:
- description: Returns a list of active Ship From Locations (formerly known as warehouses) on the ShipStation account. Warehouses are now called "Ship From Locations" in the UI.
- summary: Get Warehouse
- tags:
- - Warehouses
- operationId: WarehousesByWarehouseIdGet
- produces:
- - application/json
- parameters:
- - name: warehouseId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: A unique ID generated by ShipStation and assigned to each Ship From Location (formerly known as warehouse).
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/GetWarehouseResponse'
- examples:
- application/json:
- warehouseId: 12345
- warehouseName: API Ship From Location
- originAddress:
- name: API Warehouse
- company: ShipStation
- street1: 2815 Exposition Blvd
- street2:
- street3:
- city: Austin
- state: TX
- postalCode: 78703
- country: US
- phone: 512-555-5555
- residential: true
- addressVerified:
- returnAddress:
- name: API Ship From Location
- company: ShipStation
- street1: 2815 Exposition Blvd
- street2:
- street3:
- city: Austin
- state: TX
- postalCode: 78703
- country: US
- phone: 512-555-5555
- residential:
- addressVerified:
- createDate: 2015-07-02T08:38:31.4870000
- isDefault: true
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /warehouses/12345678
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- Authorization: < Enter your Basic Authorization string here >
- body: '{ "warehouseId": 12345, "warehouseName": "API Ship From Location", "originAddress": { "name": "API Warehouse", "company": "ShipStation", "street1": "2815 Exposition Blvd", "street2": null, "street3": null, "city": "Austin", "state": "TX", "postalCode": "78703", "country": "US", "phone": "512-555-5555", "residential": true, "addressVerified": null }, "returnAddress": { "name": "API Ship From Location", "company": "ShipStation", "street1": "2815 Exposition Blvd", "street2": null, "street3": null, "city": "Austin", "state": "TX", "postalCode": "78703", "country": "US", "phone": "512-555-5555", "residential": null, "addressVerified": null }, "createDate": "2015-07-02T08:38:31.4870000", "isDefault": true }'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: Get Warehouse1
- x-testDescription: Returns a list of active Ship From Locations (formerly known as warehouses) on the ShipStation account. Warehouses are now called "Ship From Locations" in the UI.
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- put:
- description: Updates an existing Ship From Location (formerly known as warehouse). This call does not currently support partial updates. The entire resource must be provided in the body of the request. If a "returnAddress" object is not specified, your "originAddress" will be used as your "returnAddress".
- summary: Update Warehouse
- tags:
- - Warehouses
- operationId: WarehousesByWarehouseIdPut
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/UpdateWarehouseRequest'
- - name: warehouseId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: A unique ID generated by ShipStation and assigned to each Ship From Location (formerly known as warehouse).
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/UpdateWarehouseResponse'
- examples:
- application/json:
- warehouseId: 12345
- warehouseName: API Ship From Location
- originAddress:
- name: API Warehouse
- company: ShipStation
- street1: 2815 Exposition Blvd
- street2:
- street3:
- city: Austin
- state: TX
- postalCode: 78703
- country: US
- phone: 512-555-5555
- residential: true
- addressVerified:
- returnAddress:
- name: API Ship From Location
- company: ShipStation
- street1: 2815 Exposition Blvd
- street2:
- street3:
- city: Austin
- state: TX
- postalCode: 78703
- country: US
- phone: 512-555-5555
- residential:
- addressVerified:
- createDate: 2015-07-02T08:38:31.4870000
- isDefault: true
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /warehouses/createwarehouse:
- post:
- description: >-
- Adds a Ship From Location (formerly known as warehouse) to your account. The body of this request should specify the following attributes:
- Name |Data Type |Description
- -------------------|-------------------|-------------------
- ``warehouseName`` | string, optional | Name of Ship From Location.
- ``originAddress`` | Address, required | The origin address. Shipping rates will be calculated from this address. Use the [**Address**](https://www.shipstation.com/developer-api/#/reference/model-address) model.
- ``returnAddress`` | Address, optional | The return address. If a "returnAddress" is not specified, your "originAddress" will be used as your "returnAddress". Use the [**Address**](https://www.shipstation.com/developer-api/#/reference/model-address) model.
- ``isDefault`` | boolean, optional | Specifies whether or not this will be your default Ship From Location.
- summary: Create Warehouse
- tags:
- - Warehouses
- operationId: WarehousesCreatewarehousePost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/CreateWarehouseRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/CreateWarehouseResponse'
- examples:
- application/json:
- warehouseId: 17977
- warehouseName: New Ship From Location
- originAddress:
- name: NM Warehouse
- company: White Sands Co
- street1: 4704 Arabela Dr.
- street2: ''
- street3: ''
- city: Las Cruces
- state: NM
- postalCode: 88012
- country: US
- phone: 512-111-2222
- residential: true
- returnAddress:
- name: NM Warehouse
- company: White Sands Co
- street1: 4704 Arabela Dr.
- street2: ''
- street3: ''
- city: Las Cruces
- state: NM
- postalCode: 88012
- country: US
- phone: 512-111-2222
- residential:
- createDate: 2014-10-21T08:11:43.8800000
- isDefault: false
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /warehouses:
- get:
- description: Retrieves a list of your Ship From Locations (formerly known as warehouses).
- summary: List Warehouses
- tags:
- - Warehouses
- operationId: WarehousesGet
- produces:
- - application/json
- parameters: []
- responses:
- 200:
- description: ''
- schema:
- type: array
- items:
- $ref: '#/definitions/ListWarehousesResponse'
- examples:
- application/json:
- - warehouseId: 17977
- warehouseName: Main warehouse
- originAddress:
- name: Spring warehouse
- company: ''
- street1: '123 S SPRING RD '
- street2: ''
- street3: ''
- city: Elmurst
- state: IL
- postalCode: 60126
- country: US
- phone: 5121112222
- residential: false
- returnAddress:
- name: Chicago House
- company: ''
- street1: '123 S SPRING RD '
- street2: ''
- street3: ''
- city: Elmurst
- state: IL
- postalCode: 60126
- country: US
- phone: 5121112222
- residential:
- createDate: 2014-10-21T08:11:43.8800000
- isDefault: true
- - warehouseId: 14265
- warehouseName: Austin
- originAddress:
- name: Austin
- company: ShipStation
- street1: 2815 Exposition Blvd
- street2: ''
- street3: ''
- city: Austin
- state: TX
- postalCode: 78703
- country: US
- phone: 5124445555
- residential: false
- returnAddress:
- name: ShipStation
- company: ShipStation
- street1: 2815 Exposition Blvd
- street2: ''
- street3: ''
- city: Austin
- state: TX
- postalCode: 78703
- country: US
- phone: 5124445555
- residential:
- createDate: 2014-05-27T09:54:29.9600000
- isDefault: false
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /warehouses
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: '[ { "warehouseId": 17977, "warehouseName": "Main warehouse", "originAddress": { "name": "Spring warehouse", "company": "", "street1": "123 S SPRING RD ", "street2": "", "street3": "", "city": "Elmurst", "state": "IL", "postalCode": "60126", "country": "US", "phone": "5121112222", "residential": false }, "returnAddress": { "name": "Chicago House", "company": "", "street1": "123 S SPRING RD ", "street2": "", "street3": "", "city": "Elmurst", "state": "IL", "postalCode": "60126", "country": "US", "phone": "5121112222", "residential": null }, "createDate": "2014-10-21T08:11:43.8800000", "isDefault": true }, { "warehouseId": 14265, "warehouseName": "Austin", "originAddress": { "name": "Austin", "company": "ShipStation", "street1": "2815 Exposition Blvd", "street2": "", "street3": "", "city": "Austin", "state": "TX", "postalCode": "78703", "country": "US", "phone": "5124445555", "residential": false }, "returnAddress": { "name": "ShipStation", "company": "ShipStation", "street1": "2815 Exposition Blvd", "street2": "", "street3": "", "city": "Austin", "state": "TX", "postalCode": "78703", "country": "US", "phone": "5124445555", "residential": null }, "createDate": "2014-05-27T09:54:29.9600000", "isDefault": false }]'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: List Warehouses1
- x-testDescription: Retrieves a list of your Ship From Locations (formerly known as warehouses).
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /webhooks:
- get:
- description: Retrieves a list of registered webhooks for the account
- summary: List Webhooks
- tags:
- - Webhooks
- operationId: WebhooksGet
- produces:
- - application/json
- parameters: []
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/ListWebhooksResponse'
- examples:
- application/json:
- webhooks:
- - IsLabelAPIHook: false
- WebHookID: 123
- SellerID: 100000
- StoreID: 12345
- HookType: ITEM_ORDER_NOTIFY
- MessageFormat: Json
- Url: http://example.endpoint/orders
- Name: My Order Webhook
- BulkCopyBatchID:
- BulkCopyRecordID:
- Active: true
- WebhookLogs: []
- Seller:
- Store:
- - IsLabelAPIHook: false
- WebHookID: 456
- SellerID: 100000
- StoreID: 98765
- HookType: SHIP_NOTIFY
- MessageFormat: Json
- Url: https://example.endpoint/shipment
- Name: My Shipment Webhook
- BulkCopyBatchID:
- BulkCopyRecordID:
- Active: true
- WebhookLogs: []
- Seller:
- Store:
- security:
- - auth: []
- x-unitTests:
- - request:
- method: GET
- uri: /webhooks
- expectedResponse:
- x-allowExtraHeaders: true
- x-bodyMatchMode: RAW
- x-arrayOrderedMatching: false
- x-arrayCheckCount: false
- x-matchResponseSchema: true
- headers:
- Content-Type: application/json
- body: '{ "webhooks": [ { "IsLabelAPIHook": false, "WebHookID": 123, "SellerID": 100000, "StoreID": 12345, "HookType": "ITEM_ORDER_NOTIFY", "MessageFormat": "Json", "Url": "http://example.endpoint/orders", "Name": "My Order Webhook", "BulkCopyBatchID": null, "BulkCopyRecordID": null, "Active": true, "WebhookLogs": [], "Seller": null, "Store": null }, { "IsLabelAPIHook": false, "WebHookID": 456, "SellerID": 100000, "StoreID": 98765, "HookType": "SHIP_NOTIFY", "MessageFormat": "Json", "Url": "https://example.endpoint/shipment", "Name": "My Shipment Webhook", "BulkCopyBatchID": null, "BulkCopyRecordID": null, "Active": true, "WebhookLogs": [], "Seller": null, "Store": null } ]}'
- x-testShouldPass: true
- x-testEnabled: true
- x-testName: List Webhooks1
- x-testDescription: Retrieves a list of registered webhooks for the account
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /webhooks/subscribe:
- post:
- description: >-
- Subscribes to a specific type of webhook. If a ``store_id`` is passed in, the webhooks will only be triggered for that specific ``store_id``.
- The ``event`` type that is passed in will determine what type of webhooks will be sent.
- Webhooks can be viewed & edited via the ShipStation Application under Integrations in the [**Account Settings**](https://ss.shipstation.com/#/settings/integrations).
- NOTE: Webhooks will be sent to the URL specified in the ``target_url``. The HTTP request will be sent via POST and will contain a [**webhook JSON object**](https://www.shipstation.com/developer-api/#/reference/model-webhook) in the body.
- The body of this request to subscribe has the following attributes:
- Name |Data Type |Description
- -------------------|-------------------|-------------------
- ``target_url`` | string, required | The URL to send the webhooks to
- ``event`` | string, required | The type of webhook to subscribe to. Must contain one of the following values: ORDER_NOTIFY, ITEM_ORDER_NOTIFY, SHIP_NOTIFY, ITEM_SHIP_NOTIFY
- ``store_id`` | int, optional | If passed in, the webhooks will only be triggered for this ``store_id``
- ``friendly_name`` | string, optional | Display name for the webhook
- summary: Subscribe to Webhook
- tags:
- - Webhooks
- operationId: WebhooksSubscribePost
- produces:
- - application/json
- parameters:
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- - name: body
- in: body
- required: true
- description: ''
- schema:
- $ref: '#/definitions/SubscribeToWebhookRequest'
- responses:
- 200:
- description: ''
- schema:
- $ref: '#/definitions/SubscribeToWebhookResponse'
- examples:
- application/json:
- id: 123456
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- /webhooks/{webhookId}:
- delete:
- description: Unsubscribes from a certain webhook.
- summary: Unsubscribe to Webhook
- tags:
- - Webhooks
- operationId: WebhooksByWebhookIdDelete
- produces:
- - application/json
- parameters:
- - name: webhookId
- in: path
- required: true
- type: number
- format: double
- exclusiveMaximum: false
- exclusiveMinimum: false
- description: A unique ID generated by ShipStation and assigned to each webhook.
- - name: Content-Type
- in: header
- required: true
- type: string
- description: ''
- responses:
- 200:
- description: ''
- security:
- - auth: []
- x-unitTests: []
- x-operation-settings:
- CollectParameters: false
- AllowDynamicQueryParameters: false
- AllowDynamicFormParameters: false
- IsMultiContentStreaming: false
- definitions:
- RegisterAccountRequest:
- title: Register Account request
- type: object
- properties:
- firstName:
- description: ''
- example: John
- type: string
- lastName:
- description: ''
- example: Smith
- type: string
- email:
- description: ''
- example: jsmithtest@gmail.com
- type: string
- password:
- description: ''
- example: testpw1234
- type: string
- shippingOriginCountryCode:
- description: ''
- example: US
- type: string
- companyName:
- description: ''
- example: Droid Repair LLC
- type: string
- addr1:
- description: ''
- example: 542 Midichlorian Rd.
- type: string
- addr2:
- description: ''
- type: string
- city:
- description: ''
- example: Austin
- type: string
- state:
- description: ''
- example: TX
- type: string
- zip:
- description: ''
- example: 78703
- type: string
- countryCode:
- description: ''
- example: US
- type: string
- phone:
- description: ''
- example: 5124111234
- type: string
- required:
- - firstName
- - lastName
- - email
- - password
- - shippingOriginCountryCode
- - companyName
- - addr1
- - addr2
- - city
- - state
- - zip
- - countryCode
- - phone
- RegisterAccountResponse:
- title: Register Account response
- example:
- message: ShipStation account created.
- sellerId: 123456
- success: true
- apiKey: abcdt9845hjmgfklj3498gkljdkuyekl
- apiSecret: 1234iou983lkj8mnxgfwu509hkhdy7u3
- type: object
- properties:
- message:
- description: ''
- example: ShipStation account created.
- type: string
- sellerId:
- description: ''
- example: 123456
- type: integer
- format: int32
- success:
- description: ''
- example: true
- type: boolean
- apiKey:
- description: ''
- example: abcdt9845hjmgfklj3498gkljdkuyekl
- type: string
- apiSecret:
- description: ''
- example: 1234iou983lkj8mnxgfwu509hkhdy7u3
- type: string
- required:
- - message
- - sellerId
- - success
- - apiKey
- - apiSecret
- ListTagsResponse:
- title: List Tags response
- example:
- tagId: 8362
- name: Backorder
- color: '#800080'
- type: object
- properties:
- tagId:
- description: ''
- example: 8362
- type: integer
- format: int32
- name:
- description: ''
- example: Backorder
- type: string
- color:
- description: ''
- example: '#800080'
- type: string
- required:
- - tagId
- - name
- - color
- ListCarriersResponse:
- title: List Carriers response
- example:
- name: Express 1
- code: express_1
- accountNumber: fe71c33f
- requiresFundedAccount: true
- balance: 0.27000000000000002
- type: object
- properties:
- name:
- description: ''
- example: Express 1
- type: string
- code:
- description: ''
- example: express_1
- type: string
- accountNumber:
- description: ''
- example: fe71c33f
- type: string
- requiresFundedAccount:
- description: ''
- example: true
- type: boolean
- balance:
- description: ''
- example: 0.27000000000000002
- type: number
- format: double
- required:
- - name
- - code
- - accountNumber
- - requiresFundedAccount
- - balance
- GetCarrierResponse:
- title: Get Carrier response
- example:
- name: Stamps.com
- code: stamps_com
- accountNumber: SS123
- requiresFundedAccount: true
- balance: 24.140000000000001
- type: object
- properties:
- name:
- description: ''
- example: Stamps.com
- type: string
- code:
- description: ''
- example: stamps_com
- type: string
- accountNumber:
- description: ''
- example: SS123
- type: string
- requiresFundedAccount:
- description: ''
- example: true
- type: boolean
- balance:
- description: ''
- example: 24.140000000000001
- type: number
- format: double
- required:
- - name
- - code
- - accountNumber
- - requiresFundedAccount
- - balance
- AddFundsRequest:
- title: Add Funds request
- example:
- carrierCode: fedex
- amount: 20
- type: object
- properties:
- carrierCode:
- description: ''
- example: fedex
- type: string
- amount:
- description: ''
- example: 20
- type: number
- format: double
- required:
- - carrierCode
- - amount
- AddFundsResponse:
- title: Add Funds response
- example:
- name: Stamps.com
- code: stamps_com
- accountNumber: SS123
- requiresFundedAccount: true
- balance: 24.140000000000001
- type: object
- properties:
- name:
- description: ''
- example: Stamps.com
- type: string
- code:
- description: ''
- example: stamps_com
- type: string
- accountNumber:
- description: ''
- example: SS123
- type: string
- requiresFundedAccount:
- description: ''
- example: true
- type: boolean
- balance:
- description: ''
- example: 24.140000000000001
- type: number
- format: double
- required:
- - name
- - code
- - accountNumber
- - requiresFundedAccount
- - balance
- ListPackagesResponse:
- title: List Packages response
- example:
- carrierCode: express_1
- code: cubic
- name: Cubic
- domestic: true
- international: false
- type: object
- properties:
- carrierCode:
- description: ''
- example: express_1
- type: string
- code:
- description: ''
- example: cubic
- type: string
- name:
- description: ''
- example: Cubic
- type: string
- domestic:
- description: ''
- example: true
- type: boolean
- international:
- description: ''
- example: false
- type: boolean
- required:
- - carrierCode
- - code
- - name
- - domestic
- - international
- ListServicesResponse:
- title: List Services response
- example:
- carrierCode: fedex
- code: fedex_ground
- name: FedEx Ground®
- domestic: true
- international: false
- type: object
- properties:
- carrierCode:
- description: ''
- example: fedex
- type: string
- code:
- description: ''
- example: fedex_ground
- type: string
- name:
- description: ''
- example: FedEx Ground®
- type: string
- domestic:
- description: ''
- example: true
- type: boolean
- international:
- description: ''
- example: false
- type: boolean
- required:
- - carrierCode
- - code
- - name
- - domestic
- - international
- GetCustomerResponse:
- title: Get Customer response
- example:
- customerId: 12345678
- createDate: 2014-11-18T10:33:01.1900000
- modifyDate: 2014-11-18T10:33:01.1900000
- name: Cam Newton
- company: Test Company
- street1: 123 War Eagle Lane
- street2: ''
- city: Auburn
- state: AL
- postalCode: 36830
- countryCode: US
- phone: 555-555-5555
- email: supermancam@example.com
- addressVerified: Verified
- marketplaceUsernames:
- - customerUserId: 67195020
- customerId: 12345678
- createDate: 2015-04-27T12:35:03.8300000
- modifyDate: 2015-05-14T08:16:15.2700000
- marketplaceId: 0
- marketplace: ShipStation
- username: camtheman@gmail.com
- - customerUserId: 37568588
- customerId: 12345678
- createDate: 2014-11-18T10:33:01.1970000
- modifyDate: 2014-11-18T10:33:01.1970000
- marketplaceId: 36
- marketplace: WooCommerce
- username: supercam@example.com
- - customerUserId: 46038940
- customerId: 12345678
- createDate:
- modifyDate:
- marketplaceId: 67
- marketplace: TradeGecko
- username: camtheman@gmail.com
- tags:
- - tagId: 1234
- name: Expedited
- - tagId: 9725
- name: 00 BULK ORDERED
- type: object
- properties:
- customerId:
- description: ''
- example: 12345678
- type: integer
- format: int32
- createDate:
- description: ''
- example: 11/18/2014 10:33:01 AM
- type: string
- modifyDate:
- description: ''
- example: 11/18/2014 10:33:01 AM
- type: string
- name:
- description: ''
- example: Cam Newton
- type: string
- company:
- description: ''
- example: Test Company
- type: string
- street1:
- description: ''
- example: 123 War Eagle Lane
- type: string
- street2:
- description: ''
- type: string
- city:
- description: ''
- example: Auburn
- type: string
- state:
- description: ''
- example: AL
- type: string
- postalCode:
- description: ''
- example: 36830
- type: string
- countryCode:
- description: ''
- example: US
- type: string
- phone:
- description: ''
- example: 555-555-5555
- type: string
- email:
- description: ''
- example: supermancam@example.com
- type: string
- addressVerified:
- description: ''
- example: Verified
- type: string
- marketplaceUsernames:
- description: ''
- example:
- - customerUserId: 67195020
- customerId: 12345678
- createDate: 2015-04-27T12:35:03.8300000
- modifyDate: 2015-05-14T08:16:15.2700000
- marketplaceId: 0
- marketplace: ShipStation
- username: camtheman@gmail.com
- - customerUserId: 37568588
- customerId: 12345678
- createDate: 2014-11-18T10:33:01.1970000
- modifyDate: 2014-11-18T10:33:01.1970000
- marketplaceId: 36
- marketplace: WooCommerce
- username: supercam@example.com
- - customerUserId: 46038940
- customerId: 12345678
- createDate:
- modifyDate:
- marketplaceId: 67
- marketplace: TradeGecko
- username: camtheman@gmail.com
- type: array
- items:
- type: object
- tags:
- description: ''
- example:
- - tagId: 1234
- name: Expedited
- - tagId: 9725
- name: 00 BULK ORDERED
- type: array
- items:
- type: object
- required:
- - customerId
- - createDate
- - modifyDate
- - name
- - company
- - street1
- - street2
- - city
- - state
- - postalCode
- - countryCode
- - phone
- - email
- - addressVerified
- - marketplaceUsernames
- - tags
- SortBy:
- title: sortBy
- example: Name
- x-enum-elements:
- - name: Name
- description: ''
- - name: ModifyDate
- description: ''
- - name: CreateDate
- description: ''
- type: string
- enum:
- - Name
- - ModifyDate
- - CreateDate
- SortDir:
- title: sortDir
- example: ASC
- x-enum-elements:
- - name: ASC
- description: ''
- - name: DESC
- description: ''
- type: string
- enum:
- - ASC
- - DESC
- ListCustomersResponse:
- title: List Customers response
- example:
- customers:
- - customerId: 12345678
- createDate: 2014-11-18T10:33:01.1900000
- modifyDate: 2014-11-18T10:33:01.1900000
- name: Cam Newton
- company: Test Company
- street1: 123 War Eagle Lane
- street2: ''
- city: Auburn
- state: AL
- postalCode: 36830
- countryCode: US
- phone: 555-555-5555
- email: supermancam@example.com
- addressVerified: Verified
- marketplaceUsernames:
- - customerUserId: 67195020
- customerId: 12345678
- createDate: 2015-04-27T12:35:03.8300000
- modifyDate: 2015-05-14T08:16:15.2700000
- marketplaceId: 0
- marketplace: ShipStation
- username: camtheman@gmail.com
- - customerUserId: 37568588
- customerId: 12345678
- createDate: 2014-11-18T10:33:01.1970000
- modifyDate: 2014-11-18T10:33:01.1970000
- marketplaceId: 36
- marketplace: WooCommerce
- username: supercam@example.com
- - customerUserId: 46038940
- customerId: 12345678
- createDate:
- modifyDate:
- marketplaceId: 67
- marketplace: TradeGecko
- username: camtheman@gmail.com
- tags:
- - tagId: 1234
- name: Expedited
- - tagId: 9725
- name: 00 BULK ORDERED
- - customerId: 87654321
- createDate: 2015-06-21T12:48:07.5400000
- name: Bo Jackson
- company: Test Company
- street1: 456 Heisman Ave
- street2: ''
- city: Auburn
- state: AL
- postalCode: 36830
- countryCode: US
- phone: 555-555-5555
- email: boknows@example.com
- addressVerified: Verified
- marketplaceUsernames:
- - customerUserId: 77215410
- customerId: 87654321
- createDate: 2015-08-27T14:36:05.7500000
- modifyDate: 2015-09-01T09:18:25.3100000
- marketplaceId: 0
- marketplace: ShipStation
- username: boknows@gmail.com
- - customerUserId: 43759100
- customerId: 87654321
- createDate: 2015-07-05T11:38:01.1970000
- modifyDate: 2015-07-05T11:38:01.1970000
- marketplaceId: 36
- marketplace: WooCommerce
- username: boknows@example.com
- - customerUserId: 81565241
- customerId: 87654321
- createDate:
- modifyDate:
- marketplaceId: 67
- marketplace: TradeGecko
- username: bo@gmail.com
- tags:
- - tagId: 1234
- name: Expedited
- - tagId: 9725
- name: 00 BULK ORDERED
- total: 2
- page: 1
- pages: 1
- type: object
- properties:
- customers:
- description: ''
- example:
- - customerId: 12345678
- createDate: 2014-11-18T10:33:01.1900000
- modifyDate: 2014-11-18T10:33:01.1900000
- name: Cam Newton
- company: Test Company
- street1: 123 War Eagle Lane
- street2: ''
- city: Auburn
- state: AL
- postalCode: 36830
- countryCode: US
- phone: 555-555-5555
- email: supermancam@example.com
- addressVerified: Verified
- marketplaceUsernames:
- - customerUserId: 67195020
- customerId: 12345678
- createDate: 2015-04-27T12:35:03.8300000
- modifyDate: 2015-05-14T08:16:15.2700000
- marketplaceId: 0
- marketplace: ShipStation
- username: camtheman@gmail.com
- - customerUserId: 37568588
- customerId: 12345678
- createDate: 2014-11-18T10:33:01.1970000
- modifyDate: 2014-11-18T10:33:01.1970000
- marketplaceId: 36
- marketplace: WooCommerce
- username: supercam@example.com
- - customerUserId: 46038940
- customerId: 12345678
- createDate:
- modifyDate:
- marketplaceId: 67
- marketplace: TradeGecko
- username: camtheman@gmail.com
- tags:
- - tagId: 1234
- name: Expedited
- - tagId: 9725
- name: 00 BULK ORDERED
- - customerId: 87654321
- createDate: 2015-06-21T12:48:07.5400000
- name: Bo Jackson
- company: Test Company
- street1: 456 Heisman Ave
- street2: ''
- city: Auburn
- state: AL
- postalCode: 36830
- countryCode: US
- phone: 555-555-5555
- email: boknows@example.com
- addressVerified: Verified
- marketplaceUsernames:
- - customerUserId: 77215410
- customerId: 87654321
- createDate: 2015-08-27T14:36:05.7500000
- modifyDate: 2015-09-01T09:18:25.3100000
- marketplaceId: 0
- marketplace: ShipStation
- username: boknows@gmail.com
- - customerUserId: 43759100
- customerId: 87654321
- createDate: 2015-07-05T11:38:01.1970000
- modifyDate: 2015-07-05T11:38:01.1970000
- marketplaceId: 36
- marketplace: WooCommerce
- username: boknows@example.com
- - customerUserId: 81565241
- customerId: 87654321
- createDate:
- modifyDate:
- marketplaceId: 67
- marketplace: TradeGecko
- username: bo@gmail.com
- tags:
- - tagId: 1234
- name: Expedited
- - tagId: 9725
- name: 00 BULK ORDERED
- type: array
- items:
- type: object
- total:
- description: ''
- example: 2
- type: integer
- format: int32
- page:
- description: ''
- example: 1
- type: integer
- format: int32
- pages:
- description: ''
- example: 1
- type: integer
- format: int32
- required:
- - customers
- - total
- - page
- - pages
- ListFulfillmentsW/oParametersResponse:
- title: List Fulfillments w/o parameters response
- example:
- fulfillments:
- - fulfillmentId: 33974374
- orderId: 191759016
- orderNumber: 101
- userId: c9f06d74-95de-4263-9b04-e87095cababf
- customerEmail: apisupport@shipstation.com
- trackingNumber: 783408231234
- createDate: 2016-06-07T08:50:50.0670000
- shipDate: 2016-06-07T00:00:00.0000000
- voidDate:
- deliveryDate:
- carrierCode: USPS
- fulfillmentProviderCode:
- fulfillmentServiceCode:
- fulfillmentFee: 0
- voidRequested: false
- voided: false
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Yoda
- company:
- street1: '3800 N Lamar Blvd # 220'
- street2:
- street3:
- city: AUSTIN
- state: TX
- postalCode: 78756
- country: US
- phone: 512-485-4282
- residential:
- addressVerified:
- - fulfillmentId: 246310
- orderId: 193699927
- orderNumber: 101
- userId: c9f06d74-95de-4263-9b04-e87095cababf
- customerEmail: apisupport@shipstation.com
- trackingNumber: 664756278745
- createDate: 2016-06-08T12:54:53.3470000
- shipDate: 2016-06-08T00:00:00.0000000
- voidDate:
- deliveryDate:
- carrierCode: FedEx
- fulfillmentProviderCode:
- fulfillmentServiceCode:
- fulfillmentFee: 0
- voidRequested: false
- voided: false
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Yoda
- company:
- street1: '3800 N Lamar Blvd # 220'
- street2:
- street3:
- city: AUSTIN
- state: TX
- postalCode: 78756
- country: US
- phone: 512-485-4282
- residential:
- addressVerified:
- total: 2
- page: 1
- pages: 0
- type: object
- properties:
- fulfillments:
- description: ''
- example:
- - fulfillmentId: 33974374
- orderId: 191759016
- orderNumber: 101
- userId: c9f06d74-95de-4263-9b04-e87095cababf
- customerEmail: apisupport@shipstation.com
- trackingNumber: 783408231234
- createDate: 2016-06-07T08:50:50.0670000
- shipDate: 2016-06-07T00:00:00.0000000
- voidDate:
- deliveryDate:
- carrierCode: USPS
- fulfillmentProviderCode:
- fulfillmentServiceCode:
- fulfillmentFee: 0
- voidRequested: false
- voided: false
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Yoda
- company:
- street1: '3800 N Lamar Blvd # 220'
- street2:
- street3:
- city: AUSTIN
- state: TX
- postalCode: 78756
- country: US
- phone: 512-485-4282
- residential:
- addressVerified:
- - fulfillmentId: 246310
- orderId: 193699927
- orderNumber: 101
- userId: c9f06d74-95de-4263-9b04-e87095cababf
- customerEmail: apisupport@shipstation.com
- trackingNumber: 664756278745
- createDate: 2016-06-08T12:54:53.3470000
- shipDate: 2016-06-08T00:00:00.0000000
- voidDate:
- deliveryDate:
- carrierCode: FedEx
- fulfillmentProviderCode:
- fulfillmentServiceCode:
- fulfillmentFee: 0
- voidRequested: false
- voided: false
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Yoda
- company:
- street1: '3800 N Lamar Blvd # 220'
- street2:
- street3:
- city: AUSTIN
- state: TX
- postalCode: 78756
- country: US
- phone: 512-485-4282
- residential:
- addressVerified:
- type: array
- items:
- type: object
- total:
- description: ''
- example: 2
- type: integer
- format: int32
- page:
- description: ''
- example: 1
- type: integer
- format: int32
- pages:
- description: ''
- example: 0
- type: integer
- format: int32
- required:
- - fulfillments
- - total
- - page
- - pages
- SortBy14:
- title: sortBy14
- example: ShipDate
- x-enum-elements:
- - name: ShipDate
- description: ''
- - name: CreateDate
- description: ''
- type: string
- enum:
- - ShipDate
- - CreateDate
- ListFulfillmentsWithParametersResponse:
- title: List Fulfillments with parameters response
- example:
- fulfillments:
- - fulfillmentId: 33974374
- orderId: 191759016
- orderNumber: 101
- userId: c9f06d74-95de-4263-9b04-e87095cababf
- customerEmail: apisupport@shipstation.com
- trackingNumber: 783408231234
- createDate: 2016-06-07T08:50:50.0670000
- shipDate: 2016-06-07T00:00:00.0000000
- voidDate:
- deliveryDate:
- carrierCode: USPS
- fulfillmentProviderCode:
- fulfillmentServiceCode:
- fulfillmentFee: 0
- voidRequested: false
- voided: false
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Yoda
- company:
- street1: '3800 N Lamar Blvd # 220'
- street2:
- street3:
- city: AUSTIN
- state: TX
- postalCode: 78756
- country: US
- phone: 512-485-4282
- residential:
- addressVerified:
- - fulfillmentId: 246310
- orderId: 193699927
- orderNumber: 101
- userId: c9f06d74-95de-4263-9b04-e87095cababf
- customerEmail: apisupport@shipstation.com
- trackingNumber: 664756278745
- createDate: 2016-06-08T12:54:53.3470000
- shipDate: 2016-06-08T00:00:00.0000000
- voidDate:
- deliveryDate:
- carrierCode: FedEx
- fulfillmentProviderCode:
- fulfillmentServiceCode:
- fulfillmentFee: 0
- voidRequested: false
- voided: false
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Yoda
- company:
- street1: '3800 N Lamar Blvd # 220'
- street2:
- street3:
- city: AUSTIN
- state: TX
- postalCode: 78756
- country: US
- phone: 512-485-4282
- residential:
- addressVerified:
- total: 2
- page: 1
- pages: 0
- type: object
- properties:
- fulfillments:
- description: ''
- example:
- - fulfillmentId: 33974374
- orderId: 191759016
- orderNumber: 101
- userId: c9f06d74-95de-4263-9b04-e87095cababf
- customerEmail: apisupport@shipstation.com
- trackingNumber: 783408231234
- createDate: 2016-06-07T08:50:50.0670000
- shipDate: 2016-06-07T00:00:00.0000000
- voidDate:
- deliveryDate:
- carrierCode: USPS
- fulfillmentProviderCode:
- fulfillmentServiceCode:
- fulfillmentFee: 0
- voidRequested: false
- voided: false
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Yoda
- company:
- street1: '3800 N Lamar Blvd # 220'
- street2:
- street3:
- city: AUSTIN
- state: TX
- postalCode: 78756
- country: US
- phone: 512-485-4282
- residential:
- addressVerified:
- - fulfillmentId: 246310
- orderId: 193699927
- orderNumber: 101
- userId: c9f06d74-95de-4263-9b04-e87095cababf
- customerEmail: apisupport@shipstation.com
- trackingNumber: 664756278745
- createDate: 2016-06-08T12:54:53.3470000
- shipDate: 2016-06-08T00:00:00.0000000
- voidDate:
- deliveryDate:
- carrierCode: FedEx
- fulfillmentProviderCode:
- fulfillmentServiceCode:
- fulfillmentFee: 0
- voidRequested: false
- voided: false
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Yoda
- company:
- street1: '3800 N Lamar Blvd # 220'
- street2:
- street3:
- city: AUSTIN
- state: TX
- postalCode: 78756
- country: US
- phone: 512-485-4282
- residential:
- addressVerified:
- type: array
- items:
- type: object
- total:
- description: ''
- example: 2
- type: integer
- format: int32
- page:
- description: ''
- example: 1
- type: integer
- format: int32
- pages:
- description: ''
- example: 0
- type: integer
- format: int32
- required:
- - fulfillments
- - total
- - page
- - pages
- GetOrderResponse:
- title: Get Order response
- example:
- orderId: 94113592
- orderNumber: TEST-ORDER-API-DOCS
- orderKey: 0f6bec18-9-4771-83aa-f392d84f4c74
- orderDate: 2015-06-29T08:46:27.0000000
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-09-08T11:03:12.3800000
- paymentDate: 2015-06-29T08:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId: 37701499
- customerUsername: headhoncho@whitehouse.gov
- customerEmail: headhoncho@whitehouse.gov
- billTo:
- name: The President
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: The President
- company: US Govt
- street1: 1600 Pennsylvania Ave
- street2: Oval Office
- street3:
- city: Washington
- state: DC
- postalCode: 20500
- country: US
- phone: 555-555-5555
- residential: false
- addressVerified: Address validation warning
- items:
- - orderItemId: 128836912
- lineItemKey: vd08-MSLbtx
- sku: ABC123
- name: 'Test item #1'
- imageUrl:
- weight:
- value: 24
- units: ounces
- quantity: 2
- unitPrice: 99.989999999999995
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 1, Bin 7
- options:
- - name: Size
- value: Large
- productId: 7239919
- fulfillmentSku:
- adjustment: false
- upc:
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-07-16T14:00:34.8230000
- - orderItemId: 128836913
- lineItemKey:
- sku: DISCOUNT CODE
- name: 10% OFF
- imageUrl:
- weight:
- value: 0
- units: ounces
- quantity: 1
- unitPrice: -20.550000000000001
- taxAmount:
- shippingAmount:
- warehouseLocation:
- options: []
- productId:
- fulfillmentSku:
- adjustment: true
- upc:
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-07-16T14:00:34.8230000
- orderTotal: 194.43000000000001
- amountPaid: 218.72999999999999
- taxAmount: 5
- shippingAmount: 10
- customerNotes: Thanks for ordering!
- internalNotes: Customer called and would like to upgrade shipping
- gift: true
- giftMessage: Thank you!
- paymentMethod: Credit Card
- requestedShippingService: Priority Mail
- carrierCode: fedex
- serviceCode: fedex_home_delivery
- packageCode: package
- confirmation: delivery
- shipDate: 2015-07-02
- holdUntilDate:
- weight:
- value: 48
- units: ounces
- dimensions:
- units: inches
- length: 7
- width: 5
- height: 6
- insuranceOptions:
- provider: carrier
- insureShipment: true
- insuredValue: 200
- internationalOptions:
- contents:
- customsItems:
- nonDelivery:
- advancedOptions:
- warehouseId: 24079
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 26815
- customField1: 'Custom data that you can add to an order. See Custom Field #2 & #3 for more info!'
- customField2: Per UI settings, this information can appear on some carrier's shipping labels. See link below
- customField3: https://help.shipstation.com/hc/en-us/articles/206639957
- source: Webstore
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- userId:
- externallyFulfilled: false
- externallyFulfilledBy:
- type: object
- properties:
- orderId:
- description: ''
- example: 94113592
- type: integer
- format: int32
- orderNumber:
- description: ''
- example: TEST-ORDER-API-DOCS
- type: string
- orderKey:
- description: ''
- example: 0f6bec18-9-4771-83aa-f392d84f4c74
- type: string
- orderDate:
- description: ''
- example: 6/29/2015 8:46:27 AM
- type: string
- createDate:
- description: ''
- example: 7/16/2015 2:00:34 PM
- type: string
- modifyDate:
- description: ''
- example: 9/8/2015 11:03:12 AM
- type: string
- paymentDate:
- description: ''
- example: 6/29/2015 8:46:27 AM
- type: string
- shipByDate:
- description: ''
- example: 7/5/2015 12:00:00 AM
- type: string
- orderStatus:
- description: ''
- example: awaiting_shipment
- type: string
- customerId:
- description: ''
- example: 37701499
- type: integer
- format: int32
- customerUsername:
- description: ''
- example: headhoncho@whitehouse.gov
- type: string
- customerEmail:
- description: ''
- example: headhoncho@whitehouse.gov
- type: string
- billTo:
- description: ''
- example:
- name: The President
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- type: object
- shipTo:
- description: ''
- example:
- name: The President
- company: US Govt
- street1: 1600 Pennsylvania Ave
- street2: Oval Office
- street3:
- city: Washington
- state: DC
- postalCode: 20500
- country: US
- phone: 555-555-5555
- residential: false
- addressVerified: Address validation warning
- type: object
- items:
- description: ''
- example:
- - orderItemId: 128836912
- lineItemKey: vd08-MSLbtx
- sku: ABC123
- name: 'Test item #1'
- imageUrl:
- weight:
- value: 24
- units: ounces
- quantity: 2
- unitPrice: 99.989999999999995
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 1, Bin 7
- options:
- - name: Size
- value: Large
- productId: 7239919
- fulfillmentSku:
- adjustment: false
- upc:
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-07-16T14:00:34.8230000
- - orderItemId: 128836913
- lineItemKey:
- sku: DISCOUNT CODE
- name: 10% OFF
- imageUrl:
- weight:
- value: 0
- units: ounces
- quantity: 1
- unitPrice: -20.550000000000001
- taxAmount:
- shippingAmount:
- warehouseLocation:
- options: []
- productId:
- fulfillmentSku:
- adjustment: true
- upc:
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-07-16T14:00:34.8230000
- type: array
- items:
- type: object
- orderTotal:
- description: ''
- example: 194.43000000000001
- type: number
- format: double
- amountPaid:
- description: ''
- example: 218.72999999999999
- type: number
- format: double
- taxAmount:
- description: ''
- example: 5
- type: integer
- format: int32
- shippingAmount:
- description: ''
- example: 10
- type: integer
- format: int32
- customerNotes:
- description: ''
- example: Thanks for ordering!
- type: string
- internalNotes:
- description: ''
- example: Customer called and would like to upgrade shipping
- type: string
- gift:
- description: ''
- example: true
- type: boolean
- giftMessage:
- description: ''
- example: Thank you!
- type: string
- paymentMethod:
- description: ''
- example: Credit Card
- type: string
- requestedShippingService:
- description: ''
- example: Priority Mail
- type: string
- carrierCode:
- description: ''
- example: fedex
- type: string
- serviceCode:
- description: ''
- example: fedex_home_delivery
- type: string
- packageCode:
- description: ''
- example: package
- type: string
- confirmation:
- description: ''
- example: delivery
- type: string
- shipDate:
- description: ''
- example: 2015-07-02
- type: string
- holdUntilDate:
- description: ''
- type: string
- weight:
- description: ''
- example:
- value: 48
- units: ounces
- type: object
- dimensions:
- description: ''
- example:
- units: inches
- length: 7
- width: 5
- height: 6
- type: object
- insuranceOptions:
- description: ''
- example:
- provider: carrier
- insureShipment: true
- insuredValue: 200
- type: object
- internationalOptions:
- description: ''
- example:
- contents:
- customsItems:
- nonDelivery:
- type: object
- advancedOptions:
- description: ''
- example:
- warehouseId: 24079
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 26815
- customField1: 'Custom data that you can add to an order. See Custom Field #2 & #3 for more info!'
- customField2: Per UI settings, this information can appear on some carrier's shipping labels. See link below
- customField3: https://help.shipstation.com/hc/en-us/articles/206639957
- source: Webstore
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- type: object
- tagIds:
- description: ''
- type: string
- userId:
- description: ''
- type: string
- externallyFulfilled:
- description: ''
- example: false
- type: boolean
- externallyFulfilledBy:
- description: ''
- type: string
- required:
- - orderId
- - orderNumber
- - orderKey
- - orderDate
- - createDate
- - modifyDate
- - paymentDate
- - shipByDate
- - orderStatus
- - customerId
- - customerUsername
- - customerEmail
- - billTo
- - shipTo
- - items
- - orderTotal
- - amountPaid
- - taxAmount
- - shippingAmount
- - customerNotes
- - internalNotes
- - gift
- - giftMessage
- - paymentMethod
- - requestedShippingService
- - carrierCode
- - serviceCode
- - packageCode
- - confirmation
- - shipDate
- - holdUntilDate
- - weight
- - dimensions
- - insuranceOptions
- - internationalOptions
- - advancedOptions
- - tagIds
- - userId
- - externallyFulfilled
- - externallyFulfilledBy
- DeleteOrderResponse:
- title: Delete Order response
- example:
- success: true
- message: The requested order has been deleted.
- type: object
- properties:
- success:
- description: ''
- example: true
- type: boolean
- message:
- description: ''
- example: The requested order has been deleted.
- type: string
- required:
- - success
- - message
- AddTagToOrderRequest:
- title: Add Tag to Order request
- type: object
- properties:
- orderId:
- description: ''
- example: 123456
- type: integer
- format: int32
- tagId:
- description: ''
- example: 1234
- type: integer
- format: int32
- required:
- - orderId
- - tagId
- AddTagToOrderResponse:
- title: Add Tag to Order response
- example:
- success: true
- message: Tag added successfully.
- type: object
- properties:
- success:
- description: ''
- example: true
- type: boolean
- message:
- description: ''
- example: Tag added successfully.
- type: string
- required:
- - success
- - message
- AssignUserToOrderRequest:
- title: Assign User to Order request
- type: object
- properties:
- orderIds:
- description: ''
- example:
- - 123456789
- - 12345679
- type: array
- items:
- type: integer
- format: int32
- userId:
- description: ''
- example: 123456AB-ab12-3c4d-5e67-89f1abc1defa
- type: string
- required:
- - orderIds
- - userId
- AssignUserToOrderResponse:
- title: Assign User to Order response
- example:
- success: true
- message: User assigned successfully.
- type: object
- properties:
- success:
- description: ''
- example: true
- type: boolean
- message:
- description: ''
- example: User assigned successfully.
- type: string
- required:
- - success
- - message
- CreateLabelForOrderRequest:
- title: Create Label for Order request
- type: object
- properties:
- orderId:
- description: ''
- example: 93348442
- type: integer
- format: int32
- carrierCode:
- description: ''
- example: fedex
- type: string
- serviceCode:
- description: ''
- example: fedex_2day
- type: string
- packageCode:
- description: ''
- example: package
- type: string
- confirmation:
- description: ''
- type: string
- shipDate:
- description: ''
- example: 2014-04-03
- type: string
- weight:
- description: ''
- example:
- value: 2
- units: pounds
- type: object
- dimensions:
- description: ''
- type: string
- insuranceOptions:
- description: ''
- type: string
- internationalOptions:
- description: ''
- type: string
- advancedOptions:
- description: ''
- type: string
- testLabel:
- description: ''
- example: false
- type: boolean
- required:
- - orderId
- - carrierCode
- - serviceCode
- - packageCode
- - confirmation
- - shipDate
- - weight
- - dimensions
- - insuranceOptions
- - internationalOptions
- - advancedOptions
- - testLabel
- CreateLabelForOrderResponse:
- title: Create Label for Order response
- example:
- shipmentId: 72513480
- shipmentCost: 7.2999999999999998
- insuranceCost: 0
- trackingNumber: 248201115029520
- labelData: JVBERi0xLjQKJeLjz9MKMiAwIG9iago8PC9MZW5ndGggNjIvRmlsdGVyL0ZsYXRlRGVjb2RlPj5zdHJlYW0KeJwr5HIK4TI2UzC2NFMISeFyDeEK5CpUMFQwAEJDBV0jCz0LBV1jY0M9I4XkXAX9iDRDBZd8hUAuAEdGC7cKZW5kc3RyZWFtCmVuZG9iago0IDAgb2JqCjw8L1R5cGUvUGFnZS9NZWRpYUJveFswIDAgMjg4IDQzMl0vUmVzb3VyY2VzPDwvUHJvY1NldCBbL1BERiAvVGV4dCAvSW1hZ2VCIC9JbWFnZUMgL0ltYWdlSV0vWE9iamVjdDw8L1hmMSAxIDAgUj4+Pj4vQ29udGVudHMgMiAwIFIvUGFyZW50....
- formData:
- type: object
- properties:
- shipmentId:
- description: ''
- example: 72513480
- type: integer
- format: int32
- shipmentCost:
- description: ''
- example: 7.2999999999999998
- type: number
- format: double
- insuranceCost:
- description: ''
- example: 0
- type: integer
- format: int32
- trackingNumber:
- description: ''
- example: 248201115029520
- type: string
- labelData:
- description: ''
- example: JVBERi0xLjQKJeLjz9MKMiAwIG9iago8PC9MZW5ndGggNjIvRmlsdGVyL0ZsYXRlRGVjb2RlPj5zdHJlYW0KeJwr5HIK4TI2UzC2NFMISeFyDeEK5CpUMFQwAEJDBV0jCz0LBV1jY0M9I4XkXAX9iDRDBZd8hUAuAEdGC7cKZW5kc3RyZWFtCmVuZG9iago0IDAgb2JqCjw8L1R5cGUvUGFnZS9NZWRpYUJveFswIDAgMjg4IDQzMl0vUmVzb3VyY2VzPDwvUHJvY1NldCBbL1BERiAvVGV4dCAvSW1hZ2VCIC9JbWFnZUMgL0ltYWdlSV0vWE9iamVjdDw8L1hmMSAxIDAgUj4+Pj4vQ29udGVudHMgMiAwIFIvUGFyZW50....
- type: string
- formData:
- description: ''
- type: string
- required:
- - shipmentId
- - shipmentCost
- - insuranceCost
- - trackingNumber
- - labelData
- - formData
- Create/updateOrderRequest:
- title: Create/Update Order request
- type: object
- properties:
- orderNumber:
- description: ''
- example: TEST-ORDER-API-DOCS
- type: string
- orderKey:
- description: ''
- example: 0f6bec18-3e89-4881-83aa-f392d84f4c74
- type: string
- orderDate:
- description: ''
- example: 6/29/2015 8:46:27 AM
- type: string
- paymentDate:
- description: ''
- example: 6/29/2015 8:46:27 AM
- type: string
- shipByDate:
- description: ''
- example: 7/5/2015 12:00:00 AM
- type: string
- orderStatus:
- description: ''
- example: awaiting_shipment
- type: string
- customerId:
- description: ''
- example: 37701499
- type: integer
- format: int32
- customerUsername:
- description: ''
- example: headhoncho@whitehouse.gov
- type: string
- customerEmail:
- description: ''
- example: headhoncho@whitehouse.gov
- type: string
- billTo:
- description: ''
- example:
- name: The President
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- type: object
- shipTo:
- description: ''
- example:
- name: The President
- company: US Govt
- street1: 1600 Pennsylvania Ave
- street2: Oval Office
- street3:
- city: Washington
- state: DC
- postalCode: 20500
- country: US
- phone: 555-555-5555
- residential: true
- type: object
- items:
- description: ''
- example:
- - lineItemKey: vd08-MSLbtx
- sku: ABC123
- name: 'Test item #1'
- imageUrl:
- weight:
- value: 24
- units: ounces
- quantity: 2
- unitPrice: 99.989999999999995
- taxAmount: 2.5
- shippingAmount: 5
- warehouseLocation: Aisle 1, Bin 7
- options:
- - name: Size
- value: Large
- productId: 123456
- fulfillmentSku:
- adjustment: false
- upc: 32-65-98
- - lineItemKey:
- sku: DISCOUNT CODE
- name: 10% OFF
- imageUrl:
- weight:
- value: 0
- units: ounces
- quantity: 1
- unitPrice: -20.550000000000001
- taxAmount:
- shippingAmount:
- warehouseLocation:
- options: []
- productId: 123456
- fulfillmentSku: SKU-Discount
- adjustment: true
- upc:
- type: array
- items:
- type: object
- amountPaid:
- description: ''
- example: 218.72999999999999
- type: number
- format: double
- taxAmount:
- description: ''
- example: 5
- type: integer
- format: int32
- shippingAmount:
- description: ''
- example: 10
- type: integer
- format: int32
- customerNotes:
- description: ''
- example: Thanks for ordering!
- type: string
- internalNotes:
- description: ''
- example: Customer called and would like to upgrade shipping
- type: string
- gift:
- description: ''
- example: true
- type: boolean
- giftMessage:
- description: ''
- example: Thank you!
- type: string
- paymentMethod:
- description: ''
- example: Credit Card
- type: string
- requestedShippingService:
- description: ''
- example: Priority Mail
- type: string
- carrierCode:
- description: ''
- example: fedex
- type: string
- serviceCode:
- description: ''
- example: fedex_2day
- type: string
- packageCode:
- description: ''
- example: package
- type: string
- confirmation:
- description: ''
- example: delivery
- type: string
- shipDate:
- description: ''
- example: 2015-07-02
- type: string
- weight:
- description: ''
- example:
- value: 25
- units: ounces
- type: object
- dimensions:
- description: ''
- example:
- units: inches
- length: 7
- width: 5
- height: 6
- type: object
- insuranceOptions:
- description: ''
- example:
- provider: carrier
- insureShipment: true
- insuredValue: 200
- type: object
- internationalOptions:
- description: ''
- example:
- contents:
- customsItems:
- type: object
- advancedOptions:
- description: ''
- example:
- warehouseId: 98765
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'Custom data that you can add to an order. See Custom Field #2 & #3 for more info!'
- customField2: Per UI settings, this information can appear on some carrier's shipping labels. See link below
- customField3: https://help.shipstation.com/hc/en-us/articles/206639957
- source: Webstore
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- type: object
- required:
- - orderNumber
- - orderKey
- - orderDate
- - paymentDate
- - shipByDate
- - orderStatus
- - customerId
- - customerUsername
- - customerEmail
- - billTo
- - shipTo
- - items
- - amountPaid
- - taxAmount
- - shippingAmount
- - customerNotes
- - internalNotes
- - gift
- - giftMessage
- - paymentMethod
- - requestedShippingService
- - carrierCode
- - serviceCode
- - packageCode
- - confirmation
- - shipDate
- - weight
- - dimensions
- - insuranceOptions
- - internationalOptions
- - advancedOptions
- Create/updateOrderResponse:
- title: Create/Update Order response
- example:
- orderId: 140335319
- orderNumber: TEST-ORDER-API-DOCS
- orderKey: 0f6bec18-3e89-4881-83aa-f392d84f4c74
- orderDate: 2015-06-29T08:46:27.0000000
- createDate: 2016-02-16T15:16:53.7070000
- modifyDate: 2016-02-16T15:16:53.7070000
- paymentDate: 2015-06-29T08:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId:
- customerUsername: headhoncho@whitehouse.gov
- customerEmail: headhoncho@whitehouse.gov
- billTo:
- name: The President
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: The President
- company: US Govt
- street1: 1600 Pennsylvania Ave
- street2: Oval Office
- street3:
- city: Washington
- state: DC
- postalCode: 20500
- country: US
- phone: 555-555-5555
- residential: false
- addressVerified: Address validation warning
- items:
- - orderItemId: 192210956
- lineItemKey: vd08-MSLbtx
- sku: ABC123
- name: 'Test item #1'
- imageUrl:
- weight:
- value: 24
- units: ounces
- quantity: 2
- unitPrice: 99.989999999999995
- taxAmount: 2.5
- shippingAmount: 5
- warehouseLocation: Aisle 1, Bin 7
- options:
- - name: Size
- value: Large
- productId:
- fulfillmentSku:
- adjustment: false
- upc: 32-65-98
- createDate: 2016-02-16T15:16:53.7070000
- modifyDate: 2016-02-16T15:16:53.7070000
- - orderItemId: 192210957
- lineItemKey:
- sku: DISCOUNT CODE
- name: 10% OFF
- imageUrl:
- weight:
- value: 0
- units: ounces
- quantity: 1
- unitPrice: -20.550000000000001
- taxAmount:
- shippingAmount:
- warehouseLocation:
- options: []
- productId:
- fulfillmentSku: SKU-Discount
- adjustment: true
- upc:
- createDate: 2016-02-16T15:16:53.7070000
- modifyDate: 2016-02-16T15:16:53.7070000
- orderTotal: 194.43000000000001
- amountPaid: 218.72999999999999
- taxAmount: 5
- shippingAmount: 10
- customerNotes: Thanks for ordering!
- internalNotes: Customer called and would like to upgrade shipping
- gift: true
- giftMessage: Thank you!
- paymentMethod: Credit Card
- requestedShippingService: Priority Mail
- carrierCode: fedex
- serviceCode: fedex_2day
- packageCode: package
- confirmation: delivery
- shipDate: 2015-07-02
- holdUntilDate:
- weight:
- value: 25
- units: ounces
- dimensions:
- units: inches
- length: 7
- width: 5
- height: 6
- insuranceOptions:
- provider: carrier
- insureShipment: true
- insuredValue: 200
- internationalOptions:
- contents:
- customsItems:
- nonDelivery:
- advancedOptions:
- warehouseId: 9876
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'Custom data that you can add to an order. See Custom Field #2 & #3 for more info!'
- customField2: Per UI settings, this information can appear on some carrier's shipping labels. See link below
- customField3: https://help.shipstation.com/hc/en-us/articles/206639957
- source: Webstore
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- userId:
- externallyFulfilled: false
- externallyFulfilledBy:
- type: object
- properties:
- orderId:
- description: ''
- example: 140335319
- type: integer
- format: int32
- orderNumber:
- description: ''
- example: TEST-ORDER-API-DOCS
- type: string
- orderKey:
- description: ''
- example: 0f6bec18-3e89-4881-83aa-f392d84f4c74
- type: string
- orderDate:
- description: ''
- example: 6/29/2015 8:46:27 AM
- type: string
- createDate:
- description: ''
- example: 2/16/2016 3:16:53 PM
- type: string
- modifyDate:
- description: ''
- example: 2/16/2016 3:16:53 PM
- type: string
- paymentDate:
- description: ''
- example: 6/29/2015 8:46:27 AM
- type: string
- shipByDate:
- description: ''
- example: 7/5/2015 12:00:00 AM
- type: string
- orderStatus:
- description: ''
- example: awaiting_shipment
- type: string
- customerId:
- description: ''
- type: string
- customerUsername:
- description: ''
- example: headhoncho@whitehouse.gov
- type: string
- customerEmail:
- description: ''
- example: headhoncho@whitehouse.gov
- type: string
- billTo:
- description: ''
- example:
- name: The President
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- type: object
- shipTo:
- description: ''
- example:
- name: The President
- company: US Govt
- street1: 1600 Pennsylvania Ave
- street2: Oval Office
- street3:
- city: Washington
- state: DC
- postalCode: 20500
- country: US
- phone: 555-555-5555
- residential: false
- addressVerified: Address validation warning
- type: object
- items:
- description: ''
- example:
- - orderItemId: 192210956
- lineItemKey: vd08-MSLbtx
- sku: ABC123
- name: 'Test item #1'
- imageUrl:
- weight:
- value: 24
- units: ounces
- quantity: 2
- unitPrice: 99.989999999999995
- taxAmount: 2.5
- shippingAmount: 5
- warehouseLocation: Aisle 1, Bin 7
- options:
- - name: Size
- value: Large
- productId:
- fulfillmentSku:
- adjustment: false
- upc: 32-65-98
- createDate: 2016-02-16T15:16:53.7070000
- modifyDate: 2016-02-16T15:16:53.7070000
- - orderItemId: 192210957
- lineItemKey:
- sku: DISCOUNT CODE
- name: 10% OFF
- imageUrl:
- weight:
- value: 0
- units: ounces
- quantity: 1
- unitPrice: -20.550000000000001
- taxAmount:
- shippingAmount:
- warehouseLocation:
- options: []
- productId:
- fulfillmentSku: SKU-Discount
- adjustment: true
- upc:
- createDate: 2016-02-16T15:16:53.7070000
- modifyDate: 2016-02-16T15:16:53.7070000
- type: array
- items:
- type: object
- orderTotal:
- description: ''
- example: 194.43000000000001
- type: number
- format: double
- amountPaid:
- description: ''
- example: 218.72999999999999
- type: number
- format: double
- taxAmount:
- description: ''
- example: 5
- type: integer
- format: int32
- shippingAmount:
- description: ''
- example: 10
- type: integer
- format: int32
- customerNotes:
- description: ''
- example: Thanks for ordering!
- type: string
- internalNotes:
- description: ''
- example: Customer called and would like to upgrade shipping
- type: string
- gift:
- description: ''
- example: true
- type: boolean
- giftMessage:
- description: ''
- example: Thank you!
- type: string
- paymentMethod:
- description: ''
- example: Credit Card
- type: string
- requestedShippingService:
- description: ''
- example: Priority Mail
- type: string
- carrierCode:
- description: ''
- example: fedex
- type: string
- serviceCode:
- description: ''
- example: fedex_2day
- type: string
- packageCode:
- description: ''
- example: package
- type: string
- confirmation:
- description: ''
- example: delivery
- type: string
- shipDate:
- description: ''
- example: 2015-07-02
- type: string
- holdUntilDate:
- description: ''
- type: string
- weight:
- description: ''
- example:
- value: 25
- units: ounces
- type: object
- dimensions:
- description: ''
- example:
- units: inches
- length: 7
- width: 5
- height: 6
- type: object
- insuranceOptions:
- description: ''
- example:
- provider: carrier
- insureShipment: true
- insuredValue: 200
- type: object
- internationalOptions:
- description: ''
- example:
- contents:
- customsItems:
- nonDelivery:
- type: object
- advancedOptions:
- description: ''
- example:
- warehouseId: 9876
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'Custom data that you can add to an order. See Custom Field #2 & #3 for more info!'
- customField2: Per UI settings, this information can appear on some carrier's shipping labels. See link below
- customField3: https://help.shipstation.com/hc/en-us/articles/206639957
- source: Webstore
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- type: object
- tagIds:
- description: ''
- type: string
- userId:
- description: ''
- type: string
- externallyFulfilled:
- description: ''
- example: false
- type: boolean
- externallyFulfilledBy:
- description: ''
- type: string
- required:
- - orderId
- - orderNumber
- - orderKey
- - orderDate
- - createDate
- - modifyDate
- - paymentDate
- - shipByDate
- - orderStatus
- - customerId
- - customerUsername
- - customerEmail
- - billTo
- - shipTo
- - items
- - orderTotal
- - amountPaid
- - taxAmount
- - shippingAmount
- - customerNotes
- - internalNotes
- - gift
- - giftMessage
- - paymentMethod
- - requestedShippingService
- - carrierCode
- - serviceCode
- - packageCode
- - confirmation
- - shipDate
- - holdUntilDate
- - weight
- - dimensions
- - insuranceOptions
- - internationalOptions
- - advancedOptions
- - tagIds
- - userId
- - externallyFulfilled
- - externallyFulfilledBy
- Create/updateMultipleOrdersRequest:
- title: Create/Update Multiple Orders request
- type: object
- properties:
- orderNumber:
- description: ''
- example: TEST-ORDER-API-DOCS
- type: string
- orderKey:
- description: ''
- example: 0f6bec18-3e89-4881-83aa-f392d84f4c74
- type: string
- orderDate:
- description: ''
- example: 6/29/2015 8:46:27 AM
- type: string
- paymentDate:
- description: ''
- example: 6/29/2015 8:46:27 AM
- type: string
- shipByDate:
- description: ''
- example: 7/5/2015 12:00:00 AM
- type: string
- orderStatus:
- description: ''
- example: awaiting_shipment
- type: string
- customerId:
- description: ''
- example: 37701499
- type: integer
- format: int32
- customerUsername:
- description: ''
- example: headhoncho@whitehouse.gov
- type: string
- customerEmail:
- description: ''
- example: headhoncho@whitehouse.gov
- type: string
- billTo:
- description: ''
- example:
- name: The President
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- type: object
- shipTo:
- description: ''
- example:
- name: The President
- company: US Govt
- street1: 1600 Pennsylvania Ave
- street2: Oval Office
- street3:
- city: Washington
- state: DC
- postalCode: 20500
- country: US
- phone: 555-555-5555
- residential: true
- type: object
- items:
- description: ''
- example:
- - lineItemKey: vd08-MSLbtx
- sku: ABC123
- name: 'Test item #1'
- imageUrl:
- weight:
- value: 24
- units: ounces
- quantity: 2
- unitPrice: 99.989999999999995
- taxAmount: 2.5
- shippingAmount: 5
- warehouseLocation: Aisle 1, Bin 7
- options:
- - name: Size
- value: Large
- productId: 123456
- fulfillmentSku:
- adjustment: false
- upc: 32-65-98
- - lineItemKey:
- sku: DISCOUNT CODE
- name: 10% OFF
- imageUrl:
- weight:
- value: 0
- units: ounces
- quantity: 1
- unitPrice: -20.550000000000001
- taxAmount:
- shippingAmount:
- warehouseLocation:
- options: []
- productId: 123456
- fulfillmentSku: SKU-Discount
- adjustment: true
- upc:
- type: array
- items:
- type: object
- amountPaid:
- description: ''
- example: 218.72999999999999
- type: number
- format: double
- taxAmount:
- description: ''
- example: 5
- type: integer
- format: int32
- shippingAmount:
- description: ''
- example: 10
- type: integer
- format: int32
- customerNotes:
- description: ''
- example: Thanks for ordering!
- type: string
- internalNotes:
- description: ''
- example: Customer called and would like to upgrade shipping
- type: string
- gift:
- description: ''
- example: true
- type: boolean
- giftMessage:
- description: ''
- example: Thank you!
- type: string
- paymentMethod:
- description: ''
- example: Credit Card
- type: string
- requestedShippingService:
- description: ''
- example: Priority Mail
- type: string
- carrierCode:
- description: ''
- example: fedex
- type: string
- serviceCode:
- description: ''
- example: fedex_2day
- type: string
- packageCode:
- description: ''
- example: package
- type: string
- confirmation:
- description: ''
- example: delivery
- type: string
- shipDate:
- description: ''
- example: 2015-07-02
- type: string
- weight:
- description: ''
- example:
- value: 25
- units: ounces
- type: object
- dimensions:
- description: ''
- example:
- units: inches
- length: 7
- width: 5
- height: 6
- type: object
- insuranceOptions:
- description: ''
- example:
- provider: carrier
- insureShipment: true
- insuredValue: 200
- type: object
- internationalOptions:
- description: ''
- example:
- contents:
- customsItems:
- type: object
- advancedOptions:
- description: ''
- example:
- warehouseId: 98765
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'Custom data that you can add to an order. See Custom Field #2 & #3 for more info!'
- customField2: Per UI settings, this information can appear on some carrier's shipping labels. See link below
- customField3: https://help.shipstation.com/hc/en-us/articles/206639957
- source: Webstore
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- type: object
- required:
- - orderNumber
- - orderKey
- - orderDate
- - paymentDate
- - shipByDate
- - orderStatus
- - customerId
- - customerUsername
- - customerEmail
- - billTo
- - shipTo
- - items
- - amountPaid
- - taxAmount
- - shippingAmount
- - customerNotes
- - internalNotes
- - gift
- - giftMessage
- - paymentMethod
- - requestedShippingService
- - carrierCode
- - serviceCode
- - packageCode
- - confirmation
- - shipDate
- - weight
- - dimensions
- - insuranceOptions
- - internationalOptions
- - advancedOptions
- Create/updateMultipleOrdersResponse:
- title: Create/Update Multiple Orders response
- example:
- hasErrors: false
- results:
- - orderId: 58345234
- orderNumber: TEST-ORDER-API-DOCS
- orderKey: 0f6bec18-3e89-4881-83aa-f392d84f4c74
- success: true
- errorMessage:
- type: object
- properties:
- hasErrors:
- description: ''
- example: false
- type: boolean
- results:
- description: ''
- example:
- - orderId: 58345234
- orderNumber: TEST-ORDER-API-DOCS
- orderKey: 0f6bec18-3e89-4881-83aa-f392d84f4c74
- success: true
- errorMessage:
- type: array
- items:
- type: object
- required:
- - hasErrors
- - results
- HoldOrderUntilRequest:
- title: Hold Order Until request
- type: object
- properties:
- orderId:
- description: ''
- example: 1072467
- type: integer
- format: int32
- holdUntilDate:
- description: ''
- example: 2014-12-01
- type: string
- required:
- - orderId
- - holdUntilDate
- HoldOrderUntilResponse:
- title: Hold Order Until response
- example:
- success: true
- message: Order held successfully.
- type: object
- properties:
- success:
- description: ''
- example: true
- type: boolean
- message:
- description: ''
- example: Order held successfully.
- type: string
- required:
- - success
- - message
- ListOrdersW/oParametersResponse:
- title: List Orders w/o parameters response
- example:
- orders:
- - orderId: 987654321
- orderNumber: Test-International-API-DOCS
- orderKey: Test-International-API-DOCS
- orderDate: 2015-06-28T17:46:27.0000000
- createDate: 2015-08-17T09:24:14.7800000
- modifyDate: 2015-08-17T09:24:16.4800000
- paymentDate: 2015-06-28T17:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId: 63310475
- customerUsername: sholmes1854@methodsofdetection.com
- customerEmail: sholmes1854@methodsofdetection.com
- billTo:
- name: Sherlock Holmes
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: Sherlock Holmes
- company: ''
- street1: 221 B Baker St
- street2: ''
- street3:
- city: London
- state: ''
- postalCode: NW1 6XE
- country: GB
- phone:
- residential: true
- addressVerified: Address not yet validated
- items:
- - orderItemId: 136282568
- lineItemKey:
- sku: Ele-1234
- name: Elementary Disguise Kit
- imageUrl:
- weight:
- value: 12
- units: ounces
- quantity: 2
- unitPrice: 49.990000000000002
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 1, Bin 7
- options: []
- productId: 11780610
- fulfillmentSku: Ele-1234
- adjustment: false
- upc:
- createDate: 2015-08-17T09:24:14.7800000
- modifyDate: 2015-08-17T09:24:14.7800000
- - orderItemId: 136282569
- lineItemKey:
- sku: CN-9876
- name: Fine White Oak Cane
- imageUrl:
- weight:
- value: 80
- units: ounces
- quantity: 1
- unitPrice: 225
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 7, Bin 34
- options: []
- productId: 11780609
- fulfillmentSku:
- adjustment: false
- upc:
- createDate: 2015-08-17T09:24:14.7800000
- modifyDate: 2015-08-17T09:24:14.7800000
- orderTotal: 387.97000000000003
- amountPaid: 412.97000000000003
- taxAmount: 27.989999999999998
- shippingAmount: 35
- customerNotes: Please be careful when packing the disguise kits in with the cane.
- internalNotes: Mr. Holmes called to upgrade his shipping to expedited
- gift: false
- giftMessage:
- paymentMethod:
- requestedShippingService: Priority Mail Int
- carrierCode: stamps_com
- serviceCode: usps_priority_mail_international
- packageCode: package
- confirmation: delivery
- shipDate: 2015-04-25
- holdUntilDate:
- weight:
- value: 104
- units: ounces
- dimensions:
- units: inches
- length: 40
- width: 7
- height: 5
- insuranceOptions:
- provider:
- insureShipment: false
- insuredValue: 0
- internationalOptions:
- contents: merchandise
- customsItems:
- - customsItemId: 11558268
- description: Fine White Oak Cane
- quantity: 1
- value: 225
- harmonizedTariffCode:
- countryOfOrigin: US
- - customsItemId: 11558267
- description: Elementary Disguise Kit
- quantity: 2
- value: 49.990000000000002
- harmonizedTariffCode:
- countryOfOrigin: US
- nonDelivery: return_to_sender
- advancedOptions:
- warehouseId: 98765
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'SKU: CN-9876 x 1'
- customField2: 'SKU: Ele-123 x 2'
- customField3:
- source:
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- userId:
- externallyFulfilled: false
- externallyFulfilledBy:
- - orderId: 123456789
- orderNumber: TEST-ORDER-API-DOCS
- orderKey: 0f6bec18-9-4771-83aa-f392d84f4c74
- orderDate: 2015-06-29T08:46:27.0000000
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-08-17T09:21:59.4430000
- paymentDate: 2015-06-29T08:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId: 37701499
- customerUsername: headhoncho@whitehouse.gov
- customerEmail: headhoncho@whitehouse.gov
- billTo:
- name: The President
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: The President
- company: US Govt
- street1: 1600 Pennsylvania Ave
- street2: Oval Office
- street3:
- city: Washington
- state: DC
- postalCode: 20500
- country: US
- phone: 555-555-5555
- residential: false
- addressVerified: Address validation warning
- items:
- - orderItemId: 128836912
- lineItemKey: vd08-MSLbtx
- sku: ABC123
- name: 'Test item #1'
- imageUrl:
- weight:
- value: 24
- units: ounces
- quantity: 2
- unitPrice: 99.989999999999995
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 1, Bin 7
- options:
- - name: Size
- value: Large
- productId: 7239919
- fulfillmentSku:
- adjustment: false
- upc:
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-07-16T14:00:34.8230000
- - orderItemId: 128836913
- lineItemKey:
- sku: DISCOUNT CODE
- name: 10% OFF
- imageUrl:
- weight:
- value: 0
- units: ounces
- quantity: 1
- unitPrice: -20.550000000000001
- taxAmount:
- shippingAmount:
- warehouseLocation:
- options: []
- productId:
- fulfillmentSku:
- adjustment: true
- upc:
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-07-16T14:00:34.8230000
- orderTotal: 194.43000000000001
- amountPaid: 218.72999999999999
- taxAmount: 5
- shippingAmount: 10
- customerNotes: Thanks for ordering!
- internalNotes: Customer called and would like to upgrade shipping
- gift: true
- giftMessage: Thank you!
- paymentMethod: Credit Card
- requestedShippingService: Priority Mail
- carrierCode: fedex
- serviceCode: fedex_home_delivery
- packageCode: package
- confirmation: delivery
- shipDate: 2015-07-02
- holdUntilDate:
- weight:
- value: 48
- units: ounces
- dimensions:
- units: inches
- length: 7
- width: 5
- height: 6
- insuranceOptions:
- provider: carrier
- insureShipment: true
- insuredValue: 200
- internationalOptions:
- contents:
- customsItems:
- nonDelivery:
- advancedOptions:
- warehouseId: 98765
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'Custom data that you can add to an order. See Custom Field #2 & #3 for more info!'
- customField2: Per UI settings, this information can appear on some carrier's shipping labels. See link below
- customField3: https://help.shipstation.com/hc/en-us/articles/206639957
- source: Webstore
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- userId:
- externallyFulfilled: false
- externallyFulfilledBy:
- total: 2
- page: 1
- pages: 0
- type: object
- properties:
- orders:
- description: ''
- example:
- - orderId: 987654321
- orderNumber: Test-International-API-DOCS
- orderKey: Test-International-API-DOCS
- orderDate: 2015-06-28T17:46:27.0000000
- createDate: 2015-08-17T09:24:14.7800000
- modifyDate: 2015-08-17T09:24:16.4800000
- paymentDate: 2015-06-28T17:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId: 63310475
- customerUsername: sholmes1854@methodsofdetection.com
- customerEmail: sholmes1854@methodsofdetection.com
- billTo:
- name: Sherlock Holmes
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: Sherlock Holmes
- company: ''
- street1: 221 B Baker St
- street2: ''
- street3:
- city: London
- state: ''
- postalCode: NW1 6XE
- country: GB
- phone:
- residential: true
- addressVerified: Address not yet validated
- items:
- - orderItemId: 136282568
- lineItemKey:
- sku: Ele-1234
- name: Elementary Disguise Kit
- imageUrl:
- weight:
- value: 12
- units: ounces
- quantity: 2
- unitPrice: 49.990000000000002
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 1, Bin 7
- options: []
- productId: 11780610
- fulfillmentSku: Ele-1234
- adjustment: false
- upc:
- createDate: 2015-08-17T09:24:14.7800000
- modifyDate: 2015-08-17T09:24:14.7800000
- - orderItemId: 136282569
- lineItemKey:
- sku: CN-9876
- name: Fine White Oak Cane
- imageUrl:
- weight:
- value: 80
- units: ounces
- quantity: 1
- unitPrice: 225
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 7, Bin 34
- options: []
- productId: 11780609
- fulfillmentSku:
- adjustment: false
- upc:
- createDate: 2015-08-17T09:24:14.7800000
- modifyDate: 2015-08-17T09:24:14.7800000
- orderTotal: 387.97000000000003
- amountPaid: 412.97000000000003
- taxAmount: 27.989999999999998
- shippingAmount: 35
- customerNotes: Please be careful when packing the disguise kits in with the cane.
- internalNotes: Mr. Holmes called to upgrade his shipping to expedited
- gift: false
- giftMessage:
- paymentMethod:
- requestedShippingService: Priority Mail Int
- carrierCode: stamps_com
- serviceCode: usps_priority_mail_international
- packageCode: package
- confirmation: delivery
- shipDate: 2015-04-25
- holdUntilDate:
- weight:
- value: 104
- units: ounces
- dimensions:
- units: inches
- length: 40
- width: 7
- height: 5
- insuranceOptions:
- provider:
- insureShipment: false
- insuredValue: 0
- internationalOptions:
- contents: merchandise
- customsItems:
- - customsItemId: 11558268
- description: Fine White Oak Cane
- quantity: 1
- value: 225
- harmonizedTariffCode:
- countryOfOrigin: US
- - customsItemId: 11558267
- description: Elementary Disguise Kit
- quantity: 2
- value: 49.990000000000002
- harmonizedTariffCode:
- countryOfOrigin: US
- nonDelivery: return_to_sender
- advancedOptions:
- warehouseId: 98765
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'SKU: CN-9876 x 1'
- customField2: 'SKU: Ele-123 x 2'
- customField3:
- source:
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- userId:
- externallyFulfilled: false
- externallyFulfilledBy:
- - orderId: 123456789
- orderNumber: TEST-ORDER-API-DOCS
- orderKey: 0f6bec18-9-4771-83aa-f392d84f4c74
- orderDate: 2015-06-29T08:46:27.0000000
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-08-17T09:21:59.4430000
- paymentDate: 2015-06-29T08:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId: 37701499
- customerUsername: headhoncho@whitehouse.gov
- customerEmail: headhoncho@whitehouse.gov
- billTo:
- name: The President
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: The President
- company: US Govt
- street1: 1600 Pennsylvania Ave
- street2: Oval Office
- street3:
- city: Washington
- state: DC
- postalCode: 20500
- country: US
- phone: 555-555-5555
- residential: false
- addressVerified: Address validation warning
- items:
- - orderItemId: 128836912
- lineItemKey: vd08-MSLbtx
- sku: ABC123
- name: 'Test item #1'
- imageUrl:
- weight:
- value: 24
- units: ounces
- quantity: 2
- unitPrice: 99.989999999999995
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 1, Bin 7
- options:
- - name: Size
- value: Large
- productId: 7239919
- fulfillmentSku:
- adjustment: false
- upc:
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-07-16T14:00:34.8230000
- - orderItemId: 128836913
- lineItemKey:
- sku: DISCOUNT CODE
- name: 10% OFF
- imageUrl:
- weight:
- value: 0
- units: ounces
- quantity: 1
- unitPrice: -20.550000000000001
- taxAmount:
- shippingAmount:
- warehouseLocation:
- options: []
- productId:
- fulfillmentSku:
- adjustment: true
- upc:
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-07-16T14:00:34.8230000
- orderTotal: 194.43000000000001
- amountPaid: 218.72999999999999
- taxAmount: 5
- shippingAmount: 10
- customerNotes: Thanks for ordering!
- internalNotes: Customer called and would like to upgrade shipping
- gift: true
- giftMessage: Thank you!
- paymentMethod: Credit Card
- requestedShippingService: Priority Mail
- carrierCode: fedex
- serviceCode: fedex_home_delivery
- packageCode: package
- confirmation: delivery
- shipDate: 2015-07-02
- holdUntilDate:
- weight:
- value: 48
- units: ounces
- dimensions:
- units: inches
- length: 7
- width: 5
- height: 6
- insuranceOptions:
- provider: carrier
- insureShipment: true
- insuredValue: 200
- internationalOptions:
- contents:
- customsItems:
- nonDelivery:
- advancedOptions:
- warehouseId: 98765
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'Custom data that you can add to an order. See Custom Field #2 & #3 for more info!'
- customField2: Per UI settings, this information can appear on some carrier's shipping labels. See link below
- customField3: https://help.shipstation.com/hc/en-us/articles/206639957
- source: Webstore
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- userId:
- externallyFulfilled: false
- externallyFulfilledBy:
- type: array
- items:
- type: object
- total:
- description: ''
- example: 2
- type: integer
- format: int32
- page:
- description: ''
- example: 1
- type: integer
- format: int32
- pages:
- description: ''
- example: 0
- type: integer
- format: int32
- required:
- - orders
- - total
- - page
- - pages
- OrderStatus:
- title: orderStatus
- example: awaiting_payment
- x-enum-elements:
- - name: awaiting_payment
- description: ''
- - name: awaiting_shipment
- description: ''
- - name: pending_fulfillment
- description: ''
- - name: shipped
- description: ''
- - name: on_hold
- description: ''
- - name: cancelled
- description: ''
- type: string
- enum:
- - awaiting_payment
- - awaiting_shipment
- - pending_fulfillment
- - shipped
- - on_hold
- - cancelled
- SortBy33:
- title: sortBy33
- example: OrderDate
- x-enum-elements:
- - name: OrderDate
- description: ''
- - name: ModifyDate
- description: ''
- - name: CreateDate
- description: ''
- type: string
- enum:
- - OrderDate
- - ModifyDate
- - CreateDate
- ListOrdersWithParametersResponse:
- title: List Orders with parameters response
- example:
- orders:
- - orderId: 987654321
- orderNumber: Test-International-API-DOCS
- orderKey: Test-International-API-DOCS
- orderDate: 2015-06-28T17:46:27.0000000
- createDate: 2015-08-17T09:24:14.7800000
- modifyDate: 2015-08-17T09:24:16.4800000
- paymentDate: 2015-06-28T17:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId: 63310475
- customerUsername: sholmes1854@methodsofdetection.com
- customerEmail: sholmes1854@methodsofdetection.com
- billTo:
- name: Sherlock Holmes
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: Sherlock Holmes
- company: ''
- street1: 221 B Baker St
- street2: ''
- street3:
- city: London
- state: ''
- postalCode: NW1 6XE
- country: GB
- phone:
- residential: true
- addressVerified: Address not yet validated
- items:
- - orderItemId: 136282568
- lineItemKey:
- sku: Ele-1234
- name: Elementary Disguise Kit
- imageUrl:
- weight:
- value: 12
- units: ounces
- quantity: 2
- unitPrice: 49.990000000000002
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 1, Bin 7
- options: []
- productId: 11780610
- fulfillmentSku: Ele-1234
- adjustment: false
- upc:
- createDate: 2015-08-17T09:24:14.7800000
- modifyDate: 2015-08-17T09:24:14.7800000
- - orderItemId: 136282569
- lineItemKey:
- sku: CN-9876
- name: Fine White Oak Cane
- imageUrl:
- weight:
- value: 80
- units: ounces
- quantity: 1
- unitPrice: 225
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 7, Bin 34
- options: []
- productId: 11780609
- fulfillmentSku:
- adjustment: false
- upc:
- createDate: 2015-08-17T09:24:14.7800000
- modifyDate: 2015-08-17T09:24:14.7800000
- orderTotal: 387.97000000000003
- amountPaid: 412.97000000000003
- taxAmount: 27.989999999999998
- shippingAmount: 35
- customerNotes: Please be careful when packing the disguise kits in with the cane.
- internalNotes: Mr. Holmes called to upgrade his shipping to expedited
- gift: false
- giftMessage:
- paymentMethod:
- requestedShippingService: Priority Mail Int
- carrierCode: stamps_com
- serviceCode: usps_priority_mail_international
- packageCode: package
- confirmation: delivery
- shipDate: 2015-04-25
- holdUntilDate:
- weight:
- value: 104
- units: ounces
- dimensions:
- units: inches
- length: 40
- width: 7
- height: 5
- insuranceOptions:
- provider:
- insureShipment: false
- insuredValue: 0
- internationalOptions:
- contents: merchandise
- customsItems:
- - customsItemId: 11558268
- description: Fine White Oak Cane
- quantity: 1
- value: 225
- harmonizedTariffCode:
- countryOfOrigin: US
- - customsItemId: 11558267
- description: Elementary Disguise Kit
- quantity: 2
- value: 49.990000000000002
- harmonizedTariffCode:
- countryOfOrigin: US
- nonDelivery: return_to_sender
- advancedOptions:
- warehouseId: 98765
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'SKU: CN-9876 x 1'
- customField2: 'SKU: Ele-123 x 2'
- customField3:
- source:
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- userId:
- externallyFulfilled: false
- externallyFulfilledBy:
- - orderId: 123456789
- orderNumber: TEST-ORDER-API-DOCS
- orderKey: 0f6bec18-9-4771-83aa-f392d84f4c74
- orderDate: 2015-06-29T08:46:27.0000000
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-08-17T09:21:59.4430000
- paymentDate: 2015-06-29T08:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId: 37701499
- customerUsername: headhoncho@whitehouse.gov
- customerEmail: headhoncho@whitehouse.gov
- billTo:
- name: The President
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: The President
- company: US Govt
- street1: 1600 Pennsylvania Ave
- street2: Oval Office
- street3:
- city: Washington
- state: DC
- postalCode: 20500
- country: US
- phone: 555-555-5555
- residential: false
- addressVerified: Address validation warning
- items:
- - orderItemId: 128836912
- lineItemKey: vd08-MSLbtx
- sku: ABC123
- name: 'Test item #1'
- imageUrl:
- weight:
- value: 24
- units: ounces
- quantity: 2
- unitPrice: 99.989999999999995
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 1, Bin 7
- options:
- - name: Size
- value: Large
- productId: 7239919
- fulfillmentSku:
- adjustment: false
- upc:
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-07-16T14:00:34.8230000
- - orderItemId: 128836913
- lineItemKey:
- sku: DISCOUNT CODE
- name: 10% OFF
- imageUrl:
- weight:
- value: 0
- units: ounces
- quantity: 1
- unitPrice: -20.550000000000001
- taxAmount:
- shippingAmount:
- warehouseLocation:
- options: []
- productId:
- fulfillmentSku:
- adjustment: true
- upc:
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-07-16T14:00:34.8230000
- orderTotal: 194.43000000000001
- amountPaid: 218.72999999999999
- taxAmount: 5
- shippingAmount: 10
- customerNotes: Thanks for ordering!
- internalNotes: Customer called and would like to upgrade shipping
- gift: true
- giftMessage: Thank you!
- paymentMethod: Credit Card
- requestedShippingService: Priority Mail
- carrierCode: fedex
- serviceCode: fedex_home_delivery
- packageCode: package
- confirmation: delivery
- shipDate: 2015-07-02
- holdUntilDate:
- weight:
- value: 48
- units: ounces
- dimensions:
- units: inches
- length: 7
- width: 5
- height: 6
- insuranceOptions:
- provider: carrier
- insureShipment: true
- insuredValue: 200
- internationalOptions:
- contents:
- customsItems:
- nonDelivery:
- advancedOptions:
- warehouseId: 98765
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'Custom data that you can add to an order. See Custom Field #2 & #3 for more info!'
- customField2: Per UI settings, this information can appear on some carrier's shipping labels. See link below
- customField3: https://help.shipstation.com/hc/en-us/articles/206639957
- source: Webstore
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- userId:
- externallyFulfilled: false
- externallyFulfilledBy:
- total: 2
- page: 1
- pages: 0
- type: object
- properties:
- orders:
- description: ''
- example:
- - orderId: 987654321
- orderNumber: Test-International-API-DOCS
- orderKey: Test-International-API-DOCS
- orderDate: 2015-06-28T17:46:27.0000000
- createDate: 2015-08-17T09:24:14.7800000
- modifyDate: 2015-08-17T09:24:16.4800000
- paymentDate: 2015-06-28T17:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId: 63310475
- customerUsername: sholmes1854@methodsofdetection.com
- customerEmail: sholmes1854@methodsofdetection.com
- billTo:
- name: Sherlock Holmes
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: Sherlock Holmes
- company: ''
- street1: 221 B Baker St
- street2: ''
- street3:
- city: London
- state: ''
- postalCode: NW1 6XE
- country: GB
- phone:
- residential: true
- addressVerified: Address not yet validated
- items:
- - orderItemId: 136282568
- lineItemKey:
- sku: Ele-1234
- name: Elementary Disguise Kit
- imageUrl:
- weight:
- value: 12
- units: ounces
- quantity: 2
- unitPrice: 49.990000000000002
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 1, Bin 7
- options: []
- productId: 11780610
- fulfillmentSku: Ele-1234
- adjustment: false
- upc:
- createDate: 2015-08-17T09:24:14.7800000
- modifyDate: 2015-08-17T09:24:14.7800000
- - orderItemId: 136282569
- lineItemKey:
- sku: CN-9876
- name: Fine White Oak Cane
- imageUrl:
- weight:
- value: 80
- units: ounces
- quantity: 1
- unitPrice: 225
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 7, Bin 34
- options: []
- productId: 11780609
- fulfillmentSku:
- adjustment: false
- upc:
- createDate: 2015-08-17T09:24:14.7800000
- modifyDate: 2015-08-17T09:24:14.7800000
- orderTotal: 387.97000000000003
- amountPaid: 412.97000000000003
- taxAmount: 27.989999999999998
- shippingAmount: 35
- customerNotes: Please be careful when packing the disguise kits in with the cane.
- internalNotes: Mr. Holmes called to upgrade his shipping to expedited
- gift: false
- giftMessage:
- paymentMethod:
- requestedShippingService: Priority Mail Int
- carrierCode: stamps_com
- serviceCode: usps_priority_mail_international
- packageCode: package
- confirmation: delivery
- shipDate: 2015-04-25
- holdUntilDate:
- weight:
- value: 104
- units: ounces
- dimensions:
- units: inches
- length: 40
- width: 7
- height: 5
- insuranceOptions:
- provider:
- insureShipment: false
- insuredValue: 0
- internationalOptions:
- contents: merchandise
- customsItems:
- - customsItemId: 11558268
- description: Fine White Oak Cane
- quantity: 1
- value: 225
- harmonizedTariffCode:
- countryOfOrigin: US
- - customsItemId: 11558267
- description: Elementary Disguise Kit
- quantity: 2
- value: 49.990000000000002
- harmonizedTariffCode:
- countryOfOrigin: US
- nonDelivery: return_to_sender
- advancedOptions:
- warehouseId: 98765
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'SKU: CN-9876 x 1'
- customField2: 'SKU: Ele-123 x 2'
- customField3:
- source:
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- userId:
- externallyFulfilled: false
- externallyFulfilledBy:
- - orderId: 123456789
- orderNumber: TEST-ORDER-API-DOCS
- orderKey: 0f6bec18-9-4771-83aa-f392d84f4c74
- orderDate: 2015-06-29T08:46:27.0000000
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-08-17T09:21:59.4430000
- paymentDate: 2015-06-29T08:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId: 37701499
- customerUsername: headhoncho@whitehouse.gov
- customerEmail: headhoncho@whitehouse.gov
- billTo:
- name: The President
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: The President
- company: US Govt
- street1: 1600 Pennsylvania Ave
- street2: Oval Office
- street3:
- city: Washington
- state: DC
- postalCode: 20500
- country: US
- phone: 555-555-5555
- residential: false
- addressVerified: Address validation warning
- items:
- - orderItemId: 128836912
- lineItemKey: vd08-MSLbtx
- sku: ABC123
- name: 'Test item #1'
- imageUrl:
- weight:
- value: 24
- units: ounces
- quantity: 2
- unitPrice: 99.989999999999995
- taxAmount:
- shippingAmount:
- warehouseLocation: Aisle 1, Bin 7
- options:
- - name: Size
- value: Large
- productId: 7239919
- fulfillmentSku:
- adjustment: false
- upc:
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-07-16T14:00:34.8230000
- - orderItemId: 128836913
- lineItemKey:
- sku: DISCOUNT CODE
- name: 10% OFF
- imageUrl:
- weight:
- value: 0
- units: ounces
- quantity: 1
- unitPrice: -20.550000000000001
- taxAmount:
- shippingAmount:
- warehouseLocation:
- options: []
- productId:
- fulfillmentSku:
- adjustment: true
- upc:
- createDate: 2015-07-16T14:00:34.8230000
- modifyDate: 2015-07-16T14:00:34.8230000
- orderTotal: 194.43000000000001
- amountPaid: 218.72999999999999
- taxAmount: 5
- shippingAmount: 10
- customerNotes: Thanks for ordering!
- internalNotes: Customer called and would like to upgrade shipping
- gift: true
- giftMessage: Thank you!
- paymentMethod: Credit Card
- requestedShippingService: Priority Mail
- carrierCode: fedex
- serviceCode: fedex_home_delivery
- packageCode: package
- confirmation: delivery
- shipDate: 2015-07-02
- holdUntilDate:
- weight:
- value: 48
- units: ounces
- dimensions:
- units: inches
- length: 7
- width: 5
- height: 6
- insuranceOptions:
- provider: carrier
- insureShipment: true
- insuredValue: 200
- internationalOptions:
- contents:
- customsItems:
- nonDelivery:
- advancedOptions:
- warehouseId: 98765
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'Custom data that you can add to an order. See Custom Field #2 & #3 for more info!'
- customField2: Per UI settings, this information can appear on some carrier's shipping labels. See link below
- customField3: https://help.shipstation.com/hc/en-us/articles/206639957
- source: Webstore
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- userId:
- externallyFulfilled: false
- externallyFulfilledBy:
- type: array
- items:
- type: object
- total:
- description: ''
- example: 2
- type: integer
- format: int32
- page:
- description: ''
- example: 1
- type: integer
- format: int32
- pages:
- description: ''
- example: 0
- type: integer
- format: int32
- required:
- - orders
- - total
- - page
- - pages
- ListOrdersByTagResponse:
- title: List Orders by Tag response
- example:
- orders:
- - orderId: 123456789
- orderNumber: TEST-ORDER-API-DOCS
- orderKey: 0f6bec18-3e89-4881-83aa-f392d84f4c74
- orderDate: 2015-06-29T08:46:27.0000000
- createDate: 2015-08-17T09:43:03.0500000
- modifyDate: 2015-08-17T09:43:12.5500000
- paymentDate: 2015-06-29T08:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId: 37701499
- customerUsername: headhoncho@whitehouse.gov
- customerEmail: headhoncho@whitehouse.gov
- billTo:
- name: The President
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: The President
- company: US Govt
- street1: 1600 Pennsylvania Ave
- street2: Oval Office
- street3:
- city: Washington
- state: DC
- postalCode: 20500
- country: US
- phone: 555-555-5555
- residential: false
- addressVerified: Address validation warning
- items:
- - orderItemId: 136289188
- lineItemKey: vd08-MSLbtx
- sku: ABC123
- name: 'Test item #1'
- imageUrl:
- weight:
- value: 24
- units: ounces
- quantity: 2
- unitPrice: 99.989999999999995
- taxAmount: 2.5
- shippingAmount: 5
- warehouseLocation: Aisle 1, Bin 7
- options:
- - name: Size
- value: Large
- productId: 7239919
- fulfillmentSku:
- adjustment: false
- upc: 32-65-98
- createDate: 2015-08-17T09:43:03.0500000
- modifyDate: 2015-08-17T09:43:03.0500000
- - orderItemId: 136289189
- lineItemKey:
- sku: DISCOUNT CODE
- name: 10% OFF
- imageUrl:
- weight:
- value: 0
- units: ounces
- quantity: 1
- unitPrice: -20.550000000000001
- taxAmount:
- shippingAmount:
- warehouseLocation:
- options: []
- productId:
- fulfillmentSku: SKU-Discount
- adjustment: true
- upc:
- createDate: 2015-08-17T09:43:03.0500000
- modifyDate: 2015-08-17T09:43:03.0500000
- orderTotal: 194.43000000000001
- amountPaid: 218.72999999999999
- taxAmount: 5
- shippingAmount: 10
- customerNotes: Thanks for ordering!
- internalNotes: Customer called and would like to upgrade shipping
- gift: true
- giftMessage: Thank you!
- paymentMethod: Credit Card
- requestedShippingService: Priority Mail
- carrierCode: fedex
- serviceCode: fedex_2day
- packageCode: package
- confirmation: delivery
- shipDate: 2015-07-02
- holdUntilDate:
- weight:
- value: 48
- units: ounces
- dimensions:
- units: inches
- length: 7
- width: 5
- height: 6
- insuranceOptions:
- provider: carrier
- insureShipment: true
- insuredValue: 200
- internationalOptions:
- contents:
- customsItems:
- nonDelivery:
- advancedOptions:
- warehouseId: 98765
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'Custom data that you can add to an order. See Custom Field #2 & #3 for more info!'
- customField2: Per UI settings, this information can appear on some carrier's shipping labels. See link below
- customField3: https://help.shipstation.com/hc/en-us/articles/206639957
- source: Webstore
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- - 831
- userId: b854f701-e0c2-4156-90fe-19c77cdef27c
- externallyFulfilled: false
- externallyFulfilledBy:
- total: 1
- page: 1
- pages: 1
- type: object
- properties:
- orders:
- description: ''
- example:
- - orderId: 123456789
- orderNumber: TEST-ORDER-API-DOCS
- orderKey: 0f6bec18-3e89-4881-83aa-f392d84f4c74
- orderDate: 2015-06-29T08:46:27.0000000
- createDate: 2015-08-17T09:43:03.0500000
- modifyDate: 2015-08-17T09:43:12.5500000
- paymentDate: 2015-06-29T08:46:27.0000000
- shipByDate: 2015-07-05T00:00:00.0000000
- orderStatus: awaiting_shipment
- customerId: 37701499
- customerUsername: headhoncho@whitehouse.gov
- customerEmail: headhoncho@whitehouse.gov
- billTo:
- name: The President
- company:
- street1:
- street2:
- street3:
- city:
- state:
- postalCode:
- country:
- phone:
- residential:
- addressVerified:
- shipTo:
- name: The President
- company: US Govt
- street1: 1600 Pennsylvania Ave
- street2: Oval Office
- street3:
- city: Washington
- state: DC
- postalCode: 20500
- country: US
- phone: 555-555-5555
- residential: false
- addressVerified: Address validation warning
- items:
- - orderItemId: 136289188
- lineItemKey: vd08-MSLbtx
- sku: ABC123
- name: 'Test item #1'
- imageUrl:
- weight:
- value: 24
- units: ounces
- quantity: 2
- unitPrice: 99.989999999999995
- taxAmount: 2.5
- shippingAmount: 5
- warehouseLocation: Aisle 1, Bin 7
- options:
- - name: Size
- value: Large
- productId: 7239919
- fulfillmentSku:
- adjustment: false
- upc: 32-65-98
- createDate: 2015-08-17T09:43:03.0500000
- modifyDate: 2015-08-17T09:43:03.0500000
- - orderItemId: 136289189
- lineItemKey:
- sku: DISCOUNT CODE
- name: 10% OFF
- imageUrl:
- weight:
- value: 0
- units: ounces
- quantity: 1
- unitPrice: -20.550000000000001
- taxAmount:
- shippingAmount:
- warehouseLocation:
- options: []
- productId:
- fulfillmentSku: SKU-Discount
- adjustment: true
- upc:
- createDate: 2015-08-17T09:43:03.0500000
- modifyDate: 2015-08-17T09:43:03.0500000
- orderTotal: 194.43000000000001
- amountPaid: 218.72999999999999
- taxAmount: 5
- shippingAmount: 10
- customerNotes: Thanks for ordering!
- internalNotes: Customer called and would like to upgrade shipping
- gift: true
- giftMessage: Thank you!
- paymentMethod: Credit Card
- requestedShippingService: Priority Mail
- carrierCode: fedex
- serviceCode: fedex_2day
- packageCode: package
- confirmation: delivery
- shipDate: 2015-07-02
- holdUntilDate:
- weight:
- value: 48
- units: ounces
- dimensions:
- units: inches
- length: 7
- width: 5
- height: 6
- insuranceOptions:
- provider: carrier
- insureShipment: true
- insuredValue: 200
- internationalOptions:
- contents:
- customsItems:
- nonDelivery:
- advancedOptions:
- warehouseId: 98765
- nonMachinable: false
- saturdayDelivery: false
- containsAlcohol: false
- mergedOrSplit: false
- mergedIds: []
- parentId:
- storeId: 12345
- customField1: 'Custom data that you can add to an order. See Custom Field #2 & #3 for more info!'
- customField2: Per UI settings, this information can appear on some carrier's shipping labels. See link below
- customField3: https://help.shipstation.com/hc/en-us/articles/206639957
- source: Webstore
- billToParty:
- billToAccount:
- billToPostalCode:
- billToCountryCode:
- tagIds:
- - 831
- userId: b854f701-e0c2-4156-90fe-19c77cdef27c
- externallyFulfilled: false
- externallyFulfilledBy:
- type: array
- items:
- type: object
- total:
- description: ''
- example: 1
- type: integer
- format: int32
- page:
- description: ''
- example: 1
- type: integer
- format: int32
- pages:
- description: ''
- example: 1
- type: integer
- format: int32
- required:
- - orders
- - total
- - page
- - pages
- MarkAnOrderAsShippedRequest:
- title: Mark an Order as Shipped request
- type: object
- properties:
- orderId:
- description: ''
- example: 93348442
- type: integer
- format: int32
- carrierCode:
- description: ''
- example: usps
- type: string
- shipDate:
- description: ''
- example: 2014-04-01
- type: string
- trackingNumber:
- description: ''
- example: 913492493294329421
- type: string
- notifyCustomer:
- description: ''
- example: true
- type: boolean
- notifySalesChannel:
- description: ''
- example: true
- type: boolean
- required:
- - orderId
- - carrierCode
- - shipDate
- - trackingNumber
- - notifyCustomer
- - notifySalesChannel
- MarkAnOrderAsShippedResponse:
- title: Mark an Order as Shipped response
- example:
- orderId: 123456789
- orderNumber: ABC123
- type: object
- properties:
- orderId:
- description: ''
- example: 123456789
- type: integer
- format: int32
- orderNumber:
- description: ''
- example: ABC123
- type: string
- required:
- - orderId
- - orderNumber
- RemoveTagFromOrderRequest:
- title: Remove Tag from Order request
- type: object
- properties:
- orderId:
- description: ''
- example: 123456
- type: integer
- format: int32
- tagId:
- description: ''
- example: 1234
- type: integer
- format: int32
- required:
- - orderId
- - tagId
- RemoveTagFromOrderResponse:
- title: Remove Tag from Order response
- example:
- success: true
- message: Tag removed successfully.
- type: object
- properties:
- success:
- description: ''
- example: true
- type: boolean
- message:
- description: ''
- example: Tag removed successfully.
- type: string
- required:
- - success
- - message
- RestoreOrderFromOnHoldRequest:
- title: Restore Order from On Hold request
- type: object
- properties:
- orderId:
- description: ''
- example: 1234567
- type: integer
- format: int32
- required:
- - orderId
- RestoreOrderFromOnHoldResponse:
- title: Restore Order from On Hold response
- example:
- success: true
- message: The requested order has been restored
- type: object
- properties:
- success:
- description: ''
- example: true
- type: boolean
- message:
- description: ''
- example: The requested order has been restored
- type: string
- required:
- - success
- - message
- UnassignUserFromOrderRequest:
- title: Unassign User from Order request
- type: object
- properties:
- orderIds:
- description: ''
- example:
- - 123456789
- - 12345679
- type: array
- items:
- type: integer
- format: int32
- required:
- - orderIds
- UnassignUserFromOrderResponse:
- title: Unassign User from Order response
- example:
- success: true
- message: User unassigned successfully.
- type: object
- properties:
- success:
- description: ''
- example: true
- type: boolean
- message:
- description: ''
- example: User unassigned successfully.
- type: string
- required:
- - success
- - message
- GetProductResponse:
- title: Get Product response
- example:
- aliases:
- productId: 12345678
- sku: 1004
- name: Coffee Mug
- price: 26
- defaultCost: 0
- length: 3
- width: 3
- height: 3
- weightOz: 26
- internalNotes:
- fulfillmentSku: F1004
- createDate: 2014-09-04T09:18:01.2930000
- modifyDate: 2014-09-18T12:38:43.8930000
- active: true
- productCategory:
- categoryId: 9999
- name: Door Closers
- productType:
- warehouseLocation: Bin 22
- defaultCarrierCode: fedex
- defaultServiceCode: fedex_home_delivery
- defaultPackageCode: package
- defaultIntlCarrierCode: ups
- defaultIntlServiceCode: ups_worldwide_saver
- defaultIntlPackageCode: package
- defaultConfirmation: direct_signature
- defaultIntlConfirmation: adult_signature
- customsDescription:
- customsValue:
- customsTariffNo:
- customsCountryCode:
- noCustoms:
- tags:
- - tagId: 9180
- name: APItest
- type: object
- properties:
- aliases:
- description: ''
- type: string
- productId:
- description: ''
- example: 12345678
- type: integer
- format: int32
- sku:
- description: ''
- example: 1004
- type: string
- name:
- description: ''
- example: Coffee Mug
- type: string
- price:
- description: ''
- example: 26
- type: integer
- format: int32
- defaultCost:
- description: ''
- example: 0
- type: integer
- format: int32
- length:
- description: ''
- example: 3
- type: integer
- format: int32
- width:
- description: ''
- example: 3
- type: integer
- format: int32
- height:
- description: ''
- example: 3
- type: integer
- format: int32
- weightOz:
- description: ''
- example: 26
- type: integer
- format: int32
- internalNotes:
- description: ''
- type: string
- fulfillmentSku:
- description: ''
- example: F1004
- type: string
- createDate:
- description: ''
- example: 9/4/2014 9:18:01 AM
- type: string
- modifyDate:
- description: ''
- example: 9/18/2014 12:38:43 PM
- type: string
- active:
- description: ''
- example: true
- type: boolean
- productCategory:
- description: ''
- example:
- categoryId: 9999
- name: Door Closers
- type: object
- productType:
- description: ''
- type: string
- warehouseLocation:
- description: ''
- example: Bin 22
- type: string
- defaultCarrierCode:
- description: ''
- example: fedex
- type: string
- defaultServiceCode:
- description: ''
- example: fedex_home_delivery
- type: string
- defaultPackageCode:
- description: ''
- example: package
- type: string
- defaultIntlCarrierCode:
- description: ''
- example: ups
- type: string
- defaultIntlServiceCode:
- description: ''
- example: ups_worldwide_saver
- type: string
- defaultIntlPackageCode:
- description: ''
- example: package
- type: string
- defaultConfirmation:
- description: ''
- example: direct_signature
- type: string
- defaultIntlConfirmation:
- description: ''
- example: adult_signature
- type: string
- customsDescription:
- description: ''
- type: string
- customsValue:
- description: ''
- type: string
- customsTariffNo:
- description: ''
- type: string
- customsCountryCode:
- description: ''
- type: string
- noCustoms:
- description: ''
- type: string
- tags:
- description: ''
- example:
- - tagId: 9180
- name: APItest
- type: array
- items:
- type: object
- required:
- - aliases
- - productId
- - sku
- - name
- - price
- - defaultCost
- - length
- - width
- - height
- - weightOz
- - internalNotes
- - fulfillmentSku
- - createDate
- - modifyDate
- - active
- - productCategory
- - productType
- - warehouseLocation
- - defaultCarrierCode
- - defaultServiceCode
- - defaultPackageCode
- - defaultIntlCarrierCode
- - defaultIntlServiceCode
- - defaultIntlPackageCode
- - defaultConfirmation
- - defaultIntlConfirmation
- - customsDescription
- - customsValue
- - customsTariffNo
- - customsCountryCode
- - noCustoms
- - tags
- UpdateProductRequest:
- title: Update Product request
- type: object
- properties:
- aliases:
- description: ''
- type: string
- productId:
- description: ''
- example: 123456789
- type: integer
- format: int32
- sku:
- description: ''
- type: string
- name:
- description: ''
- example: Beautiful
- type: string
- price:
- description: ''
- example: 0
- type: integer
- format: int32
- defaultCost:
- description: ''
- type: string
- length:
- description: ''
- type: string
- width:
- description: ''
- type: string
- height:
- description: ''
- type: string
- weightOz:
- description: ''
- type: string
- internalNotes:
- description: ''
- type: string
- fulfillmentSku:
- description: ''
- type: string
- active:
- description: ''
- example: true
- type: boolean
- productCategory:
- description: ''
- type: string
- productType:
- description: ''
- type: string
- warehouseLocation:
- description: ''
- type: string
- defaultCarrierCode:
- description: ''
- type: string
- defaultServiceCode:
- description: ''
- type: string
- defaultPackageCode:
- description: ''
- type: string
- defaultIntlCarrierCode:
- description: ''
- type: string
- defaultIntlServiceCode:
- description: ''
- type: string
- defaultIntlPackageCode:
- description: ''
- type: string
- defaultConfirmation:
- description: ''
- type: string
- defaultIntlConfirmation:
- description: ''
- type: string
- customsDescription:
- description: ''
- type: string
- customsValue:
- description: ''
- type: string
- customsTariffNo:
- description: ''
- type: string
- customsCountryCode:
- description: ''
- type: string
- noCustoms:
- description: ''
- type: string
- tags:
- description: ''
- type: string
- required:
- - aliases
- - productId
- - sku
- - name
- - price
- - defaultCost
- - length
- - width
- - height
- - weightOz
- - internalNotes
- - fulfillmentSku
- - active
- - productCategory
- - productType
- - warehouseLocation
- - defaultCarrierCode
- - defaultServiceCode
- - defaultPackageCode
- - defaultIntlCarrierCode
- - defaultIntlServiceCode
- - defaultIntlPackageCode
- - defaultConfirmation
- - defaultIntlConfirmation
- - customsDescription
- - customsValue
- - customsTariffNo
- - customsCountryCode
- - noCustoms
- - tags
- UpdateProductResponse:
- title: Update Product response
- example:
- success: true
- message: The requested product has been updated
- type: object
- properties:
- success:
- description: ''
- example: true
- type: boolean
- message:
- description: ''
- example: The requested product has been updated
- type: string
- required:
- - success
- - message
- ListProductsW/oParametersResponse:
- title: List Products w/o parameters response
- example:
- products:
- - aliases:
- productId: 7854008
- sku: 1004
- name: Coffee Mug
- price: 26
- defaultCost: 0
- length: 3
- width: 3
- height: 3
- weightOz: 26
- internalNotes:
- fulfillmentSku: F1004
- createDate: 2014-09-04T09:18:01.2930000
- modifyDate: 2014-09-18T12:38:43.8930000
- active: true
- productCategory:
- categoryId: 9999
- name: Door Closers
- productType:
- warehouseLocation: Bin 22
- defaultCarrierCode: fedex
- defaultServiceCode: fedex_home_delivery
- defaultPackageCode: package
- defaultIntlCarrierCode: ups
- defaultIntlServiceCode: ups_worldwide_saver
- defaultIntlPackageCode: package
- defaultConfirmation: direct_signature
- defaultIntlConfirmation: adult_signature
- customsDescription:
- customsValue:
- customsTariffNo:
- customsCountryCode:
- noCustoms:
- tags:
- - tagId: 9180
- name: APItest
- - aliases:
- productId: 7984482
- sku: FirstSKU
- name: Product Name 123
- price: 10
- defaultCost:
- length: 2
- width: 3
- height: 4
- weightOz: 96
- internalNotes:
- fulfillmentSku: fSkuFill
- createDate: 2014-09-18T08:17:28.6470000
- modifyDate: 2014-09-18T12:32:40.2570000
- active: true
- productCategory:
- categoryId: 9690
- name: Floor Matting
- productType:
- warehouseLocation: Bin 100
- defaultCarrierCode: ups
- defaultServiceCode: ups_ground
- defaultPackageCode: package
- defaultIntlCarrierCode:
- defaultIntlServiceCode:
- defaultIntlPackageCode: package
- defaultConfirmation: delivery
- defaultIntlConfirmation:
- customsDescription: customs declaration
- customsValue: 100
- customsTariffNo: 1234567
- customsCountryCode: US
- noCustoms:
- tags:
- - tagId: 9180
- name: APItest
- total: 2
- page: 1
- pages: 0
- type: object
- properties:
- products:
- description: ''
- example:
- - aliases:
- productId: 7854008
- sku: 1004
- name: Coffee Mug
- price: 26
- defaultCost: 0
- length: 3
- width: 3
- height: 3
- weightOz: 26
- internalNotes:
- fulfillmentSku: F1004
- createDate: 2014-09-04T09:18:01.2930000
- modifyDate: 2014-09-18T12:38:43.8930000
- active: true
- productCategory:
- categoryId: 9999
- name: Door Closers
- productType:
- warehouseLocation: Bin 22
- defaultCarrierCode: fedex
- defaultServiceCode: fedex_home_delivery
- defaultPackageCode: package
- defaultIntlCarrierCode: ups
- defaultIntlServiceCode: ups_worldwide_saver
- defaultIntlPackageCode: package
- defaultConfirmation: direct_signature
- defaultIntlConfirmation: adult_signature
- customsDescription:
- customsValue:
- customsTariffNo:
- customsCountryCode:
- noCustoms:
- tags:
- - tagId: 9180
- name: APItest
- - aliases:
- productId: 7984482
- sku: FirstSKU
- name: Product Name 123
- price: 10
- defaultCost:
- length: 2
- width: 3
- height: 4
- weightOz: 96
- internalNotes:
- fulfillmentSku: fSkuFill
- createDate: 2014-09-18T08:17:28.6470000
- modifyDate: 2014-09-18T12:32:40.2570000
- active: true
- productCategory:
- categoryId: 9690
- name: Floor Matting
- productType:
- warehouseLocation: Bin 100
- defaultCarrierCode: ups
- defaultServiceCode: ups_ground
- defaultPackageCode: package
- defaultIntlCarrierCode:
- defaultIntlServiceCode:
- defaultIntlPackageCode: package
- defaultConfirmation: delivery
- defaultIntlConfirmation:
- customsDescription: customs declaration
- customsValue: 100
- customsTariffNo: 1234567
- customsCountryCode: US
- noCustoms:
- tags:
- - tagId: 9180
- name: APItest
- type: array
- items:
- type: object
- total:
- description: ''
- example: 2
- type: integer
- format: int32
- page:
- description: ''
- example: 1
- type: integer
- format: int32
- pages:
- description: ''
- example: 0
- type: integer
- format: int32
- required:
- - products
- - total
- - page
- - pages
- SortBy50:
- title: sortBy50
- example: SKU
- x-enum-elements:
- - name: SKU
- description: ''
- - name: ModifyDate
- description: ''
- - name: CreateDate
- description: ''
- type: string
- enum:
- - SKU
- - ModifyDate
- - CreateDate
- ListProductsWithParametersResponse:
- title: List Products with parameters response
- example:
- products:
- - aliases:
- productId: 7854008
- sku: 1004
- name: Coffee Mug
- price: 26
- defaultCost: 0
- length: 3
- width: 3
- height: 3
- weightOz: 26
- internalNotes:
- fulfillmentSku: F1004
- createDate: 2014-09-04T09:18:01.2930000
- modifyDate: 2014-09-18T12:38:43.8930000
- active: true
- productCategory:
- categoryId: 9999
- name: Door Closers
- productType:
- warehouseLocation: Bin 22
- defaultCarrierCode: fedex
- defaultServiceCode: fedex_home_delivery
- defaultPackageCode: package
- defaultIntlCarrierCode: ups
- defaultIntlServiceCode: ups_worldwide_saver
- defaultIntlPackageCode: package
- defaultConfirmation: direct_signature
- defaultIntlConfirmation: adult_signature
- customsDescription:
- customsValue:
- customsTariffNo:
- customsCountryCode:
- noCustoms:
- tags:
- - tagId: 9180
- name: APItest
- - aliases:
- productId: 7984482
- sku: FirstSKU
- name: Product Name 123
- price: 10
- defaultCost:
- length: 2
- width: 3
- height: 4
- weightOz: 96
- internalNotes:
- fulfillmentSku: fSkuFill
- createDate: 2014-09-18T08:17:28.6470000
- modifyDate: 2014-09-18T12:32:40.2570000
- active: true
- productCategory:
- categoryId: 9690
- name: Floor Matting
- productType:
- warehouseLocation: Bin 100
- defaultCarrierCode: ups
- defaultServiceCode: ups_ground
- defaultPackageCode: package
- defaultIntlCarrierCode:
- defaultIntlServiceCode:
- defaultIntlPackageCode: package
- defaultConfirmation: delivery
- defaultIntlConfirmation:
- customsDescription: customs declaration
- customsValue: 100
- customsTariffNo: 1234567
- customsCountryCode: US
- noCustoms:
- tags:
- - tagId: 9180
- name: APItest
- total: 2
- page: 1
- pages: 0
- type: object
- properties:
- products:
- description: ''
- example:
- - aliases:
- productId: 7854008
- sku: 1004
- name: Coffee Mug
- price: 26
- defaultCost: 0
- length: 3
- width: 3
- height: 3
- weightOz: 26
- internalNotes:
- fulfillmentSku: F1004
- createDate: 2014-09-04T09:18:01.2930000
- modifyDate: 2014-09-18T12:38:43.8930000
- active: true
- productCategory:
- categoryId: 9999
- name: Door Closers
- productType:
- warehouseLocation: Bin 22
- defaultCarrierCode: fedex
- defaultServiceCode: fedex_home_delivery
- defaultPackageCode: package
- defaultIntlCarrierCode: ups
- defaultIntlServiceCode: ups_worldwide_saver
- defaultIntlPackageCode: package
- defaultConfirmation: direct_signature
- defaultIntlConfirmation: adult_signature
- customsDescription:
- customsValue:
- customsTariffNo:
- customsCountryCode:
- noCustoms:
- tags:
- - tagId: 9180
- name: APItest
- - aliases:
- productId: 7984482
- sku: FirstSKU
- name: Product Name 123
- price: 10
- defaultCost:
- length: 2
- width: 3
- height: 4
- weightOz: 96
- internalNotes:
- fulfillmentSku: fSkuFill
- createDate: 2014-09-18T08:17:28.6470000
- modifyDate: 2014-09-18T12:32:40.2570000
- active: true
- productCategory:
- categoryId: 9690
- name: Floor Matting
- productType:
- warehouseLocation: Bin 100
- defaultCarrierCode: ups
- defaultServiceCode: ups_ground
- defaultPackageCode: package
- defaultIntlCarrierCode:
- defaultIntlServiceCode:
- defaultIntlPackageCode: package
- defaultConfirmation: delivery
- defaultIntlConfirmation:
- customsDescription: customs declaration
- customsValue: 100
- customsTariffNo: 1234567
- customsCountryCode: US
- noCustoms:
- tags:
- - tagId: 9180
- name: APItest
- type: array
- items:
- type: object
- total:
- description: ''
- example: 2
- type: integer
- format: int32
- page:
- description: ''
- example: 1
- type: integer
- format: int32
- pages:
- description: ''
- example: 0
- type: integer
- format: int32
- required:
- - products
- - total
- - page
- - pages
- ListShipmentsW/oParametersResponse:
- title: List Shipments w/o parameters response
- example:
- shipments:
- - shipmentId: 33974374
- orderId: 43945660
- userId: 123456AB-ab12-3c4d-5e67-89f1abc1defa
- orderNumber: 100038-1
- createDate: 2014-10-03T06:51:33.6270000
- shipDate: 2014-10-03
- shipmentCost: 1.9299999999999999
- insuranceCost: 0
- trackingNumber: 9400111899561704681189
- isReturnLabel: false
- batchNumber: 100301
- carrierCode: stamps_com
- serviceCode: usps_first_class_mail
- packageCode: package
- confirmation: delivery
- warehouseId: 16079
- voided: false
- voidDate:
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Yoda
- company: ''
- street1: 12223 LOWDEN LN
- street2: ''
- street3:
- city: MANCHACA
- state: TX
- postalCode: 78652-3602
- country: US
- phone: 2101235544
- residential:
- weight:
- value: 1
- units: ounces
- dimensions:
- insuranceOptions:
- provider:
- insureShipment: false
- insuredValue: 0
- advancedOptions:
- shipmentItems:
- - orderItemId: 56568665
- lineItemKey:
- sku: SQ3785739
- name: Potato Kitten -
- imageUrl:
- weight:
- quantity: 1
- unitPrice: 1
- warehouseLocation:
- options:
- productId: 7565777
- fulfillmentSku:
- labelData:
- formData:
- - shipmentId: 33974373
- orderId: 43337328
- userId: 123456AB-ab12-3c4d-5e67-89f1abc1defa
- orderNumber: 100028
- createDate: 2014-10-03T06:51:59.9430000
- shipDate: 2014-10-03
- shipmentCost: 1.9299999999999999
- insuranceCost: 0
- trackingNumber: 9400111899561704681196
- isReturnLabel: false
- batchNumber: 100300
- carrierCode: stamps_com
- serviceCode: usps_first_class_mail
- packageCode: package
- confirmation: delivery
- warehouseId: 14265
- voided: false
- voidDate:
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Luke Skywalker
- company: SS
- street1: 2815 EXPOSITION BLVD
- street2: ''
- street3:
- city: AUSTIN
- state: TX
- postalCode: 78703-1221
- country: US
- phone: ''
- residential:
- weight:
- value: 1
- units: ounces
- dimensions:
- insuranceOptions:
- provider:
- insureShipment: false
- insuredValue: 0
- advancedOptions:
- shipmentItems:
- - orderItemId: 55827278
- lineItemKey:
- sku: test
- name: test
- imageUrl:
- weight:
- quantity: 1
- unitPrice: 1
- warehouseLocation:
- options:
- productId: 7541107
- fulfillmentSku:
- labelData:
- formData:
- total: 2
- page: 1
- pages: 0
- type: object
- properties:
- shipments:
- description: ''
- example:
- - shipmentId: 33974374
- orderId: 43945660
- userId: 123456AB-ab12-3c4d-5e67-89f1abc1defa
- orderNumber: 100038-1
- createDate: 2014-10-03T06:51:33.6270000
- shipDate: 2014-10-03
- shipmentCost: 1.9299999999999999
- insuranceCost: 0
- trackingNumber: 9400111899561704681189
- isReturnLabel: false
- batchNumber: 100301
- carrierCode: stamps_com
- serviceCode: usps_first_class_mail
- packageCode: package
- confirmation: delivery
- warehouseId: 16079
- voided: false
- voidDate:
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Yoda
- company: ''
- street1: 12223 LOWDEN LN
- street2: ''
- street3:
- city: MANCHACA
- state: TX
- postalCode: 78652-3602
- country: US
- phone: 2101235544
- residential:
- weight:
- value: 1
- units: ounces
- dimensions:
- insuranceOptions:
- provider:
- insureShipment: false
- insuredValue: 0
- advancedOptions:
- shipmentItems:
- - orderItemId: 56568665
- lineItemKey:
- sku: SQ3785739
- name: Potato Kitten -
- imageUrl:
- weight:
- quantity: 1
- unitPrice: 1
- warehouseLocation:
- options:
- productId: 7565777
- fulfillmentSku:
- labelData:
- formData:
- - shipmentId: 33974373
- orderId: 43337328
- userId: 123456AB-ab12-3c4d-5e67-89f1abc1defa
- orderNumber: 100028
- createDate: 2014-10-03T06:51:59.9430000
- shipDate: 2014-10-03
- shipmentCost: 1.9299999999999999
- insuranceCost: 0
- trackingNumber: 9400111899561704681196
- isReturnLabel: false
- batchNumber: 100300
- carrierCode: stamps_com
- serviceCode: usps_first_class_mail
- packageCode: package
- confirmation: delivery
- warehouseId: 14265
- voided: false
- voidDate:
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Luke Skywalker
- company: SS
- street1: 2815 EXPOSITION BLVD
- street2: ''
- street3:
- city: AUSTIN
- state: TX
- postalCode: 78703-1221
- country: US
- phone: ''
- residential:
- weight:
- value: 1
- units: ounces
- dimensions:
- insuranceOptions:
- provider:
- insureShipment: false
- insuredValue: 0
- advancedOptions:
- shipmentItems:
- - orderItemId: 55827278
- lineItemKey:
- sku: test
- name: test
- imageUrl:
- weight:
- quantity: 1
- unitPrice: 1
- warehouseLocation:
- options:
- productId: 7541107
- fulfillmentSku:
- labelData:
- formData:
- type: array
- items:
- type: object
- total:
- description: ''
- example: 2
- type: integer
- format: int32
- page:
- description: ''
- example: 1
- type: integer
- format: int32
- pages:
- description: ''
- example: 0
- type: integer
- format: int32
- required:
- - shipments
- - total
- - page
- - pages
- ListShipmentsWithParametersResponse:
- title: List Shipments with parameters response
- example:
- shipments:
- - shipmentId: 33974374
- orderId: 43945660
- userId: 123456AB-ab12-3c4d-5e67-89f1abc1defa
- orderNumber: 100038-1
- createDate: 2014-10-03T06:51:33.6270000
- shipDate: 2014-10-03
- shipmentCost: 1.9299999999999999
- insuranceCost: 0
- trackingNumber: 9400111899561704681189
- isReturnLabel: false
- batchNumber: 100301
- carrierCode: stamps_com
- serviceCode: usps_first_class_mail
- packageCode: package
- confirmation: delivery
- warehouseId: 16079
- voided: false
- voidDate:
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Yoda
- company: ''
- street1: 12223 LOWDEN LN
- street2: ''
- street3:
- city: MANCHACA
- state: TX
- postalCode: 78652-3602
- country: US
- phone: 2101235544
- residential:
- weight:
- value: 1
- units: ounces
- dimensions:
- insuranceOptions:
- provider:
- insureShipment: false
- insuredValue: 0
- advancedOptions:
- shipmentItems:
- - orderItemId: 56568665
- lineItemKey:
- sku: SQ3785739
- name: Potato Kitten -
- imageUrl:
- weight:
- quantity: 1
- unitPrice: 1
- warehouseLocation:
- options:
- productId: 7565777
- fulfillmentSku:
- labelData:
- formData:
- - shipmentId: 33974373
- orderId: 43337328
- userId: 123456AB-ab12-3c4d-5e67-89f1abc1defa
- orderNumber: 100028
- createDate: 2014-10-03T06:51:59.9430000
- shipDate: 2014-10-03
- shipmentCost: 1.9299999999999999
- insuranceCost: 0
- trackingNumber: 9400111899561704681196
- isReturnLabel: false
- batchNumber: 100300
- carrierCode: stamps_com
- serviceCode: usps_first_class_mail
- packageCode: package
- confirmation: delivery
- warehouseId: 14265
- voided: false
- voidDate:
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Luke Skywalker
- company: SS
- street1: 2815 EXPOSITION BLVD
- street2: ''
- street3:
- city: AUSTIN
- state: TX
- postalCode: 78703-1221
- country: US
- phone: ''
- residential:
- weight:
- value: 1
- units: ounces
- dimensions:
- insuranceOptions:
- provider:
- insureShipment: false
- insuredValue: 0
- advancedOptions:
- shipmentItems:
- - orderItemId: 55827278
- lineItemKey:
- sku: test
- name: test
- imageUrl:
- weight:
- quantity: 1
- unitPrice: 1
- warehouseLocation:
- options:
- productId: 7541107
- fulfillmentSku:
- labelData:
- formData:
- total: 2
- page: 1
- pages: 0
- type: object
- properties:
- shipments:
- description: ''
- example:
- - shipmentId: 33974374
- orderId: 43945660
- userId: 123456AB-ab12-3c4d-5e67-89f1abc1defa
- orderNumber: 100038-1
- createDate: 2014-10-03T06:51:33.6270000
- shipDate: 2014-10-03
- shipmentCost: 1.9299999999999999
- insuranceCost: 0
- trackingNumber: 9400111899561704681189
- isReturnLabel: false
- batchNumber: 100301
- carrierCode: stamps_com
- serviceCode: usps_first_class_mail
- packageCode: package
- confirmation: delivery
- warehouseId: 16079
- voided: false
- voidDate:
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Yoda
- company: ''
- street1: 12223 LOWDEN LN
- street2: ''
- street3:
- city: MANCHACA
- state: TX
- postalCode: 78652-3602
- country: US
- phone: 2101235544
- residential:
- weight:
- value: 1
- units: ounces
- dimensions:
- insuranceOptions:
- provider:
- insureShipment: false
- insuredValue: 0
- advancedOptions:
- shipmentItems:
- - orderItemId: 56568665
- lineItemKey:
- sku: SQ3785739
- name: Potato Kitten -
- imageUrl:
- weight:
- quantity: 1
- unitPrice: 1
- warehouseLocation:
- options:
- productId: 7565777
- fulfillmentSku:
- labelData:
- formData:
- - shipmentId: 33974373
- orderId: 43337328
- userId: 123456AB-ab12-3c4d-5e67-89f1abc1defa
- orderNumber: 100028
- createDate: 2014-10-03T06:51:59.9430000
- shipDate: 2014-10-03
- shipmentCost: 1.9299999999999999
- insuranceCost: 0
- trackingNumber: 9400111899561704681196
- isReturnLabel: false
- batchNumber: 100300
- carrierCode: stamps_com
- serviceCode: usps_first_class_mail
- packageCode: package
- confirmation: delivery
- warehouseId: 14265
- voided: false
- voidDate:
- marketplaceNotified: true
- notifyErrorMessage:
- shipTo:
- name: Luke Skywalker
- company: SS
- street1: 2815 EXPOSITION BLVD
- street2: ''
- street3:
- city: AUSTIN
- state: TX
- postalCode: 78703-1221
- country: US
- phone: ''
- residential:
- weight:
- value: 1
- units: ounces
- dimensions:
- insuranceOptions:
- provider:
- insureShipment: false
- insuredValue: 0
- advancedOptions:
- shipmentItems:
- - orderItemId: 55827278
- lineItemKey:
- sku: test
- name: test
- imageUrl:
- weight:
- quantity: 1
- unitPrice: 1
- warehouseLocation:
- options:
- productId: 7541107
- fulfillmentSku:
- labelData:
- formData:
- type: array
- items:
- type: object
- total:
- description: ''
- example: 2
- type: integer
- format: int32
- page:
- description: ''
- example: 1
- type: integer
- format: int32
- pages:
- description: ''
- example: 0
- type: integer
- format: int32
- required:
- - shipments
- - total
- - page
- - pages
- CreateShipmentLabelRequest:
- title: Create Shipment Label request
- type: object
- properties:
- carrierCode:
- description: ''
- example: fedex
- type: string
- serviceCode:
- description: ''
- example: fedex_ground
- type: string
- packageCode:
- description: ''
- example: package
- type: string
- confirmation:
- description: ''
- example: delivery
- type: string
- shipDate:
- description: ''
- example: 2014-04-03
- type: string
- weight:
- description: ''
- example:
- value: 3
- units: ounces
- type: object
- dimensions:
- description: ''
- example:
- units: inches
- length: 7
- width: 5
- height: 6
- type: object
- shipFrom:
- description: ''
- example:
- name: Jason Hodges
- company: ShipStation
- street1: 2815 Exposition Blvd
- street2: Ste 2353242
- street3:
- city: Austin
- state: TX
- postalCode: 78703
- country: US
- phone:
- residential: false
- type: object
- shipTo:
- description: ''
- example:
- name: The President
- company: US Govt
- street1: 1600 Pennsylvania Ave
- street2: Oval Office
- street3:
- city: Washington
- state: DC
- postalCode: 20500
- country: US
- phone:
- residential: false
- type: object
- insuranceOptions:
- description: ''
- type: string
- internationalOptions:
- description: ''
- type: string
- advancedOptions:
- description: ''
- type: string
- testLabel:
- description: ''
- example: false
- type: boolean
- required:
- - carrierCode
- - serviceCode
- - packageCode
- - confirmation
- - shipDate
- - weight
- - dimensions
- - shipFrom
- - shipTo
- - insuranceOptions
- - internationalOptions
- - advancedOptions
- - testLabel
- CreateShipmentLabelResponse:
- title: Create Shipment Label response
- example:
- shipmentId: 123456789
- orderId:
- userId:
- customerEmail:
- orderNumber:
- createDate: 2016-04-03T12:11:36.8630000
- shipDate: 2016-04-03
- shipmentCost: 9.0600000000000005
- insuranceCost: 0
- trackingNumber: 782390443992
- isReturnLabel: false
- batchNumber:
- carrierCode: fedex
- serviceCode: fedex_ground
- packageCode: package
- confirmation: delivery
- warehouseId:
- voided: false
- voidDate:
- marketplaceNotified: false
- notifyErrorMessage:
- shipTo:
- weight:
- dimensions:
- insuranceOptions:
- advancedOptions:
- shipmentItems:
- labelData: JVBERi0xLjQKJeLjz9MKMiAwIG9iago8PC9MZW5ndGggNjIvRmlsdGVyL0ZsYXRlRGVjb2RlPj5zdHJlYW0KeJwr5HIK4TI2U...
- formData:
- type: object
- properties:
- shipmentId:
- description: ''
- example: 123456789
- type: integer
- format: int32
- orderId:
- description: ''
- type: string
- userId:
- description: ''
- type: string
- customerEmail:
- description: ''
- type: string
- orderNumber:
- description: ''
- type: string
- createDate:
- description: ''
- example: 4/3/2016 12:11:36 PM
- type: string
- shipDate:
- description: ''
- example: 2016-04-03
- type: string
- shipmentCost:
- description: ''
- example: 9.0600000000000005
- type: number
- format: double
- insuranceCost:
- description: ''
- example: 0
- type: integer
- format: int32
- trackingNumber:
- description: ''
- example: 782390443992
- type: string
- isReturnLabel:
- description: ''
- example: false
- type: boolean
- batchNumber:
- description: ''
- type: string
- carrierCode:
- description: ''
- example: fedex
- type: string
- serviceCode:
- description: ''
- example: fedex_ground
- type: string
- packageCode:
- description: ''
- example: package
- type: string
- confirmation:
- description: ''
- example: delivery
- type: string
- warehouseId:
- description: ''
- type: string
- voided:
- description: ''
- example: false
- type: boolean
- voidDate:
- description: ''
- type: string
- marketplaceNotified:
- description: ''
- example: false
- type: boolean
- notifyErrorMessage:
- description: ''
- type: string
- shipTo:
- description: ''
- type: string
- weight:
- description: ''
- type: string
- dimensions:
- description: ''
- type: string
- insuranceOptions:
- description: ''
- type: string
- advancedOptions:
- description: ''
- type: string
- shipmentItems:
- description: ''
- type: string
- labelData:
- description: ''
- example: JVBERi0xLjQKJeLjz9MKMiAwIG9iago8PC9MZW5ndGggNjIvRmlsdGVyL0ZsYXRlRGVjb2RlPj5zdHJlYW0KeJwr5HIK4TI2U...
- type: string
- formData:
- description: ''
- type: string
- required:
- - shipmentId
- - orderId
- - userId
- - customerEmail
- - orderNumber
- - createDate
- - shipDate
- - shipmentCost
- - insuranceCost
- - trackingNumber
- - isReturnLabel
- - batchNumber
- - carrierCode
- - serviceCode
- - packageCode
- - confirmation
- - warehouseId
- - voided
- - voidDate
- - marketplaceNotified
- - notifyErrorMessage
- - shipTo
- - weight
- - dimensions
- - insuranceOptions
- - advancedOptions
- - shipmentItems
- - labelData
- - formData
- GetRatesRequest:
- title: Get Rates request
- type: object
- properties:
- carrierCode:
- description: ''
- example: fedex
- type: string
- serviceCode:
- description: ''
- type: string
- packageCode:
- description: ''
- type: string
- fromPostalCode:
- description: ''
- example: 78703
- type: string
- toState:
- description: ''
- example: DC
- type: string
- toCountry:
- description: ''
- example: US
- type: string
- toPostalCode:
- description: ''
- example: 20500
- type: string
- toCity:
- description: ''
- example: Washington
- type: string
- weight:
- description: ''
- example:
- value: 3
- units: ounces
- type: object
- dimensions:
- description: ''
- example:
- units: inches
- length: 7
- width: 5
- height: 6
- type: object
- confirmation:
- description: ''
- example: delivery
- type: string
- residential:
- description: ''
- example: false
- type: boolean
- required:
- - carrierCode
- - serviceCode
- - packageCode
- - fromPostalCode
- - toState
- - toCountry
- - toPostalCode
- - toCity
- - weight
- - dimensions
- - confirmation
- - residential
- GetRatesResponse:
- title: Get Rates response
- example:
- serviceName: FedEx First Overnight®
- serviceCode: fedex_first_overnight
- shipmentCost: 87.799999999999997
- otherCost: 2.6299999999999999
- type: object
- properties:
- serviceName:
- description: ''
- example: FedEx First Overnight®
- type: string
- serviceCode:
- description: ''
- example: fedex_first_overnight
- type: string
- shipmentCost:
- description: ''
- example: 87.799999999999997
- type: number
- format: double
- otherCost:
- description: ''
- example: 2.6299999999999999
- type: number
- format: double
- required:
- - serviceName
- - serviceCode
- - shipmentCost
- - otherCost
- VoidLabelRequest:
- title: Void Label request
- type: object
- properties:
- shipmentId:
- description: ''
- example: 12345
- type: integer
- format: int32
- required:
- - shipmentId
- VoidLabelResponse:
- title: Void Label response
- example:
- approved: true
- message: Label voided successfully
- type: object
- properties:
- approved:
- description: ''
- example: true
- type: boolean
- message:
- description: ''
- example: Label voided successfully
- type: string
- required:
- - approved
- - message
- GetStoreResponse:
- title: Get Store response
- example:
- storeId: 12345
- storeName: WooCommerce Store
- marketplaceId: 36
- marketplaceName: WooCommerce
- accountName:
- email:
- integrationUrl: http://shipstation-test.wpengine.com
- active: true
- companyName: ''
- phone: ''
- publicEmail: ''
- website: ''
- refreshDate: 2014-12-16T17:47:05.4570000
- lastRefreshAttempt: 2014-12-16T09:47:05.4570000
- createDate: 2014-11-06T15:21:13.2230000
- modifyDate: 2014-11-10T08:02:19.1170000
- autoRefresh: true
- statusMappings:
- - orderStatus: awaiting_payment
- statusKey: Pending
- - orderStatus: awaiting_shipment
- statusKey: Processing
- - orderStatus: shipped
- statusKey: Completed
- - orderStatus: cancelled
- statusKey: Cancelled
- - orderStatus: on_hold
- statusKey: On-hold
- type: object
- properties:
- storeId:
- description: ''
- example: 12345
- type: integer
- format: int32
- storeName:
- description: ''
- example: WooCommerce Store
- type: string
- marketplaceId:
- description: ''
- example: 36
- type: integer
- format: int32
- marketplaceName:
- description: ''
- example: WooCommerce
- type: string
- accountName:
- description: ''
- type: string
- email:
- description: ''
- type: string
- integrationUrl:
- description: ''
- example: http://shipstation-test.wpengine.com
- type: string
- active:
- description: ''
- example: true
- type: boolean
- companyName:
- description: ''
- type: string
- phone:
- description: ''
- type: string
- publicEmail:
- description: ''
- type: string
- website:
- description: ''
- type: string
- refreshDate:
- description: ''
- example: 12/16/2014 5:47:05 PM
- type: string
- lastRefreshAttempt:
- description: ''
- example: 12/16/2014 9:47:05 AM
- type: string
- createDate:
- description: ''
- example: 11/6/2014 3:21:13 PM
- type: string
- modifyDate:
- description: ''
- example: 11/10/2014 8:02:19 AM
- type: string
- autoRefresh:
- description: ''
- example: true
- type: boolean
- statusMappings:
- description: ''
- example:
- - orderStatus: awaiting_payment
- statusKey: Pending
- - orderStatus: awaiting_shipment
- statusKey: Processing
- - orderStatus: shipped
- statusKey: Completed
- - orderStatus: cancelled
- statusKey: Cancelled
- - orderStatus: on_hold
- statusKey: On-hold
- type: array
- items:
- type: object
- required:
- - storeId
- - storeName
- - marketplaceId
- - marketplaceName
- - accountName
- - email
- - integrationUrl
- - active
- - companyName
- - phone
- - publicEmail
- - website
- - refreshDate
- - lastRefreshAttempt
- - createDate
- - modifyDate
- - autoRefresh
- - statusMappings
- UpdateStoreRequest:
- title: Update Store request
- type: object
- properties:
- storeId:
- description: ''
- example: 12345
- type: integer
- format: int32
- storeName:
- description: ''
- example: WooCommerce Store
- type: string
- marketplaceId:
- description: ''
- example: 36
- type: integer
- format: int32
- marketplaceName:
- description: ''
- example: WooCommerce
- type: string
- accountName:
- description: ''
- type: string
- email:
- description: ''
- type: string
- integrationUrl:
- description: ''
- example: http://shipstation-test.wpengine.com
- type: string
- active:
- description: ''
- example: true
- type: boolean
- companyName:
- description: ''
- type: string
- phone:
- description: ''
- type: string
- publicEmail:
- description: ''
- type: string
- website:
- description: ''
- type: string
- refreshDate:
- description: ''
- example: 12/16/2014 5:47:05 PM
- type: string
- lastRefreshAttempt:
- description: ''
- example: 12/16/2014 9:47:05 AM
- type: string
- createDate:
- description: ''
- example: 11/6/2014 3:21:13 PM
- type: string
- modifyDate:
- description: ''
- example: 11/10/2014 8:02:19 AM
- type: string
- autoRefresh:
- description: ''
- example: true
- type: boolean
- statusMappings:
- description: ''
- example:
- - orderStatus: awaiting_payment
- statusKey: Pending
- - orderStatus: awaiting_shipment
- statusKey: Processing
- - orderStatus: shipped
- statusKey: Completed
- - orderStatus: cancelled
- statusKey: Cancelled
- - orderStatus: on_hold
- statusKey: On-hold
- type: array
- items:
- type: object
- required:
- - storeId
- - storeName
- - marketplaceId
- - marketplaceName
- - accountName
- - email
- - integrationUrl
- - active
- - companyName
- - phone
- - publicEmail
- - website
- - refreshDate
- - lastRefreshAttempt
- - createDate
- - modifyDate
- - autoRefresh
- - statusMappings
- UpdateStoreResponse:
- title: Update Store response
- example:
- storeId: 12345
- storeName: WooCommerce Store
- marketplaceId: 36
- marketplaceName: WooCommerce
- accountName:
- email:
- integrationUrl: http://shipstation-test.wpengine.com
- active: true
- companyName: ''
- phone: ''
- publicEmail: ''
- website: ''
- refreshDate: 2014-12-16T17:47:05.4570000
- lastRefreshAttempt: 2014-12-16T09:47:05.4570000
- createDate: 2014-11-06T15:21:13.2230000
- modifyDate: 2014-11-10T08:02:19.1170000
- autoRefresh: true
- statusMappings:
- - orderStatus: awaiting_payment
- statusKey: Pending
- - orderStatus: awaiting_shipment
- statusKey: Processing
- - orderStatus: shipped
- statusKey: Completed
- - orderStatus: cancelled
- statusKey: Cancelled
- - orderStatus: on_hold
- statusKey: On-hold
- type: object
- properties:
- storeId:
- description: ''
- example: 12345
- type: integer
- format: int32
- storeName:
- description: ''
- example: WooCommerce Store
- type: string
- marketplaceId:
- description: ''
- example: 36
- type: integer
- format: int32
- marketplaceName:
- description: ''
- example: WooCommerce
- type: string
- accountName:
- description: ''
- type: string
- email:
- description: ''
- type: string
- integrationUrl:
- description: ''
- example: http://shipstation-test.wpengine.com
- type: string
- active:
- description: ''
- example: true
- type: boolean
- companyName:
- description: ''
- type: string
- phone:
- description: ''
- type: string
- publicEmail:
- description: ''
- type: string
- website:
- description: ''
- type: string
- refreshDate:
- description: ''
- example: 12/16/2014 5:47:05 PM
- type: string
- lastRefreshAttempt:
- description: ''
- example: 12/16/2014 9:47:05 AM
- type: string
- createDate:
- description: ''
- example: 11/6/2014 3:21:13 PM
- type: string
- modifyDate:
- description: ''
- example: 11/10/2014 8:02:19 AM
- type: string
- autoRefresh:
- description: ''
- example: true
- type: boolean
- statusMappings:
- description: ''
- example:
- - orderStatus: awaiting_payment
- statusKey: Pending
- - orderStatus: awaiting_shipment
- statusKey: Processing
- - orderStatus: shipped
- statusKey: Completed
- - orderStatus: cancelled
- statusKey: Cancelled
- - orderStatus: on_hold
- statusKey: On-hold
- type: array
- items:
- type: object
- required:
- - storeId
- - storeName
- - marketplaceId
- - marketplaceName
- - accountName
- - email
- - integrationUrl
- - active
- - companyName
- - phone
- - publicEmail
- - website
- - refreshDate
- - lastRefreshAttempt
- - createDate
- - modifyDate
- - autoRefresh
- - statusMappings
- GetStoreRefreshStatusResponse:
- title: Get Store Refresh Status response
- example:
- storeId: 12345
- refreshStatusId: 2
- refreshStatus: Updating orders
- lastRefreshAttempt: 8-13-2014
- refreshDate: 8-13-2014
- type: object
- properties:
- storeId:
- description: ''
- example: 12345
- type: integer
- format: int32
- refreshStatusId:
- description: ''
- example: 2
- type: integer
- format: int32
- refreshStatus:
- description: ''
- example: Updating orders
- type: string
- lastRefreshAttempt:
- description: ''
- example: 8-13-2014
- type: string
- refreshDate:
- description: ''
- example: 8-13-2014
- type: string
- required:
- - storeId
- - refreshStatusId
- - refreshStatus
- - lastRefreshAttempt
- - refreshDate
- RefreshStoreRequest:
- title: Refresh Store request
- type: object
- properties:
- storeId:
- description: ''
- example: 12345
- type: integer
- format: int32
- refreshDate:
- description: ''
- example: 12-08-2014
- type: string
- required:
- - storeId
- - refreshDate
- RefreshStoreResponse:
- title: Refresh Store response
- example:
- success: true
- message: A store refresh has been initiated for Store ID 12345
- type: object
- properties:
- success:
- description: ''
- example: true
- type: boolean
- message:
- description: ''
- example: A store refresh has been initiated for Store ID 12345
- type: string
- required:
- - success
- - message
- ListStoresResponse:
- title: List Stores response
- example:
- storeId: 22766
- storeName: ShipStation Manual Store
- marketplaceId: 0
- marketplaceName: ShipStation
- accountName:
- email:
- integrationUrl:
- active: true
- companyName: ''
- phone: ''
- publicEmail: testemail@email.com
- website: ''
- refreshDate: 2014-12-03T11:46:11.2830000
- lastRefreshAttempt: 2014-12-03T11:46:53.4330000
- createDate: 2014-07-25T11:05:55.3070000
- modifyDate: 2014-11-12T08:45:20.5500000
- autoRefresh: false
- type: object
- properties:
- storeId:
- description: ''
- example: 22766
- type: integer
- format: int32
- storeName:
- description: ''
- example: ShipStation Manual Store
- type: string
- marketplaceId:
- description: ''
- example: 0
- type: integer
- format: int32
- marketplaceName:
- description: ''
- example: ShipStation
- type: string
- accountName:
- description: ''
- type: string
- email:
- description: ''
- type: string
- integrationUrl:
- description: ''
- type: string
- active:
- description: ''
- example: true
- type: boolean
- companyName:
- description: ''
- type: string
- phone:
- description: ''
- type: string
- publicEmail:
- description: ''
- example: testemail@email.com
- type: string
- website:
- description: ''
- type: string
- refreshDate:
- description: ''
- example: 12/3/2014 11:46:11 AM
- type: string
- lastRefreshAttempt:
- description: ''
- example: 12/3/2014 11:46:53 AM
- type: string
- createDate:
- description: ''
- example: 7/25/2014 11:05:55 AM
- type: string
- modifyDate:
- description: ''
- example: 11/12/2014 8:45:20 AM
- type: string
- autoRefresh:
- description: ''
- example: false
- type: boolean
- required:
- - storeId
- - storeName
- - marketplaceId
- - marketplaceName
- - accountName
- - email
- - integrationUrl
- - active
- - companyName
- - phone
- - publicEmail
- - website
- - refreshDate
- - lastRefreshAttempt
- - createDate
- - modifyDate
- - autoRefresh
- ListMarketplacesResponse:
- title: List Marketplaces response
- example:
- name: 3DCart
- marketplaceId: 23
- canRefresh: true
- supportsCustomMappings: true
- supportsCustomStatuses: false
- canConfirmShipments: true
- type: object
- properties:
- name:
- description: ''
- example: 3DCart
- type: string
- marketplaceId:
- description: ''
- example: 23
- type: integer
- format: int32
- canRefresh:
- description: ''
- example: true
- type: boolean
- supportsCustomMappings:
- description: ''
- example: true
- type: boolean
- supportsCustomStatuses:
- description: ''
- example: false
- type: boolean
- canConfirmShipments:
- description: ''
- example: true
- type: boolean
- required:
- - name
- - marketplaceId
- - canRefresh
- - supportsCustomMappings
- - supportsCustomStatuses
- - canConfirmShipments
- DeactivateStoreRequest:
- title: Deactivate Store request
- type: object
- properties:
- storeId:
- description: ''
- example: 12345
- type: string
- required:
- - storeId
- DeactivateStoreResponse:
- title: Deactivate Store response
- example:
- success: true
- message: The requested store has been reactivated.
- type: object
- properties:
- success:
- description: ''
- example: true
- type: string
- message:
- description: ''
- example: The requested store has been reactivated.
- type: string
- required:
- - success
- - message
- ReactivateStoreRequest:
- title: Reactivate Store request
- type: object
- properties:
- storeId:
- description: ''
- example: 12345
- type: string
- required:
- - storeId
- ReactivateStoreResponse:
- title: Reactivate Store response
- example:
- success: true
- message: The requested store has been reactivated.
- type: object
- properties:
- success:
- description: ''
- example: true
- type: string
- message:
- description: ''
- example: The requested store has been reactivated.
- type: string
- required:
- - success
- - message
- ListUsersResponse:
- title: List Users response
- example:
- userId: 123456AB-ab12-3c4d-5e67-89f1abc1defa
- userName: SS-user1
- name: Shipping Employee 1
- type: object
- properties:
- userId:
- description: ''
- example: 123456AB-ab12-3c4d-5e67-89f1abc1defa
- type: string
- userName:
- description: ''
- example: SS-user1
- type: string
- name:
- description: ''
- example: Shipping Employee 1
- type: string
- required:
- - userId
- - userName
- - name
- GetWarehouseResponse:
- title: Get Warehouse response
- example:
- warehouseId: 12345
- warehouseName: API Ship From Location
- originAddress:
- name: API Warehouse
- company: ShipStation
- street1: 2815 Exposition Blvd
- street2:
- street3:
- city: Austin
- state: TX
- postalCode: 78703
- country: US
- phone: 512-555-5555
- residential: true
- addressVerified:
- returnAddress:
- name: API Ship From Location
- company: ShipStation
- street1: 2815 Exposition Blvd
- street2:
- street3:
- city: Austin
- state: TX
- postalCode: 78703
- country: US
- phone: 512-555-5555
- residential:
- addressVerified:
- createDate: 2015-07-02T08:38:31.4870000
- isDefault: true
- type: object
- properties:
- warehouseId:
- description: ''
- example: 12345
- type: integer
- format: int32
- warehouseName:
- description: ''
- example: API Ship From Location
- type: string
- originAddress:
- description: ''
- example:
- name: API Warehouse
- company: ShipStation
- street1: 2815 Exposition Blvd
- street2:
- street3:
- city: Austin
- state: TX
- postalCode: 78703
- country: US
- phone: 512-555-5555
- residential: true
- addressVerified:
- type: object
- returnAddress:
- description: ''
- example:
- name: API Ship From Location
- company: ShipStation
- street1: 2815 Exposition Blvd
- street2:
- street3:
- city: Austin
- state: TX
- postalCode: 78703
- country: US
- phone: 512-555-5555
- residential:
- addressVerified:
- type: object
- createDate:
- description: ''
- example: 7/2/2015 8:38:31 AM
- type: string
- isDefault:
- description: ''
- example: true
- type: boolean
- required:
- - warehouseId
- - warehouseName
- - originAddress
- - returnAddress
- - createDate
- - isDefault
- UpdateWarehouseRequest:
- title: Update Warehouse request
- type: object
- properties:
- warehouseId:
- description: ''
- example: 12345
- type: integer
- format: int32
- warehouseName:
- description: ''
- example: API Ship From Location
- type: string
- originAddress:
- description: ''
- example:
- name: API Warehouse
- company: ShipStation
- street1: 2815 Exposition Blvd
- street2:
- street3:
- city: Austin
- state: TX
- postalCode: 78703
- country: US
- phone: 512-555-5555
- residential: true
- addressVerified:
- type: object
- returnAddress:
- description: ''
- example:
- name: API Ship From Location
- company: ShipStation
- street1: 2815 Exposition Blvd
- street2:
- street3:
- city: Austin
- state: TX
- postalCode: 78703
- country: US
- phone: 512-555-5555
- residential:
- addressVerified:
- type: object
- createDate:
- description: ''
- example: 7/2/2015 8:38:31 AM
- type: string
- isDefault:
- description: ''
- example: true
- type: boolean
- required:
- - warehouseId
- - warehouseName
- - originAddress
- - returnAddress
- - createDate
- - isDefault
- UpdateWarehouseResponse:
- title: Update Warehouse response
- example:
- warehouseId: 12345
- warehouseName: API Ship From Location
- originAddress:
- name: API Warehouse
- company: ShipStation
- street1: 2815 Exposition Blvd
- street2:
- street3:
- city: Austin
- state: TX
- postalCode: 78703
- country: US
- phone: 512-555-5555
- residential: true
- addressVerified:
- returnAddress:
- name: API Ship From Location
- company: ShipStation
- street1: 2815 Exposition Blvd
- street2:
- street3:
- city: Austin
- state: TX
- postalCode: 78703
- country: US
- phone: 512-555-5555
- residential:
- addressVerified:
- createDate: 2015-07-02T08:38:31.4870000
- isDefault: true
- type: object
- properties:
- warehouseId:
- description: ''
- example: 12345
- type: integer
- format: int32
- warehouseName:
- description: ''
- example: API Ship From Location
- type: string
- originAddress:
- description: ''
- example:
- name: API Warehouse
- company: ShipStation
- street1: 2815 Exposition Blvd
- street2:
- street3:
- city: Austin
- state: TX
- postalCode: 78703
- country: US
- phone: 512-555-5555
- residential: true
- addressVerified:
- type: object
- returnAddress:
- description: ''
- example:
- name: API Ship From Location
- company: ShipStation
- street1: 2815 Exposition Blvd
- street2:
- street3:
- city: Austin
- state: TX
- postalCode: 78703
- country: US
- phone: 512-555-5555
- residential:
- addressVerified:
- type: object
- createDate:
- description: ''
- example: 7/2/2015 8:38:31 AM
- type: string
- isDefault:
- description: ''
- example: true
- type: boolean
- required:
- - warehouseId
- - warehouseName
- - originAddress
- - returnAddress
- - createDate
- - isDefault
- CreateWarehouseRequest:
- title: Create Warehouse request
- type: object
- properties:
- warehouseName:
- description: ''
- example: New Ship From Location
- type: string
- originAddress:
- description: ''
- example:
- name: NM Warehouse
- company: White Sands Co.
- street1: 4704 Arabela Dr.
- street2:
- street3:
- city: Las Cruces
- state: NM
- postalCode: 80012
- country: US
- phone: 512-111-2222
- residential: true
- type: object
- returnAddress:
- description: ''
- type: string
- isDefault:
- description: ''
- example: false
- type: boolean
- required:
- - warehouseName
- - originAddress
- - returnAddress
- - isDefault
- CreateWarehouseResponse:
- title: Create Warehouse response
- example:
- warehouseId: 17977
- warehouseName: New Ship From Location
- originAddress:
- name: NM Warehouse
- company: White Sands Co
- street1: 4704 Arabela Dr.
- street2: ''
- street3: ''
- city: Las Cruces
- state: NM
- postalCode: 88012
- country: US
- phone: 512-111-2222
- residential: true
- returnAddress:
- name: NM Warehouse
- company: White Sands Co
- street1: 4704 Arabela Dr.
- street2: ''
- street3: ''
- city: Las Cruces
- state: NM
- postalCode: 88012
- country: US
- phone: 512-111-2222
- residential:
- createDate: 2014-10-21T08:11:43.8800000
- isDefault: false
- type: object
- properties:
- warehouseId:
- description: ''
- example: 17977
- type: integer
- format: int32
- warehouseName:
- description: ''
- example: New Ship From Location
- type: string
- originAddress:
- description: ''
- example:
- name: NM Warehouse
- company: White Sands Co
- street1: 4704 Arabela Dr.
- street2: ''
- street3: ''
- city: Las Cruces
- state: NM
- postalCode: 88012
- country: US
- phone: 512-111-2222
- residential: true
- type: object
- returnAddress:
- description: ''
- example:
- name: NM Warehouse
- company: White Sands Co
- street1: 4704 Arabela Dr.
- street2: ''
- street3: ''
- city: Las Cruces
- state: NM
- postalCode: 88012
- country: US
- phone: 512-111-2222
- residential:
- type: object
- createDate:
- description: ''
- example: 10/21/2014 8:11:43 AM
- type: string
- isDefault:
- description: ''
- example: false
- type: boolean
- required:
- - warehouseId
- - warehouseName
- - originAddress
- - returnAddress
- - createDate
- - isDefault
- ListWarehousesResponse:
- title: List Warehouses response
- example:
- warehouseId: 17977
- warehouseName: Main warehouse
- originAddress:
- name: Spring warehouse
- company: ''
- street1: '123 S SPRING RD '
- street2: ''
- street3: ''
- city: Elmurst
- state: IL
- postalCode: 60126
- country: US
- phone: 5121112222
- residential: false
- returnAddress:
- name: Chicago House
- company: ''
- street1: '123 S SPRING RD '
- street2: ''
- street3: ''
- city: Elmurst
- state: IL
- postalCode: 60126
- country: US
- phone: 5121112222
- residential:
- createDate: 2014-10-21T08:11:43.8800000
- isDefault: true
- type: object
- properties:
- warehouseId:
- description: ''
- example: 17977
- type: integer
- format: int32
- warehouseName:
- description: ''
- example: Main warehouse
- type: string
- originAddress:
- description: ''
- example:
- name: Spring warehouse
- company: ''
- street1: '123 S SPRING RD '
- street2: ''
- street3: ''
- city: Elmurst
- state: IL
- postalCode: 60126
- country: US
- phone: 5121112222
- residential: false
- type: object
- returnAddress:
- description: ''
- example:
- name: Chicago House
- company: ''
- street1: '123 S SPRING RD '
- street2: ''
- street3: ''
- city: Elmurst
- state: IL
- postalCode: 60126
- country: US
- phone: 5121112222
- residential:
- type: object
- createDate:
- description: ''
- example: 10/21/2014 8:11:43 AM
- type: string
- isDefault:
- description: ''
- example: true
- type: boolean
- required:
- - warehouseId
- - warehouseName
- - originAddress
- - returnAddress
- - createDate
- - isDefault
- ListWebhooksResponse:
- title: List Webhooks response
- example:
- webhooks:
- - IsLabelAPIHook: false
- WebHookID: 123
- SellerID: 100000
- StoreID: 12345
- HookType: ITEM_ORDER_NOTIFY
- MessageFormat: Json
- Url: http://example.endpoint/orders
- Name: My Order Webhook
- BulkCopyBatchID:
- BulkCopyRecordID:
- Active: true
- WebhookLogs: []
- Seller:
- Store:
- - IsLabelAPIHook: false
- WebHookID: 456
- SellerID: 100000
- StoreID: 98765
- HookType: SHIP_NOTIFY
- MessageFormat: Json
- Url: https://example.endpoint/shipment
- Name: My Shipment Webhook
- BulkCopyBatchID:
- BulkCopyRecordID:
- Active: true
- WebhookLogs: []
- Seller:
- Store:
- type: object
- properties:
- webhooks:
- description: ''
- example:
- - IsLabelAPIHook: false
- WebHookID: 123
- SellerID: 100000
- StoreID: 12345
- HookType: ITEM_ORDER_NOTIFY
- MessageFormat: Json
- Url: http://example.endpoint/orders
- Name: My Order Webhook
- BulkCopyBatchID:
- BulkCopyRecordID:
- Active: true
- WebhookLogs: []
- Seller:
- Store:
- - IsLabelAPIHook: false
- WebHookID: 456
- SellerID: 100000
- StoreID: 98765
- HookType: SHIP_NOTIFY
- MessageFormat: Json
- Url: https://example.endpoint/shipment
- Name: My Shipment Webhook
- BulkCopyBatchID:
- BulkCopyRecordID:
- Active: true
- WebhookLogs: []
- Seller:
- Store:
- type: array
- items:
- type: object
- required:
- - webhooks
- SubscribeToWebhookRequest:
- title: Subscribe to Webhook request
- type: object
- properties:
- target_url:
- description: ''
- example: http://someexamplewebhookurl.com/neworder
- type: string
- event:
- description: ''
- example: ORDER_NOTIFY
- type: string
- store_id:
- description: ''
- type: string
- friendly_name:
- description: ''
- example: My Webhook
- type: string
- required:
- - target_url
- - event
- - store_id
- - friendly_name
- SubscribeToWebhookResponse:
- title: Subscribe to Webhook response
- example:
- id: 123456
- type: object
- properties:
- id:
- description: ''
- example: 123456
- type: integer
- format: int32
- required:
- - id
Add Comment
Please, Sign In to add comment