> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enginy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get task

> Retrieve a single task by ID

<Card title="Your Implementation Required" icon="triangle-exclamation" color="#f59e0b">
  This endpoint must be implemented on **your server**
</Card>

Enginy calls this endpoint to retrieve task details.

## Path Parameters

<ParamField path="taskId" type="string" required>
  The task's CRM ID
</ParamField>

<RequestExample>`bash GET /tasks/task-abc123 `</RequestExample>

## Response

<ResponseField name="id" type="string" required>
  Task CRM ID
</ResponseField>

<ResponseField name="subject" type="string">
  Task subject
</ResponseField>

<ResponseField name="description" type="string">
  Task description
</ResponseField>

<ResponseField name="completed" type="boolean">
  Completion status
</ResponseField>

<ResponseField name="completedAt" type="string">
  Completion timestamp (if completed)
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "id": "task-abc123",
    "subject": "Follow up call",
    "description": "Discuss partnership proposal",
    "type": "call",
    "dueDate": "2024-12-31T10:00:00Z",
    "contactId": "contact_8f3k2j",
    "completed": false,
    "completedAt": null,
    "createdAt": "2024-12-15T10:00:00Z"
  }
  ```
</ResponseExample>

### Not Found

Return `404` if task doesn't exist:

```json theme={null}
{
  "error": "Task not found"
}
```