List All Tasks

const options = {
  method: 'GET',
  headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};

fetch('https://api.dcycle.io/v1/projects/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.dcycle.io/v1/projects/tasks"

headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>"
}

response = requests.get(url, headers=headers)

print(response.text)

{
  "id": "<string>",
  "title": "<string>",
  "description": "<string>",
  "due_date": "<string>",
  "stage": "<string>",
  "category": "<string>",
  "assignees": {},
  "completion_mode": "<string>",
  "assigned_to": {},
  "projects": {},
  "comments": {},
  "progress": {},
  "tags": {}
}

GET

projects

tasks

List All Tasks

const options = {
  method: 'GET',
  headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};

fetch('https://api.dcycle.io/v1/projects/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.dcycle.io/v1/projects/tasks"

headers = {
    "x-api-key": "<x-api-key>",
    "x-organization-id": "<x-organization-id>"
}

response = requests.get(url, headers=headers)

print(response.text)

{
  "id": "<string>",
  "title": "<string>",
  "description": "<string>",
  "due_date": "<string>",
  "stage": "<string>",
  "category": "<string>",
  "assignees": {},
  "completion_mode": "<string>",
  "assigned_to": {},
  "projects": {},
  "comments": {},
  "progress": {},
  "tags": {}
}

List All Tasks

Retrieve all tasks linked to projects within your organization. Returns tasks with their associated projects, comments, and assignee information.

Request

Headers

string

required

Your API key for authenticationExample: sk_live_1234567890abcdef

string

required

Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Response

Returns an array of task objects.

string

Task UUID

string

Task title

string

Task description

string

Due date (YYYY-MM-DD)

string

Task stage: not_applicable, pending, in_progress, completed, validated, deleted

string

Task category

array[object]

Every user assigned to the task, all equally accountable. Each entry includes completed_at, set once that person has finished their own part (only meaningful when completion_mode is all).

string

any (the first assignee to complete it finishes it for everyone) or all (every assignee must complete their own part before the task is marked done).

object

Deprecated. One of assignees, kept for backward compatibility; carries no special meaning.

array[object]

Projects this task belongs to, each with id, name, type, etc.

array[object]

Task comments, each with id and comment

number | null

Completion progress (0–100)

array[string]

Task tags

Example

curl "https://api.dcycle.io/v1/projects/tasks" \
  -H "x-api-key: ${DCYCLE_API_KEY}" \
  -H "x-organization-id: ${DCYCLE_ORG_ID}"

import requests
import os

response = requests.get(
    "https://api.dcycle.io/v1/projects/tasks",
    headers={
        "x-api-key": os.getenv("DCYCLE_API_KEY"),
        "x-organization-id": os.getenv("DCYCLE_ORG_ID"),
    },
)

tasks = response.json()
for task in tasks:
    print(f"{task['title']} ({task['stage']}) — due {task['due_date']}")

const axios = require('axios');

const { data: tasks } = await axios.get(
  'https://api.dcycle.io/v1/projects/tasks',
  {
    headers: {
      'x-api-key': process.env.DCYCLE_API_KEY,
      'x-organization-id': process.env.DCYCLE_ORG_ID,
    },
  }
);

tasks.forEach(t => console.log(`${t.title} (${t.stage}) — due ${t.due_date}`));

Successful Response

[
  {
    "id": "task-uuid",
    "title": "Review electricity invoices Q1",
    "description": "Verify all Q1 invoices are uploaded",
    "due_date": "2025-03-31",
    "stage": "in_progress",
    "category": "data_collection",
    "organization_id": "org-uuid",
    "assignees": [
      {
        "id": "user-uuid",
        "first_name": "Ana",
        "last_name": "García",
        "email": "ana@example.com",
        "completed_at": null
      }
    ],
    "completion_mode": "any",
    "assigned_to": {
      "id": "user-uuid",
      "first_name": "Ana",
      "last_name": "García",
      "email": "ana@example.com"
    },
    "projects": [
      {
        "id": "project-uuid",
        "name": "Carbon Footprint 2025"
      }
    ],
    "comments": [],
    "progress": 60.0,
    "tags": ["invoices", "Q1"]
  }
]

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

{"detail": "Invalid API key for organization", "code": "INVALID_API_KEY"}

403 Forbidden

Cause: The authenticated user is not a member of the organization

{"detail": "Logged User is not Member of Organization", "code": "LOGGED_USER_NOT_MEMBER"}

List Project Tasks

List tasks for a specific project

Create Task

Create a new task

Introduction

Organizations

Emissions

Historical Emissions

Custom KPI

Projects

Files

Facilities

Logistic Hubs

Vehicles

Unknown Vehicles

Vehicle Fuels

Logistics

Business Travels

Hotel Stays

Employees

Survey Templates

Commuting Periods

Invoices

Purchases

Life Cycle Assessment (LCA)

Wastes

Waste Water Treatments

Transport

Sold Products

Dashboards

Reports & Dashboards (v1)

Imports

List All Tasks

List All Tasks

Request

Headers

Response

Example

Successful Response

Common Errors

401 Unauthorized

403 Forbidden

List Project Tasks

Create Task

​List All Tasks

​Request

​Headers

​Response

​Example

​Successful Response

​Common Errors

​401 Unauthorized

​403 Forbidden

​Related Endpoints

List Project Tasks

Create Task

List All Tasks

Request

Headers

Response

Example

Successful Response

Common Errors

401 Unauthorized

403 Forbidden

Related Endpoints