Beta. This endpoint is in beta. Behavior, parameters, and response shapes may change without notice.
Returns a filtered, paginated list of tasks.
Pagination params (top, skip) are in query string; filter criteria in request body.
All filter fields are optional — an empty body {} returns all tasks.
The request body must be a valid JSON object; a missing or unparseable body returns 400.
Documentation Index
Fetch the complete documentation index at: https://docs.reply.io/llms.txt
Use this file to discover all available pages before exploring further.
Authenticate every request with a Bearer token. Pass your Reply API key in the
Authorization header:
Authorization: Bearer <your-api-key>Get your API key from the Reply dashboard: Settings → API Key.
Maximum number of items to return (default 25, max 1000).
Number of items to skip.
Request body for the POST /tasks/filter endpoint.
All fields are optional — an empty object {} returns all tasks visible to the caller.
Filter tasks with StartAt >= this value. Defaults to 2000-01-01 if omitted.
Filter tasks with StartAt <= this value. Must be after from when both are provided. Defaults to now + 1 year if omitted.
Filter by task type. Must be a valid enum value.
Possible values: toDo, call, meeting, linkedIn, manualEmail, sms, whatsApp.
toDo, call, meeting, linkedIn, manualEmail, sms, whatsApp Filter by task status. Must be a valid enum value.
Possible values: new, finished, cancelled, archived, sequenceDetached.
new, finished, cancelled, archived, sequenceDetached Filter tasks belonging to these sequences.
Filter tasks belonging to these sequence steps.
Filter by prospect timezone (e.g. "America/New_York").
Filter tasks for a specific contact.
Filter tasks assigned to a specific user. Only returns results if the caller has permission to view that user's tasks.
Filter by overdue status. true = overdue only, false = not overdue only, null = all.