Skip to main content
GET
/
tasks
/
{id}
Get a task
curl --request GET \
  --url https://api.reply.io/v3/tasks/{id} \
  --header 'X-API-Key: <api-key>'
{
  "id": "<string>",
  "ownerId": "<string>",
  "taskType": "email_manual",
  "status": "pending",
  "data": {
    "type": "Email",
    "delayInMinutes": 1,
    "executionMode": "Automatic",
    "templates": [
      {
        "subject": "<string>",
        "body": "<string>",
        "id": 123,
        "templateId": 123
      }
    ],
    "id": 123,
    "scheduledTime": "2023-11-07T05:31:56Z"
  },
  "description": "<string>",
  "contactId": "<string>",
  "accountId": "<string>",
  "sequenceId": "<string>",
  "dueDate": "2023-12-25",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "lastInteraction": {
    "date": "2023-11-07T05:31:56Z",
    "type": "email",
    "result": "<string>"
  }
}

Authorizations

​
X-API-Key
string
header
required

API key passed in the X-API-Key header

Path Parameters

​
id
string
required

Task Id

Response

200 - application/json

Task details retrieved successfully

Represents a task in the system

​
id
string
required

(Required) Unique task identifier (ULID)

​
ownerId
string
required

(Required) User who owns the task

​
taskType
enum<string>
required

(Required) Kind of action

Available options:
email_manual,
email_auto,
call,
linkedin,
custom
​
status
enum<string>
required

(Required) Current status of the task

Available options:
pending,
completed,
skipped
​
data
Email Task · object
required

Type-specific data for the task A task for sending emails Email step with template configuration

​
description
string

Free-text details for the assignee

​
contactId
string

Contact linked to the task

​
accountId
string

Account linked to the contact

​
sequenceId
string

Sequence the task belongs to (if any)

​
dueDate
string<date>

ISO 8601 date the task is due (YYYY-MM-DD)

​
createdAt
string<date-time>

RFC 3339 timestamp when the task was created

​
updatedAt
string<date-time>

RFC 3339 timestamp of the last update

​
lastInteraction
object

Combined details of the most recent contact touch