Get AceDataCloud Platform Order Details

Retrieve the complete information of a single order by order ID—providing more fields for associated objects such as application, service, package, etc., as well as the currently available payment_url (only for Pending orders).

ℹ️ This interface belongs to the AceDataCloud Platform Management API, with a unified prefix of https://platform.acedata.cloud/api/v1/. For the complete interface index, see Get AceDataCloud Platform Documentation List.

Interface Overview

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

⚠️ The URL should not have a trailing slash—/orders/{id} is not /orders/{id}/.

Authentication Instructions (How to Obtain Account Token)

Request Header:

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

For obtaining the token, see Manage AceDataCloud Platform Account Token.

Path Parameters

Parameter Type Required Description
order_id UUID ✅ Order ID

Request Example

cURL

curl 'https://platform.acedata.cloud/api/v1/orders/fa927d12-3b04-4f51-bf2e-ec3a5a7d9b2c' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer platform-v1-92eb****629c'

Python

import requests

order_id = "fa927d12-3b04-4f51-bf2e-ec3a5a7d9b2c"
resp = requests.get(
    f"https://platform.acedata.cloud/api/v1/orders/{order_id}",
    headers={"authorization": "Bearer platform-v1-92eb****629c"},
    timeout=10,
)
order = resp.json()
print(f"Order: {order['service']['title']} - {order['package']['amount']} {order['service']['unit']}")
print(f"Status: {order['state']} - ¥{order['final_price']}")
if order['state'] == "Pending":
    print("⚠️ Order not paid")

Node.js

const orderId = 'fa927d12-3b04-4f51-bf2e-ec3a5a7d9b2c'
const r = await fetch(`https://platform.acedata.cloud/api/v1/orders/${orderId}`, {
  headers: { authorization: 'Bearer platform-v1-92eb****629c' },
})
console.log(await r.json())

Response Example (HTTP 200)

{
  "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"
  },
  "application": {
    "id": "82f57141-2323-4453-8730-60f7d833a2da",
    "remaining_amount": 100.0
  },
  "package": {
    "id": "4add61f2-61db-4d1c-85b6-d4876ac122f0",
    "type": "Usage",
    "price": 63.2,
    "amount": 530.0
  }
}

Response Field Descriptions

The meanings of the fields are the same as in Order List, with additional details for the application / service / package associated objects.

Error Handling

HTTP Code Meaning
401 not_authenticated Missing account token
403 permission_denied Order does not belong to you
404 not_found Order does not exist
500 — Trailing slash mistakenly added to URL, remove it and retry

Practical Tips

  • To get the payment link: Use the Pay AceDataCloud Platform Order interface instead of this one—this interface only returns a snapshot and does not refresh the payment link.
  • To determine if the order is effective: Use state="Paid" along with paid_at. After paid_at is recorded, the Application's remaining_amount generally increases within a few seconds.
  • If state="Pending" exceeds 24 hours: It is recommended to poll Refresh Order Status or give up directly.