Skip to main content
GET
/
tasks
List tasks
curl --request GET \
  --url https://api.amplemarket.com/tasks \
  --header 'Authorization: Bearer <token>'
{
  "tasks": [
    {
      "id": "019ae9a7-d233-7e2e-832e-1d816b0b9e76",
      "automatic": false,
      "type": "phone_call",
      "status": "scheduled",
      "due_on": "2025-12-04T11:58:00Z",
      "finished_on": null,
      "notes": "custom task notes",
      "sequence_key": null,
      "sequence_name": null,
      "user_id": "019ae9a7-d124-7a1d-9008-9c84ede75df6",
      "user_email": "[email protected]",
      "contact": {
        "id": "019ae9a7-d231-7400-9389-45d3a4d3eb05",
        "name": "User Amplemarket",
        "email": "[email protected]"
      }
    }
  ],
  "_links": {
    "self": {
      "href": "/tasks?page[size]=20&user_id=019ae9a7-d124-7a1d-9008-9c84ede75df6"
    }
  }
}

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