Retrieve all tasks

This endpoint retrieves all tasks in your account. You can narrow down the data returned by filtering on the source of the task (see our article on creating tasks for more information).

HTTP Request

GET https://api.lunatask.app/v1/tasks

Query Parameters

Parameter	Description
source	The source specified when creating the task (optional)
source_id	The source_id specified when creating the task (optional)

If no source is specified, all tasks are returned.

Example in Ruby

require 'rest-client'

access_token = 'xxx'

RestClient.get('https://api.lunatask.app/v1/tasks', { Authorization: "bearer #{access_token}" })

Response

The request returns JSON structured like this:

{
  "tasks": [
    {
      "id": "066b5835-184f-4fd9-be60-7d735aa94708",
      "area_id": "11b37775-5a34-41bb-b109-f0e5a6084799",
      "goal_id": null,
      "status": "next",
      "previous_status": "later",
      "estimate": 10,
      "priority": 0,
      "progress": 25,
      "motivation": "unknown",
      "eisenhower": 0,
      "sources": [
        {
          "source": "github",
          "source_id": "123"
        }
      ],
      "scheduled_on": null,
      "completed_at": null,
      "created_at": "2021-01-10T10:39:25Z",
      "updated_at": "2021-01-10T10:39:25Z",
    },
    {
      "id": "0e0cff5c-c334-4a24-b15a-4fca6cfbf25f",
      "area_id": "f557287e-ae43-4472-9478-497887362dcb",
      "goal_id": null,
      "status": "later",
      "previous_status": null,
      "estimate": 120,
      "priority": 0,
      "motivation": "unknown",
      "eisenhower": 0,
      "progress": null,
      "sources": [],
      "scheduled_on": null,
      "completed_at": null,
      "created_at": "2021-01-10T10:39:26Z",
      "updated_at": "2021-01-10T10:39:26Z",
    }
  ]
}