usage.list

GET

usage.list

ListUsage

curl --request GET \
  --url https://api.manus.ai/v2/usage.list

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/usage.list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.manus.ai/v2/usage.list"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/usage.list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "ok": true,
  "request_id": "<string>",
  "data": [
    {
      "task_id": "<string>",
      "title": "<string>",
      "credits": 123,
      "created_at": 123,
      "type": "cost",
      "collaborate_infos": [
        {
          "user_id": "<string>",
          "user_name": "<string>",
          "credits": 123
        }
      ]
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

{
  "ok": false,
  "request_id": "<string>",
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

^{Questions or issues? Contact us at api-support@manus.ai.}

Auth: API Key or a trusted OAuth app. Standard OAuth apps cannot access this endpoint.

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

API key for direct authentication. Provide either this or Authorization, not both. See Authentication.

Authorization

string

Trusted OAuth app authentication. Standard OAuth apps cannot access this endpoint. See the Open App guide.

Example:

"Bearer {access_token}"

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.

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.

Hide child attributes

data.task_id

string

The task (session) ID this change is associated with.

data.title

string

The task title. Returns "Deleted conversation" if the session has been deleted.

data.credits

integer

Credit change amount. Negative values represent consumption; positive values represent refunds or subscription/admin grants.

data.created_at

integer

Time of the most recent change as a Unix timestamp in seconds.

data.type

enum<string>

Change type:

cost — credit consumption (task usage or admin deduction)
refund — credit returned after consumption (e.g., task failure rollback)
grant — credits gained (subscription grant, upgrade bonus, recurring issuance, credit pack purchase, admin compensation)

Available options:

cost,

refund,

grant

data.collaborate_infos

object[]

Per-collaborator credit breakdown for team tasks. Empty for personal tasks.

Hide child attributes

data.collaborate_infos.user_id

string

Collaborator's user ID.

data.collaborate_infos.user_name

string

Collaborator's display name.

data.collaborate_infos.credits

integer

Credits attributed to this collaborator for the 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.

⌘I

ListUsage

curl --request GET \
  --url https://api.manus.ai/v2/usage.list

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.manus.ai/v2/usage.list",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.manus.ai/v2/usage.list"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.manus.ai/v2/usage.list")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "ok": true,
  "request_id": "<string>",
  "data": [
    {
      "task_id": "<string>",
      "title": "<string>",
      "credits": 123,
      "created_at": 123,
      "type": "cost",
      "collaborate_infos": [
        {
          "user_id": "<string>",
          "user_name": "<string>",
          "credits": 123
        }
      ]
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

{
  "ok": false,
  "request_id": "<string>",
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Getting Started

API Reference

Headers

Query Parameters

Response