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