---
title: "Retrieve a task"
method: GET
path: "/v1/tasks/{taskId}"
tags: ["Tasks"]
---

# Retrieve a task

`GET /v1/tasks/{taskId}`

## Request

- Base URL: `https://api.revdesk.com`
- URL: `https://api.revdesk.com/v1/tasks/{taskId}`
- Auth: HTTP bearer

The task, every band of its provenance timeline in order, and each recorded outcome with the interactions that produced it.

## Path parameters

- `taskId` string, required

## Response `200`

Success

- object
  - `data` object, required
    - `id` string, required
    - `type` string, required
    - `status` string, required
    - `objective` string, required
    - `contact_id` string, nullable, required
    - `deadline` string, nullable, required
    - `created_at` string, required
    - `closed_at` string, nullable, required
    - `events` object[], required
      - `seq` number, required
      - `occurred_at` string, required
      - `row_type` string, required
      - `actor` string, nullable, required
      - `channel` string, nullable, required
      - `system` string, nullable, required
      - `body` string, required
    - `outcomes` object[], required
      - `id` string, required
      - `kind` string, required
      - `occurred_at` string, required
      - `value` number, nullable, required
      - `billable` boolean, required
      - `billed_at` string, nullable, required
      - `billed_amount` number, nullable, required
      - `attribution_mode` string, required
      - `disputed_at` string, nullable, required
      - `evidence` object[], required
        - `interaction_type` string, required
        - `interaction_id` string, required
        - `note` string, nullable, required

## Other responses

- `400`: Validation error
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict (incl. idempotency conflicts)
- `429`: Rate limited

---

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