GET
/
tasks
List tasks
curl --request GET \
  --url https://api.amplemarket.com/tasks \
  --header 'Authorization: Bearer <token>'
{
  "tasks": [
    {
      "id": "0197c138-b33d-78e3-8f33-b0b0bae1a998",
      "automatic": false,
      "type": "phone_call",
      "status": "scheduled",
      "due_on": "2025-06-30T12:23:27Z",
      "finished_on": null,
      "notes": "",
      "sequence_key": null,
      "sequence_name": null,
      "user_id": "0197c138-b2f5-7483-8f90-0877503ef8df",
      "user_email": "user@example.com",
      "contact": {
        "id": "0197c138-b33c-7978-b08c-31420b2523f8",
        "name": "User Amplemarket",
        "email": "user@amplemarket.com"
      }
    }
  ],
  "_links": {
    "self": {
      "href": "/tasks?page[size]=20&user_id=0197c138-b2f5-7483-8f90-0877503ef8df"
    }
  }
}

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

200
application/json

Successful

The response is of type object.