Get AceDataCloud Platform Order List

Returns the complete Recharge Order (Order) list for the current account, including order status, amount, package, payment method, and other information—serving as both historical bills and an entry for unpaid orders.

ℹ️ This interface belongs to the AceDataCloud Platform Management API, with a unified prefix of https://platform.acedata.cloud/api/v1/.

¶ Interface Overview

Item	Content
Method	`GET`
URL	`https://platform.acedata.cloud/api/v1/orders/`
Authentication	✅ Requires account token

¶ Authentication Instructions (How to Obtain Account Token)

Request Header:

Authorization: Bearer platform-v1-92eb****629c

How to obtain: Log in to the AceDataCloud Platform → Account Token Console → Click the "Create" button. For details, see Manage AceDataCloud Platform Account Tokens.

¶ Required Query Parameters

⚠️ The list interface requires mandatory ?user_id=<your_user_id>. Otherwise, it returns 403 permission_denied.

Obtain user_id: Open https://auth.acedata.cloud/user/profile.

¶ Query Parameters

Parameter	Type	Required	Default	Description
`user_id`	UUID	✅	—	Current account user ID
`application_id`	UUID	No	—	Filter by Application
`service_id`	UUID	No	—	Filter by service
`package_id`	UUID	No	—	Filter by package
`state`	string	No	—	Order status: `Pending` / `Paid` / `Failed` / `Refunded` / `Cancelled`
`payment_method`	string	No	—	Payment method: `AliPay` / `WeChat` / `Stripe` / `Paypal` / `Crypto` / `X402`
`tag`	string	No	—	Filter by tag
`limit`	integer	No	10	Number of items per page, maximum 100
`offset`	integer	No	0	Offset
`ordering`	string	No	—	Sorting field, prefix `-` for descending order. Commonly used `-created_at`, `-paid_at`, `-price`

¶ Request Example

¶ cURL

USER_ID=89518d07-5560-4b05-92c1-667f3ddf6a4b
curl "https://platform.acedata.cloud/api/v1/orders/?user_id=${USER_ID}&limit=20&state=Paid" \
  -H 'accept: application/json' \
  -H 'authorization: Bearer platform-v1-92eb****629c'

¶ Python

import requests

PLATFORM_TOKEN = "platform-v1-92eb****629c"
USER_ID = "89518d07-5560-4b05-92c1-667f3ddf6a4b"

resp = requests.get(
    "https://platform.acedata.cloud/api/v1/orders/",
    headers={"authorization": f"Bearer {PLATFORM_TOKEN}"},
    params={"user_id": USER_ID, "state": "Paid", "limit": 100},
    timeout=10,
)
data = resp.json()
print(f"Total paid orders: {data['count']}")
total_spent = sum(o["price"] for o in data["items"])
print(f"Total spent: ¥{total_spent:.2f}")

¶ Node.js

const USER_ID = '89518d07-5560-4b05-92c1-667f3ddf6a4b'
const url = new URL('https://platform.acedata.cloud/api/v1/orders/')
url.searchParams.set('user_id', USER_ID)
url.searchParams.set('state', 'Pending')

const r = await fetch(url, {
  headers: { authorization: 'Bearer platform-v1-92eb****629c' },
})
console.log(await r.json())

¶ Response Example (HTTP 200)

{
  "count": 3,
  "items": [
    {
      "id": "fa927d12-3b04-4f51-bf2e-ec3a5a7d9b2c",
      "user_id": "89518d07-5560-4b05-92c1-667f3ddf6a4b",
      "application_id": "82f57141-2323-4453-8730-60f7d833a2da",
      "service_id": "38ecf158-36f2-42f2-8e7f-6786cdfc2452",
      "package_id": "4add61f2-61db-4d1c-85b6-d4876ac122f0",
      "type": "Usage",
      "state": "Paid",
      "price": 63.2,
      "amount": 530.0,
      "currency": "CNY",
      "payment_method": "AliPay",
      "discount_rate": 1.0,
      "discount_amount": 0.0,
      "final_price": 63.2,
      "metadata": null,
      "tags": null,
      "paid_at": "2026-04-26T08:01:23Z",
      "expired_at": null,
      "refunded_at": null,
      "created_at": "2026-04-26T08:00:00Z",
      "updated_at": "2026-04-26T08:01:23Z",
      "service": {
        "id": "38ecf158-36f2-42f2-8e7f-6786cdfc2452",
        "alias": "openai",
        "title": "OpenAI",
        "unit": "Credit"
      },
      "package": {
        "id": "4add61f2-61db-4d1c-85b6-d4876ac122f0",
        "type": "Usage",
        "price": 63.2,
        "amount": 530.0
      }
    }
  ]
}

¶ Response Field Description

Field	Type	Description
`id`	UUID	Order ID
`user_id`	UUID	Associated user
`application_id`	UUID	Related Application
`service_id`	UUID	Related service
`package_id`	UUID	Related package
`type`	string	Package type: `Usage` (pay-as-you-go) / `Subscription` (subscription) / `Wallet` (wallet recharge)
`state`	string	`Pending` / `Paid` / `Failed` / `Refunded` / `Cancelled`
`price`	number	Package listed price (excluding discounts)
`amount`	number	Corresponding amount of the package
`currency`	string	Currency: `CNY`, `USD`, `USDC`, `SOL`, etc.
`payment_method`	string	Payment method
`discount_rate`	number	Discount rate (1.0 = no discount)
`discount_amount`	number	Amount reduced after discount
`final_price`	number	Actual transaction price (=`price - discount_amount`)
`paid_at`	string	null
`expired_at`	string	null
`refunded_at`	string	null
`created_at`	string	Order creation time
`updated_at`	string	Last status change time
`service`	object	Simplified object of the related service
`package`	object	Simplified object of the related package

¶ Error Handling

HTTP	code	Meaning
401	`not_authenticated`	Missing account token
403	`permission_denied`	Did not provide `?user_id=` or provided someone else's `user_id`

¶ Practical Tips

Unpaid orders can continue to be paid: Orders with state=Pending can be paid through Pay AceDataCloud platform order, or check for expiration by refreshing order status.
Statistics on expenses: By state=Paid&payment_method=AliPay, you can generate a monthly bill for the Alipay channel, combined with ?ordering=-paid_at to view recent transactions in reverse order.
Annual compliance audit: Export all orders with state=Paid as CSV, as annual procurement proof.
final_price vs price: Generally use final_price (actual payment amount) for reimbursements.