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": {},
      "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

Authorizations

API_KEY
string
header
required

Query Parameters

after
string
limit
integer
order
string
orderBy
string
query
string
status
string[]
createdAfter
integer
createdBefore
integer

Response

200 - application/json
object
string
data
object[]
first_id
string
last_id
string
has_more
boolean