List tasks for the organization.
const url = 'https://api-us.suiteop.com/api/v1/tasks?priority=watch&scope=personal&status=triage&view=today';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api-us.suiteop.com/api/v1/tasks?priority=watch&scope=personal&status=triage&view=today' \ --header 'Authorization: Bearer <token>'List task records — the unit of work, not the unit of time or money. USE for ‘open tasks at property X’, ‘tasks assigned to me’, ‘overdue maintenance’, filtering by status / priority / property / assignee / department / due date. DO NOT USE for ‘who’s clocked in’ or ‘timesheet’/‘hours worked’ (use listClockedShifts), ‘cost / approvals / payroll / what did we spend’ (use listCostsByPeriod), or ‘projected cost of task X’ (use previewTaskCostForAssignees). Task statuses: triage / not_started / in_progress / paused / completed / cancelled.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Query Parameters
Section titled “Query Parameters ”Responses
Section titled “ Responses ”Success.
object
Array of matching items.
object
Response metadata including pagination.
object
Present on list responses.
object
Page size used for this request.
Number of items skipped.
Total number of matching items (across all pages).
Unique identifier for this request.
Pagination metadata included on list responses.
object
Page size used for this request.
Number of items skipped.
Total number of matching items (across all pages).
Example generated
{ "data": [ { "assigneeFirstName": "example", "assigneeLastName": "example", "assigneeUserId": "example", "collaboratorUsers": [ { "firstName": "example", "id": "example", "lastName": "example" } ], "collaborators": [ "example" ], "completedByFirstName": "example", "completedByLastName": "example", "completedByUserId": "example", "createdAt": "2026-04-15T12:00:00Z", "departmentCategory": "example", "departmentColor": "example", "departmentId": "example", "departmentName": "example", "due": "2026-04-15T12:00:00Z", "endTime": "2026-04-15T12:00:00Z", "estCost": 1, "financialApprovalStatus": "example", "hasCostOverride": true, "id": "example", "isBlocking": true, "isRecurring": true, "isUnassigned": true, "lastStartTime": "2026-04-15T12:00:00Z", "nameText": "example", "priority": "example", "propertyCleaningStatus": "example", "propertyId": "example", "propertyInspectionStatus": "example", "propertyName": "example", "status": "example", "taskItemsCompleted": 1, "taskItemsTotal": 1, "totalCost": 1 } ], "meta": { "pagination": { "limit": 1, "offset": 1, "total": 1 }, "requestId": "example" }}Headers
Section titled “Headers ”Maximum requests per minute for this API key.
Remaining requests in the current rate-limit window.
Unix epoch seconds when the rate-limit window resets.
Unique identifier for this request (matches meta.requestId in the body).
400
Error envelope returned for HTTP 400 responses.
object
object
Machine-readable error code.
Optional structured details (omitted when undefined).
object
Human-readable error message.
Error type.
object
Example
{ "error": { "type": "validation_error" }}Headers
Section titled “Headers ”Maximum requests per minute.
Remaining requests in the current window.
Unix epoch seconds when the window resets.
Request correlation id (also in meta.requestId).
401
Error envelope returned for HTTP 401 responses.
object
object
Machine-readable error code.
Optional structured details (omitted when undefined).
object
Human-readable error message.
Error type.
object
Example
{ "error": { "type": "authentication_error" }}Headers
Section titled “Headers ”Request correlation id (also in meta.requestId).
403
Error envelope returned for HTTP 403 responses.
object
object
Machine-readable error code.
Optional structured details (omitted when undefined).
object
Human-readable error message.
Error type.
object
Example
{ "error": { "type": "authorization_error" }}Headers
Section titled “Headers ”Maximum requests per minute.
Remaining requests in the current window.
Unix epoch seconds when the window resets.
Request correlation id (also in meta.requestId).
404
Error envelope returned for HTTP 404 responses.
object
object
Machine-readable error code.
Optional structured details (omitted when undefined).
object
Human-readable error message.
Error type.
object
Example
{ "error": { "type": "not_found_error" }}Headers
Section titled “Headers ”Maximum requests per minute.
Remaining requests in the current window.
Unix epoch seconds when the window resets.
Request correlation id (also in meta.requestId).
409
Error envelope returned for HTTP 409 responses.
object
object
Machine-readable error code.
Optional structured details (omitted when undefined).
object
Human-readable error message.
Error type.
object
Example
{ "error": { "type": "conflict_error" }}Headers
Section titled “Headers ”Maximum requests per minute.
Remaining requests in the current window.
Unix epoch seconds when the window resets.
Request correlation id (also in meta.requestId).
422
Error envelope returned for HTTP 422 responses.
object
object
Machine-readable error code.
Optional structured details (omitted when undefined).
object
Human-readable error message.
Error type.
object
Example
{ "error": { "type": "business_rule_error" }}Headers
Section titled “Headers ”Maximum requests per minute.
Remaining requests in the current window.
Unix epoch seconds when the window resets.
Request correlation id (also in meta.requestId).
429
Error envelope returned for HTTP 429 responses.
object
object
Machine-readable error code.
Optional structured details (omitted when undefined).
object
Human-readable error message.
Error type.
object
Example
{ "error": { "type": "rate_limit_error" }}Headers
Section titled “Headers ”Number of seconds to wait before retrying.
Maximum requests per minute.
Remaining requests in the current window.
Unix epoch seconds when the window resets.
Request correlation id (also in meta.requestId).
500
Error envelope returned for HTTP 500 responses.
object
object
Machine-readable error code.
Optional structured details (omitted when undefined).
object
Human-readable error message.
Error type.
object
Example
{ "error": { "type": "internal_error" }}Headers
Section titled “Headers ”Maximum requests per minute.
Remaining requests in the current window.
Unix epoch seconds when the window resets.
Request correlation id (also in meta.requestId).