List to-dos

Request#

GET /api/v1/todos

Requires at least one of assets:todos, people:todos, locations:todos, or subscriptions:todos. See token permissions.

Send Authorization: Bearer YOUR_API_TOKEN and Accept: application/json.

Query parameters#

page integer Optional

The page of results to return. Starts at 1; defaults to 1.

per_page integer Optional

The maximum number of results per page. Accepts 1–100; defaults to 25.

assigned_to integer Optional

Only to-dos assigned to this organization user ID. A user who is not a member of the organization returns 422.

include_completed boolean Optional

Send 1 to include completed to-dos. Defaults to 0, which returns open to-dos only.

Example#

Set ASSETCENTER_API_TOKEN as described in the quick start. Replace example record and option IDs with values from your organization.

curl --request GET "https://my.assetcenter.app/api/v1/todos?assigned_to=4&per_page=25" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json"

Response#

200 OK.

{
  "data": [
    {
      "id": 77,
      "name": "Replace battery",
      "notes": null,
      "due_date": "2026-10-09",
      "assigned_to": 4,
      "created_by": 4,
      "is_complete": false,
      "created_at": "2026-10-02T16:00:00.000000Z",
      "updated_at": "2026-10-02T16:00:00.000000Z",
      "resource": "assets",
      "record_id": 123
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 25,
    "total": 1
  },
  "links": {
    "next": null,
    "prev": null
  }
}

Behavior and constraints#

Open to-dos come first, then by due date with undated to-dos last, then newest first. A token sees only to-dos on record types it holds the :todos permission for; for example, a token with only assets:todos never sees to-dos on people. resource and record_id identify the record the to-do belongs to. assigned_to and created_by are organization user IDs, not people. Follow links.next until it is null; the links keep your filters. To create, edit, or delete a to-do, use the record’s own to-do endpoints, such as asset to-dos.

Errors#

401 means the token is missing, expired, revoked, or not a customer API token. 403 means a required permission or administrator access is missing. 422 identifies invalid or unsupported input; inspect the errors object when present. 429 means a rate limit was reached. See error handling and rate limits.