List company activity events

Authorization

Send one of these on every request. See Authentication for how to get credentials.

• API key

  Basic authentication header of the form Basic <api_key>, where <api_key> is your api key.

• Bearer token

Query parameters

• filter string

  Filter string in the format field:operator:value. To provide multiple filters, separate them with commas.

  Available operators: eq, ne, in, not_in, gt, gte, lt, lte.

  • For in and not_in operators, provide multiple values separated by the pipe character (|).

  Available fields: action, actorId, correlationId, createdAt, entityId, entityType.

• limit integer · int32

  Maximum number of items to return. Default is 50, maximum is 200.

• cursor string

  The cursor position to start returning results from. Omit it, or provide 0, for the initial request. For subsequent requests, use nextCursor from the previous response to navigate. Cursor values are opaque and should not be constructed manually. This endpoint paginates by cursor only and has no offset parameter.

Response

• records array of object

  List of records for the current page

  • id string · uuid

    Unique identifier of the event. Ids are time-ordered, so a later event always has a greater id.

  • entityType string

    Type of the record the event belongs to

    ⚠️ This enum is not exhaustive; new values may be added in the future.

    One of AI_AGENT AI_ARTIFACT ASSISTANT_INSTRUCTION BANK_ACCOUNT BANK_PAYMENT CARD CARD_INTENT CARD_TRANSACTION CONTRACT CREDIT_NOTE CUSTOMER CUSTOMER_CREDIT DEFERRED_ENTRY DOCUMENT_TEMPLATE FX_REVALUATION HUBSPOT_CONNECTION INTERCOMPANY_JOURNAL_ENTRY INVOICE_PAYABLE INVOICE_RECEIVABLE JOURNAL_ENTRY LCI_MEMORY PRODUCT PURCHASE_ORDER PURCHASE_REQUEST SALESFORCE_CONNECTION SKILL USER_REIMBURSEMENT_CONFIG VENDOR WORKFLOW YEAR_CLOSING_ENTRY

  • entityId string · uuid

    ID of the record the event belongs to

  • action string

    What was done to the record

    ⚠️ This enum is not exhaustive; new values may be added in the future.

    One of ACTIVATE ADD_TO_PAYMENT_BATCH AGENT_REVIEW APPLY_CREDIT_NOTE APPLY_CUSTOMER_CREDIT APPROVE APPROVE_PAYMENT ARCHIVE ATTACH_FILE CANCEL CANCEL_TERMINATION CLEAR CLOSE CONFIRM_GOODS_RECEIPT CREATE DECLINE_APPROVAL DECLINE_PAYMENT DELETE FAIL FLAG_GOODS_RECEIPT_ISSUE INITIATE_PAYMENT LOCK MARK_AS_PAID MARK_AS_PAID_IN_STRIPE MARK_AS_PARTIALLY_PAID MATCH_BILL MATCH_PURCHASE_ORDER OPEN PARTIALLY_CLEAR PAUSE_PAYMENT PAY POST PUBLISH RECONCILE REMOVE_CREDIT_NOTE REMOVE_CUSTOMER_CREDIT RENEW RESET RESUME_PAYMENT REVERSE_CLEARING REVERT SCHEDULE_TERMINATION SEND_CUSTOMER_CREDIT SEND_DUNNING_EMAIL SEND_INVOICE SEND_PURCHASE_ORDER SUBMIT_FOR_APPROVAL TERMINATE TRIGGER_SYNC UNARCHIVE UNMATCH_BILL UNMATCH_PURCHASE_ORDER UNRECONCILE UPDATE

  • actor object

    Who did it

    • id string · uuid

      ID of the principal that acted

    • type string

      Kind of principal that acted

      ⚠️ This enum is not exhaustive; new values may be added in the future.

      One of AI_AGENT INTEGRATION LIGHT_TEAM SYSTEM USER

    • name string

      Display name of the actor

    • roles array of string

      Roles the actor held when the event was recorded, without Light-internal roles. Null for events recorded before roles were captured.

      One of SUPERUSER REIMBURSEMENT CARDHOLDER CONTROLLER COMPANY_ADMIN VENDOR_MANAGEMENT INVOICE_APPROVER AP_PREPARATION AP_CLERK AR_CLERK PURCHASE_REQUESTER REPORT_VIEWER AUDITOR

  • correlationId string · uuid

    ID of the operation this event belongs to, e.g. an approval run or an assistant tool call. Events sharing it were caused by that one operation.

  • createdAt string · date-time

    Timestamp when the event happened

  • changes array of object

    Field changes recorded with the event, each with the value before and after

    • objectType string

      Whether the changed field belongs to the record itself or to one of its lines

      ⚠️ This enum is not exhaustive; new values may be added in the future.

      One of HEADER LINE

    • objectId string · uuid

      ID of the record or line the field belongs to

    • objectPosition integer · int32

      Position of the line within the record, for line fields

    • field string

      Machine name of the changed field

    • fieldLabel string

      Human-readable label of the changed field

    • oldValue object

      A field value, discriminated by type: TEXT, DATE, ENUM, MONEY, REFERENCE or REFERENCE_LIST

      • type stringrequired

    • newValue object

      A field value, discriminated by type: TEXT, DATE, ENUM, MONEY, REFERENCE or REFERENCE_LIST

      • type stringrequired

• hasMore boolean

  Boolean flag indicating if there are more records available

• nextCursor string

  Cursor for fetching the next page

• prevCursor string

  Cursor for fetching the previous page