Get the qiyaov Platform Order List

Returns the account's top-up orders in pages, suitable for finding order IDs, checking payment status, and reconciliation.

Preparation

Create an Account Token, and obtain the current account UUID from GET /api/v1/platform-tokens/me/.

export PLATFORM_TOKEN='your account token'
export USER_ID='your account UUID'

API Overview

Item Content
Method GET
URL https://api17.platform.acedata.cloud/api/v1/orders/
Authentication Account Token, OAuth token requires orders:read
Pagination count + items

Regular users must provide their own user_id; otherwise, the pagination may return 403 when encountering unauthorized objects.

Query Parameters

Parameter Type Required Description
user_id UUID Required for regular users The account to which the order belongs; supports repeated parameters
pay_way string No Filter by payment method; supports repeated or comma-separated values
state string No Filter by status; supports repeated or comma-separated values
created_at_from/to datetime No Creation time range
finished_at_from/to datetime No Completion time range
limit / offset integer No Pagination
ordering string No created_at, -created_at, finished_at, or -finished_at

The current list does not support filtering by application_id, service_id, package_id, payment_method, or tag; the payment method field name is pay_way.

curl --get 'https://api17.platform.acedata.cloud/api/v1/orders/' \
  --data-urlencode "user_id=${USER_ID}" \
  --data-urlencode 'state=Paid,Finished' \
  --data-urlencode 'pay_way=Stripe' \
  --data-urlencode 'limit=100' \
  -H "Authorization: Bearer ${PLATFORM_TOKEN}"

Response Description

The response is {count, items}. Production list items contain id, user_id, application_id/application_ids, package_id/package_ids, price, amount, discount, remaining_amount, state, pay_way, pay_id, pay_url, finished_at, expired_at, invoice, metadata, and time fields.

  • The actual statuses are Pending, Paid, Finished, Expired, Failed, and Refunded; there is no Cancelled.
  • The field names are pay_way, finished_at, discount, and price, not payment_method, paid_at, discount_rate, or final_price.
  • price is the final price recorded for the order; currency and settlement details may be located in controlled metadata and cannot be inferred solely from the payment method.