# Orders # Order Index Endpoint This endpoint retrieves a paginated list of all orders #### Structure See [`Order View Endpoint`](https://support.aerocommerce.com/books/api/page/order-view-endpoint) for the structure of the order payload inside the `data` array. --- #### Scopes
**Name** **Description** **Example**
`visible`Only return visible orders (those which have been ordered)`?scope=visible`
`outstanding`Only return outstanding orders`?scope=outstanding`
`completed`Only return completed orders`?scope=completed`
`incomplete`Only return incomplete orders`?scope=incomplete`
`express`Only return express orders`?scope=express`
`standard`Only return standard orders`?scope=standard`
--- #### Filters
**Name** **Description** **Example**
`reference`Only return orders with specific references`?references=ABC123,DEF456`
`statuses`Only return orders with specific status ids or names`?statuses=1,On Hold`
`states`Only return orders with specific states`?states=dispatched,returned`
`customers`Only return orders with specific customers (by id or email)`?customers=1,test@gmail.com`
`emails`Only return orders for specific emails`?emails=test@gmail.com`
`channels`Only return orders for specific channels`?channels=web,api`
`flags`Only return orders for specific flags (by `id`, `name`, or `name|value`)`?flags=1,abc,def|123`
--- ``` GET /api/orders?per_page=2&min_ordered_at=2023-08-30%2010:36:23 ``` ```json { "current_page": 1, "data": [ //... ], "first_page_url": "http://aero.test/api/orders?page=1", "from": 1, "last_page": 3, "last_page_url": "http://aero.test/api/orders?page=3", "next_page_url": "http://aero.test/api/orders?page=2", "path": "http://aero.test/api/orders", "per_page": 2, "prev_page_url": null, "to": 2, "total": 5 } ```

See [`Order View Endpoint`](https://support.aerocommerce.com/books/api/page/order-view-endpoint) for the structure of the order payload inside the `data` array.

# Order View Endpoint This endpoint retrieves a single order by `id` or `reference`. #### Structure ##### Order
**Name** **Type** **Description**
`reference`stringThe **unique** reference for the order
`status`objectThe [Order Status](https://support.aerocommerce.com/books/api/page/order-view-endpoint#bkmrk-order-status) of the order (`null` if none)
`customer`objectThe [Customer](https://support.aerocommerce.com/books/api/page/order-view-endpoint#bkmrk-customer) of the order (`null` if none)
`email`stringThe email of the customer that placed the order
`subtotal.amount`floatThe subtotal of the order **excluding tax**
`subtotal.tax`floatThe subtotal tax for the order
`shipping.amount`floatThe shipping of the order **excluding tax**
`shipping.tax`floatThe shipping tax for the order
`discount.amount`floatThe discount of the order **excluding tax**
`discount.tax`floatThe discount tax for the order
`surcharge.amount`floatThe surcharge of the order **excluding tax**
`surcharge.tax`floatThe surcharge tax for the order
`currency`stringThe currency code of the order
`shipping_method`objectThe [Shipping Method](https://support.aerocommerce.com/books/api/page/order-view-endpoint#bkmrk-shipping-method) of the order (`null` if none)
`shipping_address`objectThe [Shipping Address](https://support.aerocommerce.com/books/api/page/order-view-endpoint#bkmrk-shipping-address) of the order (`null` if none)
`billing_address `objectThe [Billing Address](https://support.aerocommerce.com/books/api/page/order-view-endpoint#bkmrk-billing-address) of the order (`null` if none)
`ordered_at`timestampWhen the order was ordered
`deliver_on`timestampWhen the order should be delivered
`items`arrayAn array of [Order Item](https://support.aerocommerce.com/books/api/page/order-view-endpoint#bkmrk-order-item) objects
`payments`arrayAn array of [Payment](https://support.aerocommerce.com/books/api/page/order-view-endpoint#bkmrk-payment) objects
`fulfillments`arrayAn array of [Fulfillment](https://support.aerocommerce.com/books/api/page/order-view-endpoint#bkmrk-fulfillment) objects
`returns`arrayAn array of [Return](https://support.aerocommerce.com/books/api/page/order-view-endpoint#bkmrk-return) objects
`comments`arrayAn array of [Comment](https://support.aerocommerce.com/books/api/page/order-view-endpoint#bkmrk-comment) objects
`additional_attributes`arrayAn array of [Additional Attribute](https://support.aerocommerce.com/books/api/page/order-view-endpoint#bkmrk-additional-attribute) objects
##### Order Status
**Name** **Type** **Description**
`id`intThe id of the order status
`name`stringThe name of the order status
`state`stringThe state of the order status
**Valid states:** cancelled, on\_hold, successful, complete, processing, closed, partially\_dispatched, dispatched, partially\_returned, returned ##### Customer
**Name** **Type** **Description**
`id`intThe id of the customer
`name`stringThe name of the customer
`email`stringThe email of the customer
##### Shipping Method
**Name** **Type** **Description**
`id`intThe id of the shipping method
`name`stringThe name of the shipping method
##### Shipping Address
**Name** **Type** **Description**
`first_name`stringThe first name for the shipping address
`last_name`stringThe last name for the shipping address
`company`stringThe company for the shipping address
`mobile`stringThe mobile number for the shipping address
`phone`stringThe phone number for the shipping address
`line_1`stringThe first line for the shipping address
`line_2`stringThe second line for the shipping address
`city`stringThe city for the shipping address
`county`stringThe county for the shipping address
`zone`stringThe zone code for the shipping address
`postcode`stringThe postcode for the shipping address
`country`stringThe country code for the shipping address
`reference`stringThe **unique** reference for the shipping address
`eori_number`stringThe EORI number for the shipping address
##### Billing Address
**Name** **Type** **Description**
`first_name`stringThe first name for the billing address
`last_name`stringThe last name for the billing address
`company`stringThe company for the billing address
`mobile`stringThe mobile number for the billing address
`phone`stringThe phone number for the billing address
`line_1`stringThe first line for the billing address
`line_2`stringThe second line for the billing address
`city`stringThe city for the billing address
`county`stringThe county for the billing address
`zone`stringThe zone code for the billing address
`postcode`stringThe postcode for the billing address
`country`stringThe country code for the billing address
`reference`stringThe **unique** reference for the billing address
`eori_number`stringThe EORI number for the billing address
##### Order Item
**Name** **Type** **Description**
`id`intThe id of the order item
`variant_id`intThe variant id of the buyable (not set if the buyable is not a variant)
`product_id`intThe product id of the buyable
`buyable_type`stringThe buyable type of the order item
`buyable_id`intThe buyable id of the order item
`name`stringThe name for the order item
`url`stringThe url for the order item
`sku`stringThe sku for the order item
`reference`stringThe **unique** reference for the order item
`manufacturer`objectThe [Manufacturer](https://support.aerocommerce.com/books/api/page/order-view-endpoint#bkmrk-manufacturer) for the order item (`null` if none)
`image.url`stringThe image url for the order item
`shippable`booleanWhether the order item is shippable
`quantity`intThe quantity for the order item
`returned_quantity`intThe quantity returned for the order item
`price.amount`floatThe **unit** price of the order item **excluding tax**
`price.tax`floatThe **unit** tax for the order item
`discount.amount`floatThe **total** discount of the order item **excluding tax**
`discount.tax`floatThe **total** discount tax for the order item
`full_price.amount`floatThe **unit** full price (including extras) of the order item **excluding tax**
`full_price.tax`floatThe **unit** full tax (including extras) for the order item
`cost_price.amount`floatThe **unit** cost price of the order item **excluding tax**
`cost_price.currency`stringThe currency code for the cost price
`weight`floatThe weight for the order item
`weight_unit`floatThe weight unit for the order item, defaults to stores normalized weight unit
`volume`floatThe volume for the order item
`volume_unit`floatThe volume unit for the order item, defaults to stores normalized volume unit
`hs`stringThe HS code for the order item
`origin_country`stringThe origin country code for the order item
`goods_description`stringThe goods description for the order item
##### Manufacturer
**Name** **Type** **Description**
`id`intThe id of the manufacturer
`name`stringThe name of the manufacturer
##### Payment
**Name** **Type** **Description**
`id`intThe id of the payment
`method`objectThe [Payment Method](https://support.aerocommerce.com/books/api/page/order-view-endpoint#bkmrk-payment-method) for the payment
`reference`stringThe reference for the payment
`state`stringThe state of the payment
`amount`floatThe total amount for the payment
`currency`stringThe currency code for the payment
`captured_at`timestampThe date the payment was captured
##### Payment Method
**Name** **Type** **Description**
`id`intThe id of the payment method
`name`stringThe name of the payment method
`driver`stringThe driver of the payment method
##### Fulfillment
**Name** **Type** **Description**
`id`intThe id of the order return
`method`objectThe [Fulfillment Method](https://support.aerocommerce.com/books/api/page/order-view-endpoint#bkmrk-fulfillment-method) for the fulfillment
`reference`stringThe reference of the fulfillment
`state`stringThe state of the fulfillment
`mobile`stringThe mobile number for the fulfillment
`phone`stringThe phone number for the fulfillment
`tracking_code`stringThe tracking code for the fulfillment
`tracking_url`stringThe tracking url for the fulfillment
`weight`floatThe weight for the fulfillment
`weight_unit`stringThe weight unit for the fulfillment, defaults to stores normalized weight unit
`volume`floatThe volume for the order item
`volume_unit`stringThe volume unit for the fulfillment, defaults to stores normalized volume unit
`delivery_note`stringThe delivery note for the fulfillment
`created_at`timestampThe date the fulfillment was made
`items`arrayAn array of [Fulfillment Items](https://support.aerocommerce.com/books/api/page/order-view-endpoint#bkmrk-fulfillment-items) objects
##### Fulfillment Method
**Name** **Type** **Description**
`id`intThe id of the fulfillment method
`name`stringThe name of the fulfillment method
`driver`stringThe driver of the fulfillment method
##### Fulfillment Items
**Name** **Type** **Description**
`id`intThe id of the order item that was fulfilled
`quantity`intThe quantity of the order item that was fulfilled
##### Return
**Name** **Type** **Description**
`id`intThe id of the order return
`reason`stringThe reason for the return - `null` if no reason given
`created_at`timestampThe date the return was made
`items`arrayAn array of [Return Item](https://support.aerocommerce.com/books/api/page/order-view-endpoint#bkmrk-return-item) objects
##### Return Item
**Name** **Type** **Description**
`id`intThe id of the order item that was returned
`quantity`intThe quantity of the order item that was returned
`exchanged_for_id`intThe id of the order item that the item was returned for (`null` if the item was not exchanged)
##### Comment
**Name** **Type** **Description**
`admin`objectThe [Admin](https://support.aerocommerce.com/books/api/page/order-view-endpoint#bkmrk-admin) who commented
`message`stringThe comment message
`customer_facing`booleanWhether the comment is customer facing
`created_at`timestampThe date the comment was created
##### Admin
**Name** **Type** **Description**
`id`intThe id of the admin
`name`stringThe name of the admin
`email`stringThe email of the admin
##### Additional Attribute
**Name** **Type** **Description**
`key`stringThe key of the additional attribute
`value`stringThe value of the additional attribute
--- #### Example Requests
Unfulfilled & Unreturned Order ``` GET /api/orders/{id|reference} ``` ```json { "id": 1, "reference": "ABC123", "email": "testing@gmail.com", "subtotal": { "amount": 84166.67, "tax": 16833.33 }, "shipping": { "amount": 83.33, "tax": 16.67 }, "discount": { "amount": 8416.67, "tax": 1683.33 }, "surcharge": { "amount": 0, "tax": 0 }, "ordered_at": "2023-09-01T09:29:41.000000Z", "deliver_on": null, "currency": "GBP", "status": { "id": 3, "name": "Successful", "state": "successful" }, "customer": { "id": 1, "name": "Test", "email": "test@gmail.com" }, "shipping_method": { "id": 1, "name": "Standard" }, "billing_address": { "id": 1, "first_name": "Aero", "last_name": "Commerce", "company": "Aero Commerce", "mobile": null, "phone": null, "line_1": "28-32 Albert Rd", "line_2": null, "city": "Middlesbrough", "zone": null, "postcode": "TS1 1QD", "reference": null, "country": "GB", "eori_number": null }, "shipping_address": { "id": 1, "first_name": "Aero", "last_name": "Commerce", "company": "Aero Commerce", "mobile": null, "phone": null, "line_1": "28-32 Albert Rd", "line_2": null, "city": "Middlesbrough", "zone": null, "postcode": "TS1 1QD", "reference": null, "country": "GB", "eori_number": null }, "items": [ { "id": 148, "name": "Sandro Paris Checked Trench Coat", "sku": "SHPMA00148-M", "product_id": 4, "variant_id": 14, "shippable": true, "quantity": 2, "price": { "amount": 42083.33, "tax": 8416.67 }, "discount": { "amount": 8416.67, "tax": 1683.33 }, "full_price": { "amount": 42083.33, "tax": 8416.67 }, "weight": 0, "volume": 0 } ], "payments": [ { "id": "a53c31f9-43bd-4fc4-b308-cded0b533a2c", "method": { "id": 1, "name": "Cash", "driver": "cash" }, "reference": "a53c31f9-43bd-4fc4-b308-cded0b533a2c", "amount": 91000, "currency": "GBP", "captured_at": "2023-09-12T10:17:03.000000Z" } ], "fulfillments": [], "returns": [], "comments": [ { "admin": { "id": 1, "name": "Admin", "email": "admin@example.com" }, "message": "This is an API message", "customer_facing": true, "created_at": "2025-09-01 09:29:41" } ] } ```
Fulfilled Order ``` GET /api/orders/{id|reference} ``` ```json { "id": 1, "reference": "ABC123", "email": "testing@gmail.com", "subtotal": { "amount": 84166.67, "tax": 16833.33 }, "shipping": { "amount": 83.33, "tax": 16.67 }, "discount": { "amount": 8416.67, "tax": 1683.33 }, "surcharge": { "amount": 0, "tax": 0 }, "currency": "GBP", "ordered_at": "2023-09-01T08:29:41.000000Z", "deliver_on": null, "status": { "id": 6, "name": "Dispatched", "state": "dispatched" }, "customer": { "id": 1, "name": "Test", "email": "test@gmail.com" }, "shipping_method": { "id": 1, "name": "Standard" }, "billing_address": { "id": 1, "first_name": "Aero", "last_name": "Commerce", "company": "Aero Commerce", "mobile": null, "phone": null, "line_1": "28-32 Albert Rd", "line_2": null, "city": "Middlesbrough", "zone": null, "postcode": "TS1 1QD", "country": "GB", "eori_number": null }, "shipping_address": { "id": 1, "first_name": "Aero", "last_name": "Commerce", "company": "Aero Commerce", "mobile": null, "phone": null, "line_1": "28-32 Albert Rd", "line_2": null, "city": "Middlesbrough", "zone": null, "postcode": "TS1 1QD", "country": "GB", "eori_number": null }, "items": [ { "id": 26, "name": "Sandro Paris Checked Trench Coat", "url": "/product/sandro-paris-checked-trench-coat-4?variant=2", "sku": "SHPMA00148-M", "reference": null, "manufacturer": { "id": 2, "name": "Sandro Paris" }, "image": { "url": "http://l9.test/storage/images/products/uaaVbTbqbZxs1FH3N28Tw0a7dc6I7Xd08DiyPAG6.jpg" }, "product_id": 4, "variant_id": 14, "buyable_type": "variant", "buyable_id": 14, "shippable": true, "quantity": 2, "returned_quantity": 0, "price": { "amount": 42083.33, "tax": 8416.67 }, "discount": { "amount": 8416.67, "tax": 1683.33 }, "full_price": { "amount": 42083.33, "tax": 8416.67 }, "weight": 0, "volume": 0, "cost_price": { "amount": null, "currency": null }, "hs": null, "origin_country": null, "goods_description": null } ], "flags": [], "payments": [ { "id": "a53c31f9-43bd-4fc4-b308-cded0b533a2c", "method": { "id": 1, "name": "Cash", "driver": "cash" }, "reference": "a53c31f9-43bd-4fc4-b308-cded0b533a2c", "state": "captured", "amount": 91000, "currency": "GBP", "captured_at": "2023-09-12T10:17:03.000000ZZ", "refunds": [] } ], "fulfillments": [ { "id": 3, "method": { "id": 1, "name": "Manual Fulfillment", "driver": "manual" }, "address": { "id": 3, "first_name": "Aero", "last_name": "Commerce", "company": "Aero Commerce", "mobile": null, "phone": null, "line_1": "28-32 Albert Rd", "line_2": null, "city": "Middlesbrough", "zone": null, "postcode": "TS1 1QD", "country": "GB", "eori_number": null }, "reference": "F3-128", "state": "successful", "mobile": null, "email": "testing@gmail.com", "tracking_code": "test tracking code", "tracking_url": null, "weight": 0, "weight_unit": null, "volume": 0, "volume_unit": "cm^3", "delivery_note": "test delivery note", "created_at": "2023-09-12T10:17:03.000000Z", "items": [ { "id": 26, "quantity": 2 } ] } ], "returns": [], "comments": [] } ```
Returned Order (Exchange) ``` GET /api/orders/{id|reference} ``` ```json { "id": 1, "reference": "ABC123", "email": "testing@gmail.com", "subtotal": { "amount": 84166.67, "tax": 16833.33 }, "shipping": { "amount": 83.33, "tax": 16.67 }, "discount": { "amount": 8416.67, "tax": 1683.33 }, "surcharge": { "amount": 0, "tax": 0 }, "currency": "GBP", "ordered_at": "2023-09-01T08:29:41.000000Z", "deliver_on": null, "status": { "id": 7, "name": "Partially Returned", "state": "partially_returned" }, "customer": { "id": 1, "name": "Test", "email": "test@gmail.com" }, "shipping_method": { "id": 1, "name": "Standard" }, "billing_address": { "id": 1, "first_name": "Aero", "last_name": "Commerce", "company": "Aero Commerce", "mobile": null, "phone": null, "line_1": "28-32 Albert Rd", "line_2": null, "city": "Middlesbrough", "zone": null, "postcode": "TS1 1QD", "country": "GB", "eori_number": null }, "shipping_address": { "id": 1, "first_name": "Aero", "last_name": "Commerce", "company": "Aero Commerce", "mobile": null, "phone": null, "line_1": "28-32 Albert Rd", "line_2": null, "city": "Middlesbrough", "zone": null, "postcode": "TS1 1QD", "country": "GB", "eori_number": null }, "items": [ { "id": 26, "name": "Sandro Paris Checked Trench Coat", "url": "/product/sandro-paris-checked-trench-coat-4?variant=2", "sku": "SHPMA00148-M", "reference": null, "manufacturer": { "id": 2, "name": "Sandro Paris" }, "image": { "url": "http://l9.test/storage/images/products/uaaVbTbqbZxs1FH3N28Tw0a7dc6I7Xd08DiyPAG6.jpg" }, "product_id": 4, "variant_id": 14, "buyable_type": "variant", "buyable_id": 14, "shippable": true, "quantity": 2, "returned_quantity": 0, "price": { "amount": 42083.33, "tax": 8416.67 }, "discount": { "amount": 8416.67, "tax": 1683.33 }, "full_price": { "amount": 42083.33, "tax": 8416.67 }, "weight": 0, "volume": 0, "cost_price": { "amount": null, "currency": null }, "hs": null, "origin_country": null, "goods_description": null } ], "flags": [], "payments": [ { "id": "a53c31f9-43bd-4fc4-b308-cded0b533a2c", "method": { "id": 1, "name": "Cash", "driver": "cash" }, "reference": "a53c31f9-43bd-4fc4-b308-cded0b533a2c", "state": "captured", "amount": 91000, "currency": "GBP", "captured_at": "2023-09-12T10:17:03.000000ZZ", "refunds": [] } ], "fulfillments": [], "returns": [ { "id": 1, "reason": "Test Reason", "created_at": "2023-09-12T10:17:03.000000ZZ", "items": [ { "id": 26, "quantity": 2, "exchanged_for_id": 27 } ] } ], "comments": [] } ```
Returned Order (Refund) ``` GET /api/orders/{id|reference} ``` ```json { "id": 1, "reference": "ABC123", "email": "testing@gmail.com", "subtotal": { "amount": 84166.67, "tax": 16833.33 }, "shipping": { "amount": 83.33, "tax": 16.67 }, "discount": { "amount": 8416.67, "tax": 1683.33 }, "surcharge": { "amount": 0, "tax": 0 }, "currency": "GBP", "ordered_at": "2023-09-01T08:29:41.000000Z", "deliver_on": null, "status": { "id": 8, "name": "Returned", "state": "returned" }, "customer": { "id": 1, "name": "Test", "email": "test@gmail.com" }, "shipping_method": { "id": 1, "name": "Standard" }, "billing_address": { "id": 1, "first_name": "Aero", "last_name": "Commerce", "company": "Aero Commerce", "mobile": null, "phone": null, "line_1": "28-32 Albert Rd", "line_2": null, "city": "Middlesbrough", "zone": null, "postcode": "TS1 1QD", "country": "GB", "eori_number": null }, "shipping_address": { "id": 1, "first_name": "Aero", "last_name": "Commerce", "company": "Aero Commerce", "mobile": null, "phone": null, "line_1": "28-32 Albert Rd", "line_2": null, "city": "Middlesbrough", "zone": null, "postcode": "TS1 1QD", "country": "GB", "eori_number": null }, "items": [ { "id": 26, "name": "Sandro Paris Checked Trench Coat", "url": "/product/sandro-paris-checked-trench-coat-4?variant=2", "sku": "SHPMA00148-M", "reference": null, "manufacturer": { "id": 2, "name": "Sandro Paris" }, "image": { "url": "http://l9.test/storage/images/products/uaaVbTbqbZxs1FH3N28Tw0a7dc6I7Xd08DiyPAG6.jpg" }, "product_id": 4, "variant_id": 14, "buyable_type": "variant", "buyable_id": 14, "shippable": true, "quantity": 2, "returned_quantity": 0, "price": { "amount": 42083.33, "tax": 8416.67 }, "discount": { "amount": 8416.67, "tax": 1683.33 }, "full_price": { "amount": 42083.33, "tax": 8416.67 }, "weight": 0, "volume": 0, "cost_price": { "amount": null, "currency": null }, "hs": null, "origin_country": null, "goods_description": null } ], "flags": [], "payments": [ { "id": "a53c31f9-43bd-4fc4-b308-cded0b533a2c", "method": { "id": 1, "name": "Cash", "driver": "cash" }, "reference": "a53c31f9-43bd-4fc4-b308-cded0b533a2c", "state": "captured", "amount": 91000, "currency": "GBP", "captured_at": "2023-09-12T10:17:03.000000ZZ", "refunds": [ { "id": 1, "amount": 91000, "created_at": "2025-09-16T07:40:22.000000Z" } ] } ], "fulfillments": [], "returns": [ { "id": 1, "reason": "Test reason", "created_at": "2025-09-16T07:40:22.000000Z", "items": [ { "id": 28, "quantity": 2, "exchanged_for_id": null } ] } ], "comments": [] } ```