List Lists

GET /v1/nexttask/lists

List your lists

Your own lists and the lists shared with you.

Request

GET https://your-site.example/api/index.php/v1/nexttask/lists

Responses

200 — The lists.

{
    "success": true,
    "message": "string",
    "messages": "string",
    "data": {
        "items": [
            {
                "id": 5,
                "user_id": 1,
                "title": "Groceries",
                "color": "#1967d2",
                "position": "string",
                "is_default": 1,
                "is_team": 1,
                "owner_name": "string",
                "access": "owner",
                "can_leave": true,
                "created": "string",
                "created_by": 1,
                "modified": "string",
                "modified_by": 1
            }
        ]
    }
}

Errors

Examples

curl

curl -s "https://your-site.example/api/index.php/v1/nexttask/lists" \
  -H "X-Joomla-Token: $API_TOKEN"

PHP

<?php
$ch = curl_init('https://your-site.example/api/index.php/v1/nexttask/lists');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'X-Joomla-Token: ' . getenv('API_TOKEN'),
    ],
]);

$response = json_decode(curl_exec($ch), true);
curl_close($ch);

JavaScript

const API_TOKEN = process.env.API_TOKEN;

const response = await fetch("https://your-site.example/api/index.php/v1/nexttask/lists", {
  headers: {
    "X-Joomla-Token": `${API_TOKEN}`,
  },
});
const data = await response.json();