Orders API

GET https://api.orbitkit.com/orders

Retrieves a paginated list of your orders. There are two optional query parameters:

• limit - number of orders to request, max 1000 (the default)
• cursor - the value of more if you wish to fetch the next page of results

The result looks like this (see "Pagination" in the API Overview):

{ 
  "data": [ {...first...}, {...second...} ],
  "total": 12345,
  "more": "cursorstring"
}

more will be null (you're at the end) or a value you can pass as a cursor to this same endpoint to fetch the next page of results.

The data will be the same data in the GET single order endpoint below.

GET https://api.orbitkit.com/orders/ORD123

Obtain the data for a single order with key BLU123. Response looks like:

{
  "key": "ORD4548",
  "reference": "myuniqueorder1",
  "venue": {
    "key": "VEN4421",
    "name": "Orbital Commerce",
    "platform": "Manual"
  },
  "created": "2020-10-17T00:23:23.071Z",
  "flag": false,
  "link": "https://app.orbitkit.com/orgs/ORG2/orders/ORD4548",
  "note": "",
  "quantity": 2,
  "cost": {
    "cents": 2149,
    "amount": 21.49,
    "symbol": "$",
    "currency": "USD",
    "pretty": "$21.49"
  },
  "shipping": {
    "name": "Bob Dobbs",
    "address1": "123 Slack St",
    "address2": "",
    "city": "Nowhere",
    "state": "CA",
    "zip": "99999",
    "country": "US"
  },
  "fulfillments": [
    {
      "key": "FUL4549",
      "state": "PROCESSING",
      "shipped": null,
      "delivered": null,
      "cancelled": null,
      "tracking": null,
      "lineItems": [
        {
          "key": "ITM4550",
          "type": "PRODUCT",
          "title": "Frop More",
          "quantity": 2,
          "unitCost": {
            "cents": 850,
            "amount": 8.50,
            "symbol": "$",
            "currency": "USD",
            "pretty": "$8.50"
          },
          "totalCost": {
            "cents": 1700,
            "amount": 17.00,
            "symbol": "$",
            "currency": "USD",
            "pretty": "$17"
          },
          "reference": "myuniqueitemid1",
          "design": { ...complete design object... },
          "side": "FRONT",
          "variant": {
            "key": "VARTS_BLK_L",
            "product": {
              "key": "PRDTS",
              "name": "Unisex T-Shirt"
            },
            "color": {
              "key": "CLRTS_BLK",
              "name": "Black",
              "hex": "#25282a",
              "texture": "SOLID",  // some are "HEATHER"
            },
            "size": "L"
          }
        },
        {
          "key": "ITM4551",
          "type": "SHIPPING",
          "title": "Shipping",
          "quantity": 1,
          "unitCost": {
            "cents": 449,
            "amount": 4.49,
            "symbol": "$",
            "currency": "USD",
            "pretty": "$4.49"
          },
          "totalCost": {
            "cents": 449,
            "amount": 4.49,
            "symbol": "$",
            "currency": "USD",
            "pretty": "$4.49"
          },
          "reference": null,
          "design": null,
          "side": null,
          "variant": null
        }
      ]
    }
  ]
}
 

There's a lot going on here. Some notes:

• At present, there will always be exactly one fulfillment for each order. That may change in the future.
• Line items have two types, PRODUCT and SHIPPING. There will only be one SHIPPING line per fulfillment.
• reference, design, side, variant only apply to PRODUCT line items. These values are always null for SHIPPING.
• See the Designs API for the structure of the design object.

Requests for invalid keys produce 410 GONE (to explicitly distinguish from 404).