Retrieve an Order Status - Spree Commerce documentation

GET

api

storefront

order_status

{order_number}

Retrieve an Order Status

const options = {method: 'GET', headers: {'X-Spree-Order-Token': '<api-key>'}};

fetch('https://demo.spreecommerce.org/api/v2/storefront/order_status/{order_number}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request GET \
  --url https://demo.spreecommerce.org/api/v2/storefront/order_status/{order_number} \
  --header 'X-Spree-Order-Token: <api-key>'

{
  "data": {
    "id": "17",
    "type": "cart",
    "attributes": {
      "number": "R233871560",
      "item_total": "0.0",
      "total": "0.0",
      "subtotal_cents": 0,
      "store_credit_total_cents": 0,
      "total_cents": 0,
      "total_minus_store_credits": "0.0",
      "total_minus_store_credits_cents": 0,
      "ship_total": "0.0",
      "ship_total_cents": 0,
      "adjustment_total": "0.0",
      "created_at": "2021-09-28T22:15:07.471Z",
      "updated_at": "2021-09-28T22:15:07.471Z",
      "completed_at": null,
      "included_tax_total": "0.0",
      "additional_tax_total": "0.0",
      "display_additional_tax_total": "$0.00",
      "display_included_tax_total": "$0.00",
      "tax_total": "0.0",
      "tax_total_cents": 0,
      "currency": "USD",
      "state": "cart",
      "token": "zTEpsukRq_yEUcXVCSv0uw1632867307450",
      "email": null,
      "display_item_total": "$0.00",
      "display_ship_total": "$0.00",
      "display_adjustment_total": "$0.00",
      "display_tax_total": "$0.00",
      "promo_total": "0.0",
      "display_promo_total": "$0.00",
      "promo_total_cents": 0,
      "item_count": 0,
      "special_instructions": null,
      "display_total": "$0.00",
      "display_total_minus_store_credits": "$0.00",
      "pre_tax_item_amount": "0.0",
      "display_pre_tax_item_amount": "$0.00",
      "pre_tax_total": "0.0",
      "display_pre_tax_total": "$0.00",
      "shipment_state": null,
      "payment_state": null
    },
    "relationships": {
      "line_items": {
        "data": []
      },
      "variants": {
        "data": []
      },
      "promotions": {
        "data": []
      },
      "payments": {
        "data": []
      },
      "shipments": {
        "data": []
      },
      "user": {
        "data": null
      },
      "billing_address": {
        "data": null
      },
      "shipping_address": {
        "data": null
      }
    }
  }
}

Authorizations

X-Spree-Order-Token

string

header

required

Order token to authorize Cart and Checkout requests.

How to obtain X-Spree-Order-Token

Path Parameters

order_number

string

required

The required {order_number} value can be found in the cart response body, identified as the number attribute.

Example:

"R653163382"

Query Parameters

include

string

Specify the related resources you would like to receive in the response body. More Information.

fields[cart]

string

Specify the fields you would like returned in the response body. More information.

Response

200 Success - Returns the cart object.

data

Cart · object

required

The Cart provides a central place to collect information about an order, including line items, adjustments, payments, addresses, and shipments. Read more in Spree docs

Show child attributes

included

Show child attributes

Retrieve an Order

Retrieve a Cart

⌘I

Retrieve an Order Status

const options = {method: 'GET', headers: {'X-Spree-Order-Token': '<api-key>'}};

fetch('https://demo.spreecommerce.org/api/v2/storefront/order_status/{order_number}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request GET \
  --url https://demo.spreecommerce.org/api/v2/storefront/order_status/{order_number} \
  --header 'X-Spree-Order-Token: <api-key>'

{
  "data": {
    "id": "17",
    "type": "cart",
    "attributes": {
      "number": "R233871560",
      "item_total": "0.0",
      "total": "0.0",
      "subtotal_cents": 0,
      "store_credit_total_cents": 0,
      "total_cents": 0,
      "total_minus_store_credits": "0.0",
      "total_minus_store_credits_cents": 0,
      "ship_total": "0.0",
      "ship_total_cents": 0,
      "adjustment_total": "0.0",
      "created_at": "2021-09-28T22:15:07.471Z",
      "updated_at": "2021-09-28T22:15:07.471Z",
      "completed_at": null,
      "included_tax_total": "0.0",
      "additional_tax_total": "0.0",
      "display_additional_tax_total": "$0.00",
      "display_included_tax_total": "$0.00",
      "tax_total": "0.0",
      "tax_total_cents": 0,
      "currency": "USD",
      "state": "cart",
      "token": "zTEpsukRq_yEUcXVCSv0uw1632867307450",
      "email": null,
      "display_item_total": "$0.00",
      "display_ship_total": "$0.00",
      "display_adjustment_total": "$0.00",
      "display_tax_total": "$0.00",
      "promo_total": "0.0",
      "display_promo_total": "$0.00",
      "promo_total_cents": 0,
      "item_count": 0,
      "special_instructions": null,
      "display_total": "$0.00",
      "display_total_minus_store_credits": "$0.00",
      "pre_tax_item_amount": "0.0",
      "display_pre_tax_item_amount": "$0.00",
      "pre_tax_total": "0.0",
      "display_pre_tax_total": "$0.00",
      "shipment_state": null,
      "payment_state": null
    },
    "relationships": {
      "line_items": {
        "data": []
      },
      "variants": {
        "data": []
      },
      "promotions": {
        "data": []
      },
      "payments": {
        "data": []
      },
      "shipments": {
        "data": []
      },
      "user": {
        "data": null
      },
      "billing_address": {
        "data": null
      },
      "shipping_address": {
        "data": null
      }
    }
  }
}