Cloudreve API Docs
  1. User
Cloudreve API Docs
  • Site
    • Ping
      GET
    • Get CAPTCHA
      GET
    • Get site settings
      GET
  • Session
    • Token
      • Password sign-in
      • Finish sign-in with 2FA
      • Refresh Token
      • Sign out
    • OpenID
      • Prepare OpenID sign-in
      • Finish OpenID sign-in
      • Unlink OpenID
    • Passkey
      • Prepare Passkey sign-in
      • Finish Passkey sign-in
    • Prepare login
      GET
  • User
    • Passkey
      • Prepare passkey registration
      • Finish passkey registration
      • Delete passkey
    • Setting
      • List available storage policies
      • List available nodes
      • Get preferences
      • Prepare enabling 2FA
      • Update preference setting
      • Update profile pricture
    • Sign up
      POST
    • Send reset password email
      POST
    • Reset password via temp link
      PATCH
    • Get profile picture
      GET
    • Get user
      GET
    • List user's share links
      GET
    • Get storage capacity
      GET
    • Search user
      GET
    • List credit changes
      GET
    • List payments
      GET
  • Callback
    • Complete OneDrive upload
      GET
    • Complete COS upload
      GET
    • Complete S3 upload
      GET
    • Complete OBS upload
      GET
  • Workflow
    • Remote Download
      • Create remote download
      • Select files to download
      • Cancel task
    • List tasks
      GET
    • Get task progress
      GET
    • Create archive
      POST
    • Extract archive
      POST
    • Relocate storage policy
      POST
    • Import external files
      POST
  • File
    • Permission
      • Set permission
      • Delete permission setting
    • Upload
      • Create upload session
      • Upload file chunk
      • Delete upload session
    • Pin
      • Pin to sidebar
      • Delete a pin
    • Version
      • Set file version
      • Delete file version
    • Direct Link
      • Create direct links
      • Delete direct link
    • List files
    • List file activities
    • Get file info
    • Get thumbnail URL
    • Update file content
    • Create viewer session
    • Create file
    • Rename file
    • Move or copy files
    • Create download URL
    • Restore from trash bin
    • Delete file
    • Force unlock
    • Patch metadata
    • Mount storage policy
    • Update view setting
  • Share
    • Create share link
    • Edit share link
    • Get share link info
    • List my share links
    • Delete share link
  • VAS
    • Payment
      • Create a payment
      • Get payment status
    • GiftCode
      • Check gift code
      • Redeem gift code
  • Group
    • List groups
  • WebDAV
    • List accounts
    • Create account
    • Update account
    • Delete account
  1. User

List payments

GET
/user/payments
Auth: JWT RequiredPro

Request

Authorization
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Query Params
page_size
number 
required
Page size.
>= 10
Example:
50
order_direction
enum<string> 
optional
Allowed values:
ascdesc
Default:
asc
Example:
asc
next_page_token
string 
optional
Token for requesting next page. Empty value means requesting the first page.

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/user/payments?page_size=50&order_direction=asc&next_page_token='

Responses

🟢200Success
application/json
Body
data
object  | null 
optional
Response content. In some error type, e.g. lock conflicting errors, this field wil present details of the error, e.g. who is locking the current file.
pagination
object 
required
payments
array[object (Payment) {13}] 
required
code
integer 
required
Response code.
0 - Success.
Default:
0
Example:
0
msg
string 
optional
Human readable error message (if any).
error
string  | null 
optional
Internal error message, only visable in debug mode.
correlation_id
string <uuid> | null 
optional
Correlation ID of the request. Only presented on failed reqeust.
Example:
b4351ecc-ee1a-4455-bc94-2c3dbcc58538
Example
{
    "code": 0,
    "data": {
        "pagination": {
            "page": 0,
            "page_size": 10,
            "is_cursor": true
        },
        "payments": [
            {
                "id": "3YwCL",
                "trade_no": "20250323225706001174243874",
                "name": "Points",
                "status": "created",
                "qyt": 1000,
                "price_unit": 1,
                "price_id": "CNY",
                "price_mark": "¥",
                "price_one_unit": 100,
                "created_at": "2025-03-23T22:57:07+08:00",
                "updated_at": "2025-03-23T22:57:07+08:00",
                "product_type": 4
            },
            {
                "id": "op5Fn",
                "trade_no": "20250311111124004538711012",
                "name": "Points",
                "status": "fulfilled",
                "qyt": 100,
                "price_unit": 1,
                "price_id": "CNY",
                "price_mark": "¥",
                "price_one_unit": 100,
                "created_at": "2025-03-11T11:11:25+08:00",
                "updated_at": "2025-03-11T11:14:05+08:00",
                "product_type": 4
            },
            {
                "id": "12pHb",
                "trade_no": "20241206103237001943356169",
                "name": "Basic Storage",
                "status": "created",
                "qyt": 1,
                "price_unit": 500,
                "price_id": "CNY",
                "price_mark": "¥",
                "price_one_unit": 100,
                "created_at": "2024-12-06T10:32:39+08:00",
                "updated_at": "2024-12-06T10:32:39+08:00",
                "product_type": 3
            }
        ]
    },
    "msg": ""
}
Modified at 2025-06-13 05:28:11
Previous
List credit changes
Next
Complete OneDrive upload
Built with