APITask

Get a task

GET
/public/v1/tasks/{id}

Fetches a single task by its ID, scoped to the authenticated company. Returns 404 if no task with that ID exists in your company, and 403 if the authenticated user can't access it under their team restrictions. The linked entity is returned as in GET /public/v1/tasks, so it is null when the authenticated user can't view it.

Required permission: tasks_permissions_view.

Authorization

Bearer
headerAuthorizationBearer <token>

API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.

Path Parameters

id*string

ID of the task to fetch, as returned by the list and upsert endpoints. An ID that doesn't exist for your company returns 404.

Response Body

A single task

*/*
  1. response

A single task

data?

A task

Example Request
curl -X GET 'https://app.distru.com/public/v1/tasks/00000000-0000-0000-0000-000000000029'
Example Response
{  "data": {    "assembly": null,    "batch": null,    "color": null,    "company": null,    "contact": null,    "creator": {      "banned": false,      "deleted_at": null,      "email": "[email protected]",      "full_name": "FirstName4098 LastName4099",      "id": "00000000-0000-0000-0000-000000000803",      "inserted_datetime": "2026-10-13T15:03:29.948979Z",      "role": {        "id": "00000000-0000-0000-0000-000000000845",        "name": "Admin 2116"      },      "updated_datetime": "2026-10-13T15:03:29.948979Z"    },    "custom_data": [],    "description": null,    "due_datetime": "2025-06-01T12:00:00.000000Z",    "id": "00000000-0000-0000-0000-000000000002",    "inserted_datetime": "2026-10-13T15:03:29.950686Z",    "invoice": null,    "location": null,    "name": "Follow up",    "order": {      "id": "397d15f7-bc85-4496-82e1-4918411889ac",      "order_number": "SO-70",      "status": "PROCESSING",      "total": "0.00"    },    "owner": {      "banned": false,      "deleted_at": null,      "email": "[email protected]",      "full_name": "FirstName4098 LastName4099",      "id": "00000000-0000-0000-0000-000000000803",      "inserted_datetime": "2026-10-13T15:03:29.948979Z",      "role": {        "id": "00000000-0000-0000-0000-000000000845",        "name": "Admin 2116"      },      "updated_datetime": "2026-10-13T15:03:29.948979Z"    },    "product": null,    "purchase": null,    "return": null,    "status": "ACTIVE",    "updated_datetime": "2026-10-13T15:03:29.950686Z"  }}