Skip to main content
GET
/
api
/
v1
/
tasks
/
{id}
Get task
curl --request GET \
  --url https://api.getarca.app/api/v1/tasks/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": 101,
  "workspace_id": 3,
  "list_id": 20,
  "title": "Set up CI pipeline",
  "description": "<p>Use GitHub Actions for the build pipeline.</p>",
  "priority": "high",
  "identifier": 5,
  "due_date": "2026-03-25T00:00:00.000Z",
  "start_date": null,
  "creator_id": 1,
  "created_at": "2026-03-10T14:22:00.000Z",
  "status": {
    "id": 2,
    "name": "In Progress",
    "icon": "in-progress",
    "color": "blue",
    "category": "active"
  },
  "assignees": [
    {
      "id": 7,
      "name": "Bob",
      "avatar_url": "https://cdn.example.com/avatars/bob.png"
    }
  ],
  "attachments": [
    {
      "id": 4,
      "file_name": "diagram.png",
      "file_size": 204800,
      "mime_type": "image/png",
      "created_at": "2026-03-11T09:00:00.000Z",
      "uploader": {
        "id": 1,
        "name": "Alice",
        "avatar_url": null
      }
    }
  ]
}
Requires the tasks:read scope. You must be a member of the task’s workspace.

​
Path parameters

​
id
string
required
The numeric task ID.

​
Response

​
id
number
required
Task identifier.
​
workspace_id
number
required
Workspace this task belongs to.
​
list_id
number | null
List this task belongs to. null if not in a list.
​
title
string
required
Task title.
​
description
string | null
Task description as an HTML string. null if not set.
​
priority
string
required
Task priority. One of urgent, high, medium, low, or none.
​
identifier
number
required
Workspace-scoped sequential task number.
​
due_date
string | null
UTC ISO-8601 due date. null if not set.
​
start_date
string | null
UTC ISO-8601 start date. null if not set.
​
creator_id
number
required
User ID of the task creator.
​
created_at
string
required
UTC ISO-8601 creation timestamp.
​
status
object | null
Current task status. null if no status is assigned.
​
assignees
array
required
Array of users assigned to the task. Empty array if unassigned.
​
attachments
array
required
Confirmed file attachments on the task. Empty array if none.
{
  "id": 101,
  "workspace_id": 3,
  "list_id": 20,
  "title": "Set up CI pipeline",
  "description": "<p>Use GitHub Actions for the build pipeline.</p>",
  "priority": "high",
  "identifier": 5,
  "due_date": "2026-03-25T00:00:00.000Z",
  "start_date": null,
  "creator_id": 1,
  "created_at": "2026-03-10T14:22:00.000Z",
  "status": {
    "id": 2,
    "name": "In Progress",
    "icon": "in-progress",
    "color": "blue",
    "category": "active"
  },
  "assignees": [
    {
      "id": 7,
      "name": "Bob",
      "avatar_url": "https://cdn.example.com/avatars/bob.png"
    }
  ],
  "attachments": [
    {
      "id": 4,
      "file_name": "diagram.png",
      "file_size": 204800,
      "mime_type": "image/png",
      "created_at": "2026-03-11T09:00:00.000Z",
      "uploader": {
        "id": 1,
        "name": "Alice",
        "avatar_url": null
      }
    }
  ]
}