Get AceDataCloud Platform Service Application Details

Obtain the complete status of a single service application through the Application ID—providing a complete service object (including packages), credentials_count, and other fields, suitable for detail pages.

ℹ️ 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/applications/{application_id}
Authentication ✅ Requires account token

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

Authentication Instructions (How to Obtain Account Token)

Request Header:

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

For detailed acquisition methods, see Manage AceDataCloud Platform Account Token.

ℹ️ Unlike the list interface, the detail interface's permission verification is done directly on a single object, and there is no need to pass ?user_id=. However, accessing someone else's application will result in 403 permission_denied.

Path Parameters

Parameter Type Required Description
application_id UUID ✅ Application ID

Request Example

cURL

curl 'https://platform.acedata.cloud/api/v1/applications/82f57141-2323-4453-8730-60f7d833a2da' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer platform-v1-92eb****629c'

Python

import requests

app_id = "82f57141-2323-4453-8730-60f7d833a2da"
resp = requests.get(
    f"https://platform.acedata.cloud/api/v1/applications/{app_id}",
    headers={
        "accept": "application/json",
        "authorization": "Bearer platform-v1-92eb****629c",
    },
    timeout=10,
)
app = resp.json()
print(f"Service: {app['service']['title']}")
print(f"Remaining {app['remaining_amount']} {app['service']['unit']} / Used {app['used_amount']}")
print(f"Number of issued credentials: {app.get('credentials_count', 0)}")

Node.js

const appId = '82f57141-2323-4453-8730-60f7d833a2da'
const r = await fetch(`https://platform.acedata.cloud/api/v1/applications/${appId}`, {
  headers: { authorization: 'Bearer platform-v1-92eb****629c' },
})
console.log(await r.json())

Response Example (HTTP 200)

{
  "id": "82f57141-2323-4453-8730-60f7d833a2da",
  "service_id": "38ecf158-36f2-42f2-8e7f-6786cdfc2452",
  "remaining_amount": 100.0,
  "used_amount": 12.34,
  "paid": true,
  "user_id": "89518d07-5560-4b05-92c1-667f3ddf6a4b",
  "disabled": false,
  "allow_consume_global": false,
  "scope": "Individual",
  "type": "Usage",
  "expired_at": null,
  "tags": null,
  "metadata": null,
  "credentials_count": 3,
  "service": {
    "id": "38ecf158-36f2-42f2-8e7f-6786cdfc2452",
    "alias": "openai",
    "title": "OpenAI",
    "type": "Api",
    "unit": "Credit",
    "free_amount": 1.0,
    "packages": [
      { "id": "...", "type": "Usage", "price": 10.0, "amount": 100.0 }
    ]
  },
  "created_at": "2026-04-26T07:52:27.462400Z",
  "updated_at": "2026-04-26T08:42:13.123456Z"
}

Response Field Descriptions

The meanings of the fields are the same as in the list interface, with additional fields:

Field Type Description
credentials_count integer The current number of API credentials issued for this Application
service object The complete service object (including packages, unit, free_amount), which can be directly rendered in the service detail panel

Error Handling

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

Practical Tips

  • The detail interface is more expensive than the list: It will run additional associated queries. If you only need periodic balance monitoring, use the list interface with ?low_balance=true.
  • credentials_count=0 is normal: Just applied and credentials have not yet been created. At this time, jump to Create AceDataCloud Platform API Credentials.
  • disabled=true troubleshooting ideas: Check work orders / email notifications to see if it has been suspended due to risk control, arrears, or violation of calling rules; it cannot be lifted through the API and must contact customer service.