# Cancellation & Refund Pending Orders

Orders pending cancellation, return confirmation (LIST):

## <mark style="color:red;">`GET`</mark> <mark style="color:red;">Cancel & Refund Pending Orders</mark>

**Path:** `/api/i1/orders/?limit=10&page=1&cancel_status=waiting`

Sample HTTP request to retrieve only cancellation and refund pending orders.

* `count` shows how many orders exist in the system.
* `next` shows the next page url to retrieve the desired order data.
* `previous` shows the previous page url to retrieve the desired order data.
* `results` shows every order property with detailed field descriptions.

**Example Request**

```python
import requests

url = "https://{customer_api_url}/api/i1/orders/"
api_token = "f532eXXXXXXXXXXXXXXXXX201XXXXX9332d"

headers = {
   'content-type': 'application/json',
   'Authorization': 'Token {}'.format(api_token)
}
params = {
   'cancel_status: 'waiting',
   'limit': 10,
   'page': 1,
}

response = requests.get(url, headers=headers , params=params)
print(response.text)
```

**Example Response**

Shows desired orders. All parameters of an order are described in the table below.

<table data-header-hidden><thead><tr><th width="157.38671875"></th><th width="133.65625"></th><th></th></tr></thead><tbody><tr><td><strong>Property</strong></td><td><strong>Data Type</strong></td><td><strong>Description</strong></td></tr><tr><td>number</td><td>integer</td><td>Order code</td></tr><tr><td>status</td><td>string</td><td>Status of order in the current time. Order statuses are predefined. You can look up for meaning of the status in the Order Status section</td></tr><tr><td>date_placed</td><td>iso date str</td><td>Created date of the order</td></tr><tr><td>customer</td><td>dict</td><td>Related Customer object. See the Customer section for more details about the fields in the customer dictionary.</td></tr><tr><td>shipping_address</td><td>dict</td><td>Related Address object. See the Address section for more details about the fields in the shipping_address dictionary.</td></tr><tr><td>billing_address</td><td>dict</td><td>Related Address object. See the Address section for more details about the fields in the billing_address dictionary.</td></tr><tr><td>currency</td><td>string</td><td>Currency type of the transaction. Currency types are predefined. Every currency type is a global abbreviation of the currency.</td></tr><tr><td>amount</td><td>string</td><td>Amount of the order</td></tr><tr><td>shipping_amount</td><td>string</td><td>Shipping amount of the order</td></tr><tr><td>shipping_tax_rate</td><td>string</td><td>Shipping tax rate of the order</td></tr><tr><td>extra_field</td><td>dict</td><td>Usage of extra information.</td></tr><tr><td>payment_option</td><td>int</td><td>Related Payment Option object ID. See the Payments section for more information.</td></tr><tr><td>payment_option_slug</td><td>string</td><td>Unique slug information related to the Payment Option object.</td></tr><tr><td>bin_number</td><td>string</td><td>Bin Number</td></tr><tr><td>installment</td><td>int</td><td>Related Installment object id. See the Payments section for more information</td></tr><tr><td>installment_count</td><td>int</td><td>Installment count information related to the Installment object.</td></tr><tr><td>installment_interest_amount</td><td>string</td><td>Calculated by (amount of the order * installment interest rate)<br>Installment interest rate is the related Installment object info.</td></tr><tr><td>cargo_company</td><td>int</td><td>Related Cargo Company object ID</td></tr><tr><td>invoice_number</td><td>string</td><td>Invoice number</td></tr><tr><td>invoice_date</td><td>Iso date str</td><td>Invoice date</td></tr><tr><td>e_archieve_url</td><td>Url field str</td><td>e archive url info</td></tr><tr><td>refund_amount</td><td>string</td><td>Refund amount</td></tr><tr><td>discount_refund_amount</td><td>string</td><td>Discount refund amount</td></tr><tr><td>shipping_refund_amount</td><td>string</td><td>Shipping refund amount</td></tr><tr><td>shipping_refund_amount</td><td>string</td><td>Shipping refund amount</td></tr><tr><td>discount_amount</td><td>string</td><td>Discount amount</td></tr><tr><td>is_send</td><td>boolean</td><td>True means order sent to ERP.</td></tr><tr><td>net_shipping _amount</td><td>string</td><td>Net shipping amount. (Shipping amount + Shipping Interest Amount)</td></tr><tr><td>shipping_interest_amount</td><td>string</td><td>Shipping Interest amount</td></tr><tr><td>tracking_number</td><td>string</td><td>Tracking number for cargo integration</td></tr><tr><td>carrier_shipping_code</td><td>string</td><td>Shipping code for cargo integration</td></tr><tr><td>remote_addr</td><td>string</td><td>Generic IP address for the orders created.</td></tr><tr><td>has_gift_box</td><td>boolean</td><td>Gift Box is selected or not</td></tr><tr><td>gift_box_note</td><td>string</td><td>Note for the gift box</td></tr><tr><td>external_status</td><td>int</td><td>Related Order External Status object ID.</td></tr><tr><td>orderitem_set</td><td>list</td><td>Each element is the related Order Item object. See the Order Item section for more information.</td></tr><tr><td>channel</td><td>dict</td><td>Related Channel object. See the Channel section for more information.</td></tr></tbody></table>

```json
{
    "count": 2,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 32,
            "number": "d4d10357bbf314b0",
            "status": "450",
            "date_placed": "2017-02-01T14:45:47.033367Z",
            "customer": {
                "id": 1104,
                "email": "samplemail@akinon.com",
                "first_name": "John",
                "last_name": "Doe",
                "phone_number": null
            },
            "shipping_address": {
                "email": "samplemail@akinon.com",
                "phone_number": "9999999999",
                "first_name": "John",
                "last_name": "Doe",
                "country": {
                    "name": "Turkey",
                    "code": "tr"
                },
                "city": {
                    "id": 62,
                    "name": "İstanbul"
                },
                "line": "line",
                "title": "title",
                "township": {
                    "id": 156,
                    "name": "SARIYER"
                },
                "district": null,
                "postcode": "31213",
                "notes": null,
                "company_name": null,
                "tax_office": null,
                "tax_no": null,
                "e_bill_taxpayer": false,
                "identity_number": null,
                "extra_field": {}
            },
            "billing_address": {
                "email": "samplemail@akinon.com",
                "phone_number": "9999999999",
                "first_name": "John",
                "last_name": "Doe",
                "country": {
                    "name": "Turkey",
                    "code": "tr"
                },
                "city": {
                    "id": 62,
                    "name": "İstanbul"
                },
                "line": "line",
                "title": "title",
                "township": {
                    "id": 156,
                    "name": "SARIYER"
                },
                "district": null,
                "postcode": "31213",
                "notes": null,
                "company_name": null,
                "tax_office": null,
                "tax_no": null,
                "e_bill_taxpayer": false,
                "identity_number": null,
                "extra_field": {}
            },
            "currency": "try",
            "amount": "11.40",
            "shipping_amount": "8.50",
            "shipping_tax_rate": null,
            "extra_field": {
                "cargo_line_id": "a55a2b33-434f-4cb6-b369-a70f00860df1"
            },
            "payment_option": 2,
            "payment_option_slug": "kredi_karti",
            "bin_number": "454360",
            "installment": 22,
            "installment_count": 1,
            "installment_interest_amount": "0.00",
            "cargo_company": 1,
            "invoice_number": null,
            "invoice_date": null,
            "e_archive_url": null,
            "refund_amount": "0.00",
            "discount_refund_amount": "0.00",
            "shipping_refund_amount": "0.00",
            "discount_amount": "0.00",
            "is_send": true,
            "net_shipping_amount": "8.50",
            "shipping_interest_amount": "0.00",
            "tracking_number": null,
            "carrier_shipping_code": null,
            "remote_addr": null,
            "has_gift_box": false,
            "gift_box_note": null,
            "external_status": null,
            "orderitem_set": [
                {
                    "id": 118,
                    "order": 32,
                    "product_sku": "2672881094195",
                    "status": "450",
                    "price_currency": "try",
                    "price": "2.90",
                    "tax_rate": "18.00",
                    "extra_field": {},
                    "price_list": 1,
                    "stock_list": 1,
                    "cancel_status": null,
                    "invoice_number": null,
                    "invoice_date": null,
                    "e_archive_url": null,
                    "installment_interest_amount": "0.00",
                    "tracking_number": null,
                    "carrier_shipping_code": null,
                    "shipping_company": null,
                    "shipment_code": null,
                    "external_status": null,
                    "discount_amount": "0.00",
                    "retail_price": null,
                    "attributes": {},
                    "attributes_kwargs": {},
                    "image": null
                }
            ],
            "channel": {
                "name": "Shop",
                "conf": {
                    "server": "http://localhost:8080/api/v1/"
                }
            }
        },
        {
            "id": 33,
            "number": "95d4deb15760461",
            "status": "50",
            "date_placed": "2017-02-02T11:06:57.973468Z",
            "customer": {
                "id": 1105,
                "email": "samplemail@akinon.com",
                "first_name": "John",
                "last_name": "Doe",
                "phone_number": null
            },
            "shipping_address": {
                "email": "samplemail@akinon.com",
                "phone_number": "9999999999",
                "first_name": "Akinon",
                "last_name": "Şirket",
                "country": {
                    "name": "Turkey",
                    "code": "tr"
                },
                "city": {
                    "id": 65,
                    "name": "Adıyaman"
                },
                "line": "line",
                "title": "Adres Ev",
                "township": {
                    "id": 576,
                    "name": "ÇELİKHAN"
                },
                "district": {
                    "id": 3993,
                    "name": "MERKEZ"
                },
                "postcode": "34170",
                "notes": null,
                "company_name": null,
                "tax_office": null,
                "tax_no": null,
                "e_bill_taxpayer": false,
                "identity_number": null,
                "extra_field": {}
            },
            "billing_address": {
                "email": "samplemail@akinon.com",
                "phone_number": "9999999999",
                "first_name": "Akinon",
                "last_name": "Şirket",
                "country": {
                    "name": "Turkey",
                    "code": "tr"
                },
                "city": {
                    "id": 65,
                    "name": "Adıyaman"
                },
                "line": "line",
                "title": "Adres Ev",
                "township": {
                    "id": 576,
                    "name": "ÇELİKHAN"
                },
                "district": {
                    "id": 3993,
                    "name": "MERKEZ"
                },
                "postcode": "34170",
                "notes": null,
                "company_name": null,
                "tax_office": null,
                "tax_no": null,
                "e_bill_taxpayer": false,
                "identity_number": null,
                "extra_field": {}
            },
            "currency": "try",
            "amount": "33.22",
            "shipping_amount": "8.50",
            "shipping_tax_rate": null,
            "extra_field": {
                "cargo_line_id": "33c7d761-0b65-451d-bbbf-a70f00860fdb"
            },
            "payment_option": 2,
            "payment_option_slug": "kredi_karti",
            "bin_number": "454359",
            "installment": 22,
            "installment_count": 1,
            "installment_interest_amount": "0.00",
            "cargo_company": 1,
            "invoice_number": null,
            "invoice_date": null,
            "e_archive_url": null,
            "refund_amount": "0.00",
            "discount_refund_amount": "0.00",
            "shipping_refund_amount": "0.00",
            "discount_amount": "0.00",
            "is_send": true,
            "net_shipping_amount": "8.50",
            "shipping_interest_amount": "0.00",
            "tracking_number": null,
            "carrier_shipping_code": null,
            "remote_addr": null,
            "has_gift_box": false,
            "gift_box_note": null,
            "external_status": null,
            "orderitem_set": [
                {
                    "id": 119,
                    "order": 33,
                    "product_sku": "2672880307807",
                    "status": "50",
                    "price_currency": "try",
                    "price": "24.72",
                    "tax_rate": "18.00",
                    "extra_field": {},
                    "price_list": 1,
                    "stock_list": 1,
                    "cancel_status": "waiting",
                    "invoice_number": null,
                    "invoice_date": null,
                    "e_archive_url": null,
                    "installment_interest_amount": "0.00",
                    "tracking_number": null,
                    "carrier_shipping_code": null,
                    "shipping_company": null,
                    "shipment_code": null,
                    "external_status": null,
                    "discount_amount": "0.00",
                    "retail_price": null,
                    "attributes": {},
                    "attributes_kwargs": {},
                    "image": null
                }
            ],
            "channel": {
                "name": "Shop",
                "conf": {
                    "server": "http://localhost:8080/api/v1/"
                }
            }
        }
    ]
}

```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidocs.akinon.com/omnitron/integration/order/cancellation-and-refund-pending-orders.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.