---
title: "List pending manual tasks"
method: GET
path: "/advanced/campaigns/{campaignId}/manual-tasks"
tags: ["Campaign tracking"]
---

# List pending manual tasks

`GET /advanced/campaigns/{campaignId}/manual-tasks`

## Request

- Base URL: `https://api.emelia.io`
- URL: `https://api.emelia.io/advanced/campaigns/{campaignId}/manual-tasks`
- Auth: API key in header `Authorization`

Pending TASK steps of the campaign (contacts waiting for you to do something by hand), oldest first. Pausing the campaign deletes pending tasks; they are created again after the next start, when contacts reach the task step again.

## Path parameters

- `campaignId` string, required: MongoDB ObjectId: 24 hexadecimal characters.

## Query parameters

- `stepId` string

## Response `200`

Success.

- object
  - `success` unknown
  - `tasks` ManualTask[]
    - `_id` string: MongoDB ObjectId: 24 hexadecimal characters.
    - `firstName` string
    - `lastName` string
    - `email` string
    - `linkedinUrlProfile` string
    - `status` string
    - `taskId` string: Id of the TASK step. Send it back with `POST .../manual-tasks/status`.
    - `taskName` string: `versions[0].subject` of the TASK step.
    - `date` string, date-time: When the task became pending.
    - `multipleChoice` boolean: True when the task is followed by a `TASK_COMPLETED` condition (ok and ko lead to different branches).

## Other responses

- `400`: Invalid request.
- `401`: Missing, malformed, unknown or disabled API key. The key must be exactly 48 characters, otherwise it is treated as a session token and rejected the same way.
- `500`: Unexpected error. IMPORTANT: this is also what you receive today when the per minute quota of your account is exceeded (the quota error is not mapped to 429 for API keys). No `Retry-After` header is sent. Wait until the next minute window before retrying.

---

[API](https://skmtc.dev/emelia/apis/emelia-api.md) · [All operations](https://skmtc.dev/emelia/apis/emelia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emelia/apis/emelia-api/revisions/8c0cb435f2c4?raw)