List recent activity

Request#

GET /api/v1/dashboard/recent-activity

Requires reports:read and all four inventory Read permissions: assets:read, people:read, locations:read, and subscriptions:read. See dashboard report permissions.

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

Query parameters#

timeframe string Optional

1, 3, 6, or 12 months back, or all. Defaults to 1.

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.

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/dashboard/recent-activity?timeframe=1&per_page=25" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json"

Response#

200 OK.

{
  "data": [
    {
      "resource": "people",
      "record_id": 123,
      "id": "person_location_event:901",
      "event_id": 901,
      "type": "person_location_event",
      "event_date": "2026-10-01T16:30:00.000000Z",
      "event_type": {
        "id": 42,
        "name": "Badge issued",
        "slug": null,
        "category": "person"
      },
      "description": "Issued at front desk.",
      "cost": null,
      "date_due": null,
      "created_by": {
        "id": 4,
        "name": "Alex Admin"
      },
      "related": {
        "person": {
          "resource": "people",
          "id": 123,
          "name": "Ada Lovelace"
        },
        "location": null
      },
      "acquisition": null,
      "warranty": null,
      "billing": null,
      "contract": null,
      "created_at": "2026-10-01T16:30:00.000000Z",
      "updated_at": "2026-10-01T16:30:00.000000Z"
    },
    {
      "type": "todo",
      "resource": "assets",
      "record_id": 456,
      "id": 77,
      "name": "Replace battery",
      "notes": null,
      "due_date": "2026-10-09",
      "assigned_to": 4,
      "created_by": 4,
      "is_complete": false,
      "created_at": "2026-09-30T16:00:00.000000Z",
      "updated_at": "2026-09-30T16:00:00.000000Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 25,
    "total": 2
  },
  "links": {
    "next": null,
    "prev": null
  }
}

Behavior and constraints#

Activity combines asset, subscription, person, and location events with to-dos, newest first by event date (to-dos by creation date). Every item has resource and record_id for the record it belongs to. Events use the same shape as timeline entries, including related references to the records involved. As on timelines, a reference is only filled in when the token can read that record type. To-dos have type todo and the same shape as organization to-dos; they are included only for record types the token holds the :todos permission for. Drafts are left out.

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.