Skip to main content
GET
/
tasks
List tasks
curl --request GET \
  --url https://api.amplemarket.com/tasks \
  --header 'Authorization: Bearer <token>'
{
  "tasks": [
    {
      "id": "019dfcc6-87b3-71b9-9f74-15348e6b6192",
      "automatic": false,
      "type": "phone_call",
      "status": "scheduled",
      "due_on": "2026-05-06T08:12:42Z",
      "finished_on": null,
      "notes": "custom task notes",
      "sequence_key": null,
      "sequence_name": null,
      "user_id": "019dfcc6-8633-7306-bddd-93e48b53d359",
      "user_email": "user@example.com",
      "contact": {
        "id": "6aedd643-4ca1-4f61-bf76-57d74740df9f",
        "name": "John Doe",
        "email": "user@example.com"
      }
    }
  ],
  "_links": {
    "self": {
      "href": "/tasks?page[size]=20&status=due&user_id=019dfcc6-8633-7306-bddd-93e48b53d359"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.amplemarket.com/llms.txt

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

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
page[size]
string

Page size

​
page[after]
string

Page after

​
page[before]
string

Page before

​
automatic
boolean

Filter by task automation type

​
type
string

Filter by task type

​
status
string

Filter by task status

​
contact_local_time_from
integer

Filter by associated contact local time hour being higher than this value

Required range: 0 <= x <= 23
​
contact_local_time_to
integer

Filter by associated contact local time hour being lower than this value

Required range: 0 <= x <= 23
​
message_opens
integer

Filter by associated message opens

Required range: x >= 0
​
keyword
string

Filter by name, email or company associated with task

​
sequence_key
string

Filter by associated sequence

​
user_id
string
required

Filter by user

Response

Successful

​
tasks
object[]
​
_links
object