List follow-up tasks.

GEThttps://app.softsolz.uk/api/v1/services/appointments/tasks

Recent Requests

Kept only in this browser

TimeStatusTook

Send a request with Try it to see it here.

Headers

Authorizationstringrequired

Bearer token: `Bearer sk_live_...` (or `sk_test_...` for sandbox). A login token will not work here.

Query Params

statusstring

open, done, or cancelled.

due_beforestring

Only tasks due at or before this ISO timestamp.

limitinteger

Page size, 1-200.

offsetinteger

Pagination offset.

Response

Response Body · array of objects

idstringTask id. Use it as the id in PATCH /tasks/{id}. A whole number sent as a string.

appointment_idstring | nullAppointment the task follows up. A whole number sent as a string, or null.

customer_idstring | nullCustomer the task is about. A whole number sent as a string, or null.

titlestringShort task title.

descriptionstring | nullLonger details.

assignee_user_idinteger | nullWorkspace member responsible for it.

due_atstring | nullWhen the task is due.

statusstringopen until it is done or cancelled.

completed_atstring | nullWhen it was marked done. Cleared when it is reopened.

created_atstringWhen the task was created.

updated_atstringWhen the task was last changed.

public_refstring | nullCustomer-safe reference of the linked appointment.

customer_namestring | nullName of the linked customer.

Request

curl --request GET \
  --url https://app.softsolz.uk/api/v1/services/appointments/tasks \
  --header 'Authorization: Bearer sk_live_your_key'

Credentials

Authorization

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
  "data": [
    {
      "id": "11",
      "appointment_id": "650",
      "customer_id": "990",
      "title": "Call back about the quote",
      "description": "Confirm the part price",
      "assignee_user_id": 4121,
      "due_at": "2027-03-02T09:00:00.000Z",
      "status": "open",
      "completed_at": null,
      "created_at": "2026-10-01T17:42:56.512Z",
      "updated_at": "2026-10-01T17:42:56.512Z",
      "public_ref": "AP-RUNQQ7",
      "customer_name": "Priya Raman"
    }
  ],
  "meta": {
    "limit": 50,
    "offset": 0,
    "total": 1,
    "has_more": false
  }
}