Skip to main content
GET
/
projects
/
{id}
/
tasks
List tasks
curl --request GET \
  --url https://api.corebill.io/v1/projects/{id}/tasks \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "tasks": [
      {
        "id": "tsk_a1b2c3d4e5f6",
        "public_id": "TSK-2025-000001",
        "project_id": "pro_a1b2c3d4e5f6",
        "parent_task_id": "<string>",
        "depends_on": [
          "<string>"
        ],
        "assigned_to": "<string>",
        "created_by": "<string>",
        "title": "Design homepage mockup",
        "description": "<string>",
        "status": "in_progress",
        "priority": "high",
        "estimated_hours": 8,
        "start_date": "2023-12-25",
        "due_date": "2023-12-25",
        "completed_at": "2023-11-07T05:31:56Z",
        "is_billable": true,
        "hourly_rate": 75,
        "position": 0,
        "tags": [
          "design",
          "frontend"
        ],
        "metadata": {},
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "pagination": {
      "total": 42,
      "limit": 50,
      "offset": 0
    }
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Generate keys from the Corebill dashboard under the Developers section.

Example: Authorization: Bearer sk_live_abc123def456

Path Parameters

​
id
string
required

The project ID

Query Parameters

​
company_id
string
required

The company ID to scope the request to

​
limit
integer
default:50

Maximum number of records to return (default 50)

Required range: 1 <= x <= 100
​
offset
integer
default:0

Number of records to skip for pagination (default 0)

Required range: x >= 0
​
status
string

Filter by status. Comma-separated for multiple values (e.g. todo,in_progress)

Example:

"todo"

​
priority
string

Filter by priority. Comma-separated for multiple values

Example:

"high"

​
assigned_to
string

Filter by assigned user ID

​
parent_task_id
string

Filter by parent task ID. Use null for root-level tasks

​
search
string

Search by title or public ID

Response

List of tasks

​
data
object
required