Skip to main content
GET
/
tasks
List tasks
curl --request GET \
  --url https://api.amplemarket.com/tasks \
  --header 'Authorization: Bearer <token>'
{
  "tasks": [
    {
      "id": "019c99cb-fec4-7d3b-843c-95471815836b",
      "automatic": false,
      "type": "phone_call",
      "status": "scheduled",
      "due_on": "2026-02-26T09:53:28Z",
      "finished_on": null,
      "notes": "custom task notes",
      "sequence_key": null,
      "sequence_name": null,
      "user_id": "019c99cb-fdc9-7144-a57e-ffdaac45e00d",
      "user_email": "user@example.com",
      "contact": {
        "id": "019c99cb-feb7-7d7c-9139-33fb1f3e40c4",
        "name": "User Amplemarket",
        "email": "user@amplemarket.com"
      }
    }
  ],
  "_links": {
    "self": {
      "href": "/tasks?page[size]=20&user_id=019c99cb-fdc9-7144-a57e-ffdaac45e00d"
    }
  }
}

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