Skip to main content
GET
/
v2
/
usage.list
ListUsage
curl --request GET \
  --url https://api.manus.ai/v2/usage.list \
  --header 'x-manus-api-key: <x-manus-api-key>'
{
  "ok": true,
  "request_id": "<string>",
  "data": [
    {
      "task_id": "<string>",
      "title": "<string>",
      "credits": 123,
      "created_at": 123,
      "collaborate_infos": [
        {
          "user_id": "<string>",
          "user_name": "<string>",
          "credits": 123
        }
      ]
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://open.manus.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Questions or issues? Contact us at api-support@manus.ai.
Auth: API Key only — not available with OAuth tokens.
All change types: Each entry is a credit change at session granularity — consumption, refunds, subscription grants, and admin adjustments. credits is signed: negative values are consumption, positive values are refunds or grants. Inspect the type field to distinguish categories.

Headers

​
x-manus-api-key
string
required

API key for authentication. This endpoint does not support OAuth2 tokens. See Authentication.

Query Parameters

​
limit
integer

Number of records to return per page. Default: 20, Max: 100.

​
cursor
string

Pagination cursor from the previous response's next_cursor field. Omit for the first page.

Response

Usage records retrieved successfully.

​
ok
boolean

Whether the request was successful.

Example:

true

​
request_id
string

Unique identifier for this API request.

​
data
object[]

Array of credit consumption records, one per task.

​
has_more
boolean

Whether there are more records beyond this page. If true, use next_cursor to fetch the next page.

​
next_cursor
string

Cursor to pass as the cursor parameter for the next page. Only present when has_more is true.