> For the complete documentation index, see [llms.txt](https://developers.accesstrade.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.accesstrade.vn/api-publisher-vietnamese/lay-danh-sach-don-hang-v2.md).
# Lấy danh sách đơn hàng v2
**Method: GET**
#### HTTP Request
```
https://api.accesstrade.vn/v1/order-list
```
#### \*Lưu ý:
* Limit : 10 requests/1 phút
* Cache 1 phút
#### Query Parameters
Các biến params được truyền vào HTTP Request theo các cặp Key-Value, mở đầu chuỗi params bằng dấu “?” và giữa các biến phân tách nhau bằng dấu “&”. Vd:
```
https://api.accesstrade.vn/v1/order-list?since=2021-01-01T00:00:00Z&until=2021-01-10T00:00:00Z
```
| Biến params | Required | Mô tả |
| ------------- | -------- | ------------------------------------------------------------------------------------------------------------ |
| since | bắt buộc | Thời gian bắt đầu report, theo ISO format, ví dụ “2016-08-01T00:00:00Z”. |
| until | bắt buộc | Thời gian kết thúc report, theo ISO format, ví dụ “2016-08-02T00:00:00Z”. |
| page | tùy chọn | Thứ tự page. Bắt đầu từ 1. Mặc định 1 |
| utm\_source | tùy chọn | Ex: facebook |
| utm\_campaign | tùy chọn | |
| utm\_medium | tùy chọn | Ex: email |
| utm\_content | tùy chọn | |
| limit | tùy chọn | Số lượng đơn hàng trả về mỗi page. Mặc định 30. Tối đa 300 (nếu điền quá 300 thì mặc định set 300) |
| status | tùy chọn | Trạng thái của conversion
- 0: Pending or hold
- 1: Approved
- 2:Rejected.
|
| merchant | tùy chọn | Vi dụ: adayroi, lazada. |
> API response trả về
```
{
"data":
[
{
"at_product_link": "https://shopee.vn/universal-link/product/214196144/17730719201?utm_campaign=&c=679&af_reengagement_window=7d&af_click_lookback=7d&smtt=0.549607455-1653894909.9&utm_content=XDbU5H4Qjy87NtFmlCNrsEo4jtBMzjvPRv3EON3JTvinCYXR-540355-679-IG-&af_siteid=an_17156540000&pid=affiliates&utm_source=an_17156540000&is_retargeting=true&referer=at-kol-new&af_sub_siteid=540355&utm_medium=affiliates&af_viewthrough_lookback=1d&atnct1=ca9c267dad0305d1a6308d2a0cf1c39c&atnct2=XDbU5H4Qjy87NtFmlCNrsEo4jtBMzjvPRv3EON3JTvinCYXR&atnct3=h50RJ00079r00bkxv",
"billing": 69000.0,
"browser": "Mobile Safari UI/WKWebView",
"category_name": "Fashion_Accessories",
"click_time": "2022-05-31T00:28:09",
"client_platform": "mobile",
"confirmed_time": "2022-07-01T23:59:31",
"conversion_platform": null,
"customer_type": null,
"is_confirmed": 0,
"landing_page": "https://www.instagram.com/",
"merchant": "shopee_kolnew",
"order_id": "220602QAVKQKCM",
"order_pending": 0,
"order_reject": 0,
"order_approved": 1,
"product_category": "Phu_Kien_Thoi_Trang",
"products_count": 1,
"pub_commission": 2208.0,
"sales_time": "2022-06-01T23:59:31",
"update_time": "2022-07-07T10:23:13",
"utm_campaign": null,
"utm_content": null,
"utm_medium": null,
"utm_source": "IG",
"website": "https://www.instagram.com/",
"website_url": "https://www.instagram.com/"
}
],
"total": 589
}
```
**Mô tả kết quả:**
| **Tham số** | **Mô tả** |
| ------------------------- | -------------------------------------------------------------------------------------------------- |
| data.at\_product\_link | Link cuối gắn các tham số tracking |
| data.billing | Giá trị đơn hàng |
| data.browser | Nền tảng phát sinh đơn hàng |
| data.category\_name | Ngành hàng |
| data.click\_time | Thời gian click |
| data.client\_platform | Thiết bị |
| data.confirmed\_time | Thời gian xác nhận giao dịch |
| data.conversion\_platform | |
| data.customer\_type | |
| data.is\_confirmed | Trạng thái duyệt đối soát giao dịch:
- 0 - chưa duyệt
- 1 - đã duyệt
|
| data.landing\_page | |
| data.merchant | Tên merchant |
| data.order\_id | ID đơn hàng |
| data.order\_pending | Trạng thái đơn hàng (tổng số lượng item ở trạng thái pending) |
| data.order\_reject | Trạng thái đơn hàng (tổng số lượng item ở trạng thái reject) |
| data.order\_approved | Trạng thái đơn hàng (tổng số lượng item ở trạng thái approved) |
| data.product\_category | Ngành hàng của sản phẩm |
| data.products\_count | Số lượng sản phẩm |
| data.pub\_commission | Hoa hồng cho publisher |
| data.sales\_time | Thời gian phát sinh |
| data.update\_time | Thời gian cập nhật |
| data.utm\_campaign | utm\_campaign |
| data.utm\_content | utm\_content |
| data.utm\_medium | utm\_medium |
| data.utm\_source | utm\_source |
| data.website | Website nguồn |
| data.website\_url | Đường dẫn đến website nguồn |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://developers.accesstrade.vn/api-publisher-vietnamese/lay-danh-sach-don-hang-v2.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.