Paging

For stores with hundreds or thousands of orders per day, we recommend paging your results. You can indicate the current page number, and the total number of pages by adding page and pages fields in your response. ShipStation will request each page of data one-by-one. by appending a page query parameter.

Example Orders Response Body

Below is an example of the JSON response body that ShipStation is expecting when an /orders call is made for order information. You can find detailed definitions of the fields in the Orders.

GET /orders?page=2 HTTP/1.1
Host: api.my-store.com
Authorization: Basic ZGVtbzpwQDU1dzByZA==
Accept: application/json
{
  "page": 2,
  "pages": 7,
  "orders": [
    {
      "order_id": "QsPJ9R-CfY4 BjnieMw68-Gb9TW9yp",
      "order_source_code": "shopify",
      "created_at": "2020-01-17T05:50:23.000Z",
      "modified_at": "2020-01-17T05:50:23.000Z",
      "status": "awaiting_shipment",
      "fulfillment_status": "partially_fulfilled",
      "buyer": {
        "buyer_id": "username123",
        "name": "John Doe",
        "phone": "111-111-1111",
        "email": "[email protected]"
      },
      "ship_to": {
        "name": "Amanda Miller",
        "phone": "555-555-5555",
        "address_line1": "525 S Winchester Blvd",
        "city_locality": "San Jose",
        "state_province": "CA",
        "postal_code": "95128",
        "country_code": "US"
      },
      "tax": {
        "amount": 16.37,
        "currency": "usd"
      },
      "shipping_price": {
        "amount": 22.10,
        "currency": "usd"
      },
      "price_adjustments": [
        {
          "type": "gift_certificate",
          "amount": {
            "amount": -10,
            "currency": "usd"
          }
        },
        {
          "type": "fee",
          "amount": {
            "amount": 12,
            "currency": "usd"
          }
        }
      ],
      "total_price": {
        "amount": 115.44,
        "currency": "usd"
      },
      "payment_status": "payment_in_process",
      "payment_method": "credit_card",
      "items": [
        {
          "item_id": "9TWjnieMw6-89ypRCfY4XBGb-QsPJ9",
          "fulfillment_status": "partially_fulfilled",
          "name": "Wonder Widget",
          "sku": "KS944RUR",
          "quantity": 3,
          "weight": {
            "value": 7,
            "unit": "pound"
          },
          "unit_price": {
            "amount": 24.99,
            "currency": "usd"
          },
          "total_price": {
            "amount": 74.97,
            "currency": "usd"
          },
          "shipping_preferences": {
            "confirmation": "adult_signature",
            "expedited_service": true,
            "contains_alcohol": false,
            "delivery_date": "2020-01-20",
            "saturday_delivery": true,
            "insured_value": {
              "amount": 100,
              "currency": "usd"
            }
          },
          "links": {
            "self": "https://my-store.com/orders/123456/items/456789",
            "category": "https://my-store.com/widgets",
            "product": "https://my-store.com/product/123456",
            "image": "https://my-store.com/product/123456/image.jpg",
            "thumbnail": "https://my-store.com/product/123456/small.jpg",
            "video": "https://my-store.com/product/123456/video",
            "tracking": "https://my-store.com/orders/123456/track"
          }
        }
      ],
      "links": {
        "self": "https://my-store.com/orders/123456"
      },
      "notes": [
        {
          "type": "instructions",
          "text": "Please make sure it gets here by Dec. 22nd!"
        },
        {
          "type": "internal_notes",
          "text": "Ship by December 18th via Priority Mail."
        }
      ]
    }
  ]
}