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": "in_progress"
  },
  "assignees": [
    {
      "id": 7,
      "name": "Bob",
      "avatar_url": "https://cdn.example.com/avatars/bob.png"
    }
  ],
  "labels": [
    {
      "id": 2,
      "name": "Backend",
      "color": "purple"
    }
  ],
  "subtasks": [
    {
      "id": 102,
      "title": "Write unit tests",
      "priority": "medium",
      "identifier": 6,
      "status": {
        "id": 1,
        "name": "Backlog",
        "icon": null,
        "color": "gray",
        "category": "pending"
      },
      "assignees": []
    }
  ],
  "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
      }
    }
  ],
  "custom_fields": [
    {
      "id": 1,
      "name": "Customer Tier",
      "type": "dropdown",
      "config": { "options": ["Free", "Starter", "Pro"] },
      "position": 1,
      "value": "Pro"
    },
    {
      "id": 2,
      "name": "Story Points",
      "type": "number",
      "config": null,
      "position": 2,
      "value": null
    }
  ]
}
Requires the tasks:read scope. You must be a member of the task’s workspace. Access-restricted members receive 403 if the task belongs to a list outside their permitted scope.

​
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.
​
labels
array
required
Labels attached to the task. Empty array if no labels are assigned.
​
subtasks
array
required
Direct subtasks of this task. Empty array if the task has no subtasks.
​
attachments
array
required
Confirmed file attachments on the task. Empty array if none.
​
custom_fields
array
required
Custom fields that apply to this task’s list, each with its current value. Fields restricted to other lists or folders are not returned. Fields the user does not have access to are also omitted.
{
  "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": "in_progress"
  },
  "assignees": [
    {
      "id": 7,
      "name": "Bob",
      "avatar_url": "https://cdn.example.com/avatars/bob.png"
    }
  ],
  "labels": [
    {
      "id": 2,
      "name": "Backend",
      "color": "purple"
    }
  ],
  "subtasks": [
    {
      "id": 102,
      "title": "Write unit tests",
      "priority": "medium",
      "identifier": 6,
      "status": {
        "id": 1,
        "name": "Backlog",
        "icon": null,
        "color": "gray",
        "category": "pending"
      },
      "assignees": []
    }
  ],
  "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
      }
    }
  ],
  "custom_fields": [
    {
      "id": 1,
      "name": "Customer Tier",
      "type": "dropdown",
      "config": { "options": ["Free", "Starter", "Pro"] },
      "position": 1,
      "value": "Pro"
    },
    {
      "id": 2,
      "name": "Story Points",
      "type": "number",
      "config": null,
      "position": 2,
      "value": null
    }
  ]
}