Activities API | Genaya API Reference

Organization

Activities

The change history of a single record.

GET/activities

List a record's activity timeline

Returns the change history for ONE record. Requires scope: activities:read. Both `entityType` and `entityId` are required. Activity is recorded per record rather than per organization, so there is no organization-wide timeline to return; the record you name is authorized first, and a record belonging to another organization returns 404.

Parameters

Query

entityTyperequired

string

entityIdrequired

string

The id of the record whose timeline you want.

Response 200

No fields.

Errors

400Malformed or missing parameters

401Bad, missing, or revoked key

402The prepaid balance has nothing left for API requests past the included pool, or the trial requests are used up

403Lacks scope, plan without API access, live key on a trial, test key writing, or feature switched off

404No such resource in this organization

429Rate limited

500Unexpected server error

curl -X GET https://api.genaya.com/v1/activities \
  -H "Authorization: Bearer gny_live_xxx"

Example response

{
  "object": "list",
  "data": [
    {
      "id": "",
      "object": "activity",
      "entityType": "",
      "entityId": "",
      "type": "",
      "category": "",
      "message": "",
      "oldValue": "",
      "newValue": "",
      "source": "",
      "createdByName": "",
      "createdAt": "2026-01-15T09:30:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": ""
}