Skip to main content
GET
/
v1
/
tasks
Task
curl --request GET \
  --url https://api.example.com/v1/tasks

Documentation Index

Fetch the complete documentation index at: https://docs.reachedapp.com/llms.txt

Use this file to discover all available pages before exploring further.

List Tasks

Returns a paginated list of tasks with optional filters.

Request

GET /v1/tasks

Query Parameters

ParameterTypeRequiredDescription
pageintegerNoPage number (default: 1)
per_pageintegerNoResults per page (default: 25)
statusstringNoFilter by status (pending, completed, cancelled)
lead_iduuidNoFilter by lead ID

Example

curl -X GET \
  "https://YOUR_PROJECT.supabase.co/functions/v1/api-gateway/v1/tasks?status=pending" \
  -H "Authorization: Bearer rchd_live_xxxxxxxxxxxx"

Response

{
  "data": [
    {
      "id": "task-uuid-1",
      "title": "Follow up with John Doe",
      "status": "pending",
      "priority": "high",
      "due_date": "2026-03-25",
      "lead_id": "a1b2c3d4-...",
      "created_at": "2026-03-21T10:00:00.000Z"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 25,
    "total": 1
  }
}

Response Fields

FieldTypeDescription
iduuidTask unique identifier
titlestringTask title
statusstringTask status (pending, completed, cancelled)
prioritystringPriority level (low, medium, high)
due_datestringDue date (YYYY-MM-DD)
lead_iduuidAssociated lead ID (if linked)
created_atdatetimeCreation timestamp