Get tasks
Lists the tasks belonging to the authenticated company, oldest-first (by creation time). Results
never cross company boundaries and are paginated: next_page holds the URL of the following
page, or null on the last page.
A task may be linked to exactly one other entity. The linked entity is returned as the matching
relation field (order, invoice, purchase, contact, product, batch, assembly,
return, or company); every other relation field is null. Tasks linked to an internal-only
entity that has no public API model return every relation field as null. The relation field is
also null when the authenticated user lacks the permission the linked entity's own list endpoint
requires, or can't see it under their team restrictions.
Required permission: tasks_permissions_view. Only tasks the authenticated user can access
under their team restrictions are returned.
BearerAuthorizationBearer <token>API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.
ids[]?array<string>Restrict the result to specific tasks by ID. Repeat the bracketed key once per ID. Unknown IDs match nothing; an empty list is treated as no filter. At most 200 IDs.
owner_ids[]?array<string>Restrict to tasks owned by specific users, by user ID. Repeat the bracketed key once per ID. At most 200 IDs.
statuses[]?array<>Filter to tasks with any of these statuses. Repeat the bracketed key once per status. At most 200.
due_datetime?stringFilter by due datetime, a comma-separated start,end pair of ISO8601 datetimes (inclusive). Either bound may be omitted for an open-ended range.
inserted_datetime?stringFilter by creation datetime, a comma-separated start,end pair of ISO8601 datetimes (inclusive). Either bound may be omitted.
updated_datetime?stringFilter by last-updated datetime, a comma-separated start,end pair of ISO8601 datetimes (inclusive). Either bound may be omitted.
page?stringPage selector. Page size is fixed by the server; paginate by following the next_page URL in each response rather than building page selectors yourself — it is null on the last page. next_page uses page[after]=<cursor>, an opaque token marking where the next page resumes; pass it back exactly as given, and only to the endpoint that issued it. This is seek-based, so every page stays fast no matter how deep you page.
A list of tasks
*/*- response
A collection of tasks
data?array<>Tasks
next_page?stringURL for the next page of results; null when there is no next page
curl -X GET 'https://app.distru.com/public/v1/tasks'{ "data": [ { "assembly": null, "batch": null, "color": null, "company": null, "contact": null, "creator": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName4322 LastName4323", "id": "00000000-0000-0000-0000-00000000086f", "inserted_datetime": "2026-10-13T15:03:30.284262Z", "role": { "id": "00000000-0000-0000-0000-0000000008bc", "name": "Admin 2235" }, "updated_datetime": "2026-10-13T15:03:30.284262Z" }, "custom_data": [], "description": null, "due_datetime": "2026-10-13T15:03:30.281906Z", "id": "00000000-0000-0000-0000-000000000004", "inserted_datetime": "2025-01-01T00:00:00.000000Z", "invoice": null, "location": null, "name": "A", "order": null, "owner": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName4322 LastName4323", "id": "00000000-0000-0000-0000-00000000086f", "inserted_datetime": "2026-10-13T15:03:30.284262Z", "role": { "id": "00000000-0000-0000-0000-0000000008bc", "name": "Admin 2235" }, "updated_datetime": "2026-10-13T15:03:30.284262Z" }, "product": null, "purchase": null, "return": null, "status": "ACTIVE", "updated_datetime": "2026-10-13T15:03:30.287918Z" }, { "assembly": null, "batch": null, "color": null, "company": null, "contact": null, "creator": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName4330 LastName4331", "id": "00000000-0000-0000-0000-000000000872", "inserted_datetime": "2026-10-13T15:03:30.291241Z", "role": { "id": "00000000-0000-0000-0000-0000000008bf", "name": "Admin 2238" }, "updated_datetime": "2026-10-13T15:03:30.291241Z" }, "custom_data": [], "description": null, "due_datetime": "2026-10-13T15:03:30.288644Z", "id": "00000000-0000-0000-0000-000000000005", "inserted_datetime": "2025-01-02T00:00:00.000000Z", "invoice": null, "location": null, "name": "B", "order": null, "owner": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName4330 LastName4331", "id": "00000000-0000-0000-0000-000000000872", "inserted_datetime": "2026-10-13T15:03:30.291241Z", "role": { "id": "00000000-0000-0000-0000-0000000008bf", "name": "Admin 2238" }, "updated_datetime": "2026-10-13T15:03:30.291241Z" }, "product": null, "purchase": null, "return": null, "status": "ACTIVE", "updated_datetime": "2026-10-13T15:03:30.293677Z" }, { "assembly": null, "batch": null, "color": null, "company": null, "contact": null, "creator": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName4334 LastName4335", "id": "00000000-0000-0000-0000-000000000874", "inserted_datetime": "2026-10-13T15:03:30.296690Z", "role": { "id": "00000000-0000-0000-0000-0000000008c3", "name": "Admin 2242" }, "updated_datetime": "2026-10-13T15:03:30.296690Z" }, "custom_data": [], "description": null, "due_datetime": "2026-10-13T15:03:30.294074Z", "id": "00000000-0000-0000-0000-000000000006", "inserted_datetime": "2025-01-03T00:00:00.000000Z", "invoice": null, "location": null, "name": "C", "order": null, "owner": { "banned": false, "deleted_at": null, "email": "[email protected]", "full_name": "FirstName4334 LastName4335", "id": "00000000-0000-0000-0000-000000000874", "inserted_datetime": "2026-10-13T15:03:30.296690Z", "role": { "id": "00000000-0000-0000-0000-0000000008c3", "name": "Admin 2242" }, "updated_datetime": "2026-10-13T15:03:30.296690Z" }, "product": null, "purchase": null, "return": null, "status": "ACTIVE", "updated_datetime": "2026-10-13T15:03:30.300498Z" } ], "next_page": "https://www.example.com/public/v1/tasks?page[after]=ZHwyMDI1LTAxLTAzVDAwOjAwOjAwLjAwMDAwMFp8aXwwMDAwMDAwMC0wMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDY"}