Skip to main content
GET
/
v1
/
tasks
GetTasks
curl --request GET \
  --url https://api.manus.ai/v1/tasks \
  --header 'API_KEY: <api-key>'
{
  "object": "<string>",
  "data": [
    {
      "id": "<string>",
      "object": "<string>",
      "created_at": 123,
      "updated_at": 123,
      "status": "pending",
      "error": "<string>",
      "incomplete_details": "<string>",
      "instructions": "<string>",
      "max_output_tokens": 123,
      "model": "<string>",
      "metadata": {
        "task_title": "<string>",
        "task_url": "<string>"
      },
      "output": [
        {
          "id": "<string>",
          "status": "<string>",
          "role": "user",
          "type": "<string>",
          "content": [
            {
              "type": "output_text",
              "text": "<string>",
              "fileUrl": "<string>",
              "fileName": "<string>",
              "mimeType": "<string>"
            }
          ]
        }
      ],
      "locale": "<string>",
      "credit_usage": 123
    }
  ],
  "first_id": "<string>",
  "last_id": "<string>",
  "has_more": true
}
Retrieve a list of tasks with optional filtering and pagination. This endpoint allows you to search, filter, and paginate through your tasks.

​
Query Parameters

Use these parameters to filter and paginate through tasks:
  • after: Cursor for pagination (ID of the last task from previous page)
  • limit: Maximum number of tasks to return (default: 100, range: 1-1000)
  • order: Sort direction - “asc” or “desc” (default: “desc”)
  • orderBy: Sort field - “created_at” or “updated_at” (default: “created_at”)
  • query: Search term to filter by title and body content
  • status: Array of status values to filter by - “pending”, “running”, “completed”, “failed”
  • createdAfter: Unix timestamp to filter tasks created after this time
  • createdBefore: Unix timestamp to filter tasks created before this time
  • project_id: Filter tasks by project ID - returns only tasks belonging to the specified project

Authorizations

​
API_KEY
string
header
required

Query Parameters

​
after
string

Cursor for pagination. ID of the last task from the previous page.

​
limit
integer<int32>

Maximum number of tasks to return. Default: 100, Range: 1-1000.

​
order
string

Sort direction: "asc" or "desc". Default: "desc".

​
orderBy
string

Sort field: "created_at" or "updated_at". Default: "created_at".

​
query
string

Search term to filter by title and body content.

​
status
string[]

Filter by task status: "pending", "running", "completed", "failed".

​
createdAfter
integer<int64>

Filter tasks created after this Unix timestamp (seconds).

​
createdBefore
integer<int64>

Filter tasks created before this Unix timestamp (seconds).

​
project_id
string

Filter tasks by project ID. Returns only tasks belonging to the specified project.

Response

200 - application/json

Tasks retrieved successfully.

​
object
string

Always "list"

​
data
object[]
​
first_id
string

ID of the first task in the list

​
last_id
string

ID of the last task in the list (use as 'after' for next page)

​
has_more
boolean

Whether there are more tasks available