Skip to content
Tallyfy

List organization tasks

Endpoint

GET /organizations/{org_id}/tasks

Retrieves all tasks across every process and one-off task in the specified organization. You can filter, sort and paginate the results.

Request

Replace {org_id} with your Organization ID.

Headers

  • Authorization: Bearer {your_access_token}
  • Accept: application/json
  • X-Tallyfy-Client: APIClient

Query parameters (optional)

  • q (string): Search by process name or step name.
  • status (string): Filter by task status - active, complete, incomplete, inprogress, overdue, due_soon, hasproblem.
  • owners (string): Comma-separated User IDs to filter tasks assigned to any of these users.
  • guests (string): Comma-separated Guest emails.
  • roles (string): Comma-separated Role IDs.
  • groups (string): Comma-separated Group IDs.
  • tag (string): Filter by Tag name.
  • folder (string): Filter by folder ID.
  • created (string): Filter by creation date (YYYY-MM-DD or YYYY-MM-DD:YYYY-MM-DD range).
  • deadline_start_range / deadline_end_range (string): Filter by deadline date range (YYYY-MM-DD).
  • deadline_on (string): Filter tasks with deadline on an exact date (YYYY-MM-DD). Takes precedence over other deadline filters.
  • deadline_before / deadline_after (string): Filter tasks with deadline before or after a given date (YYYY-MM-DD).
  • is_oneoff (string): Set to true for one-off tasks only, false for process tasks only.
  • unassigned (boolean): Set to true to return only tasks with no assignees.
  • archived (string): Set to true to include archived (soft-deleted) tasks, or only to return just archived tasks.
  • with (string): Include related data. Options: run, run.checklist, step, threads, assets, form_fields, tags, summary, selected_text_comment. Separate multiple values with commas.
  • page, per_page (integer): Pagination controls. Default per_page is 10.
  • sort (string): Sort results - deadline, newest, problems, completed_newest, or prefix with - for descending (e.g. -deadline).
  • without_pagination (string): Set to true to return all results at once. Use carefully on large datasets.

Code samples

const accessToken = 'YOUR_PERSONAL_ACCESS_TOKEN';
const orgId = 'YOUR_ORGANIZATION_ID';


// Construct query parameters
const params = new URLSearchParams({
    status: 'active', // Example: Get active tasks
    // unassigned: 'true', // Example: Get only unassigned tasks
    // owners: '1001,1002', // Example: Tasks owned by user 1001 OR 1002
    per_page: '20',
    with: 'run' // Example: Include run information
});
const queryStr = params.toString();
const apiUrl = `https://go.tallyfy.com/api/organizations/${orgId}/tasks${queryStr ? '?' + queryStr : ''}`;


const headers = new Headers();
headers.append('Authorization', `Bearer ${accessToken}`);
headers.append('Accept', 'application/json');
headers.append('X-Tallyfy-Client', 'APIClient');


fetch(apiUrl, {
    method: 'GET',
    headers: headers
})
.then(response => {
    return response.json().then(data => { // Attempt to parse JSON regardless of status
        if (!response.ok) {
            console.error("Failed to list organization tasks:", data);
            throw new Error(`HTTP error! status: ${response.status}`);
        }
        return data; // Pass successful data along
    });
})
.then(data => {
    console.log('Successfully listed organization tasks:');
    console.log(JSON.stringify(data, null, 2));
    // Access pagination info via data.meta.pagination if needed
})
.catch(error => {
    console.error('Error listing organization tasks:', error.message);
});

Response

A 200 OK response returns a JSON object with a data array of task objects and a meta object for pagination.

{
  "data": [
    {
      "id": "task_id_abc",
      "increment_id": 1205,
      "title": "Review Proposal",
      "run_id": "run_id_xyz",
      "checklist_id": "checklist_id_456",
      "step_id": "step_id_123",
      "alias": "step_alias",
      "status": "active",
      "status_label": "Active",
      "task_type": "task",
      "position": 2,
      "is_oneoff_task": false,
      "owners": {
        "users": [
          { "id": 1001, "full_name": "Alice" }
        ],
        "guests": [],
        "groups": []
      },
      "deadline": "2026-03-15T17:00:00Z",
      "started_at": "2026-03-01T09:00:00Z",
      "created_at": "2026-03-01T09:00:00Z",
      "last_updated": "2026-03-01T09:30:00Z",
      "completed_at": null,
      "is_completable": true,
      "everyone_must_complete": false
    }
  ],
  "meta": {
    "pagination": {
      "total": 50,
      "count": 10,
      "per_page": 10,
      "current_page": 1,
      "total_pages": 5
    }
  }
}

Fields like run_id, checklist_id, and step_id are null for one-off tasks. The summary field only appears when you pass with=summary.

Tasks > List process tasks

Tallyfy’s API lets you retrieve all tasks for a specific process run via a GET request with optional filters for status and deadlines and owners and sorting and pagination along with the ability to include related data like form fields and step details in the response.

Processes > List processes

Tallyfy’s API lets you retrieve a paginated and filterable list of all running process instances in your organization by calling GET on the runs endpoint with optional parameters for status and ownership and tags and sorting and related data inclusion.

Templates > List templates

Tallyfy’s API lets you retrieve a paginated and filterable list of process templates (called “checklists” in the API) for your organization using a GET request with optional query parameters for searching by title and filtering by status or tags or owner along with code examples in JavaScript and Python and Java and Go and C++ and C#.

Tags > List tags

Tallyfy’s API lets you retrieve all tags in an organization via a GET request with optional filtering by name and pagination and can include usage statistics showing how many active or archived templates and processes each tag is associated with.
Get in touch
About Tallyfy