Get User’s Credit Usage

POST /users/{user_id}/credits/usage

Overview

Retrieves a list of credit usage records for a specific user.

This endpoint allows clients to track how and when a user’s credits were used, including metadata such as description, amount, and timestamp.

Typical use cases

• Displaying a user’s credit usage history

• Auditing credit consumption for a given period

Header

Name	Value
Content-Type	application/json
Authorization (API Key)	Bearer <API Key>

Path

Name	Description
user_id	User identifier (user_id). Optional on create — if not provided, a system-generated ID will be used More description

Response

200

{
    "message": "fetch resource successfully",
    "data": [
        {
            "user_id": "GtQ5Oezk6cOvSmPgxsMR",
            "created_at": 1753317736835,
            "credit_change": 1,
            "credit_balance": 706,
            "source_type": "api",
            "description": "paid for credit"
        }...
    ]
    "lastKey": {
        "prefix_app_id": "_credit-usage_appId1",
        "type_id": "20240213010101_abcde"
    }
}

---

Attributes

Attribute	Type	Description
starting_after	Object	A cursor to use in pagination. Show child attributes

404