Get one top-up (404 if other tenant)

GET

/api/v1/top-ups/{id}

Hard rate limit: 10 requests / second per API client for this path. Over limit → 429 RATE_LIMITED + Retry-After.

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

Item

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "ok",
    "data": {
        "item": {
            "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
            "invoice_number": 10001,
            "status": "complete",
            "ad_account_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "ad_account_name": "Demo Ad Account",
            "ad_account_meta_id": "123456789012345",
            "amount": 100,
            "amount_paid": 100,
            "currency_code": "USD",
            "converted_from_code": "USD",
            "client_number": "C0001",
            "created_at": "2026-10-01T00:00:00.000Z",
            "updated_at": "2026-10-02T00:00:00.000Z"
        }
    },
    "request_id": "string"
}

🟠404

🟠429

修改于 2026-10-28 06:35:53

List top-ups for token-bound client

List clear/deduct tickets for token-bound client