Agent Management

List agent transaction approval requests

Changed on

Retrieve a paginated list of agent actions that require platform approval. Filter by agentId or customerId to scope results to a specific agent or customer. Approve or reject individual actions via POST /agents/{agentId}/actions/{actionId}/approve or POST /agents/{agentId}/actions/{actionId}/reject.

get/agents/approvals

Request

  • Base URL: https://api.lightspark.com/grid/2025-10-13
  • URL: https://api.lightspark.com/grid/2025-10-13/agents/approvals
  • Auth: HTTP basic

Query parameters

agentIdstring

Filter by agent ID

customerIdstring

Filter by customer ID

startDatestring date-time

Filter by start date (inclusive) in ISO 8601 format

endDatestring date-time

Filter by end date (inclusive) in ISO 8601 format

limitinteger

Maximum number of results to return (default 20, max 100)

cursorstring

Cursor for pagination (returned from previous request)

sortOrder'asc' | 'desc'

Order to sort results in

Response

Successful operation

hasMoreboolean required

Indicates if more results are available beyond this page.

nextCursorstring

Cursor to retrieve the next page of results (only present if hasMore is true).

totalCountinteger

Total number of actions matching the criteria (excluding pagination).

Changes

  • 556180e5b2aeRevision changes
    • warning

      added the new ACH_SAME_DAY enum value to the ////////////// response property for the response status

    • warning

      added the new ACH_SAME_DAY enum value to the ///////////////// response property for the response status

    • warning

      added the new ACH_SAME_DAY enum value to the //////////////// response property for the response status

    • warning

      added the new ACH_SAME_DAY enum value to the /////////////////// response property for the response status

    • warning

      added the new ACH_SAME_DAY enum value to the ///////////// response property for the response status

    • warning

      added the new ACH_SAME_DAY enum value to the //////////////// response property for the response status

  • 5b4d838613abRevision changes
    • warning

      removed the optional property /////////////////// from the response with the status

    • warning

      removed the optional property ///////////////////// from the response with the status

    • info

      added the optional property //////////////// to the response with the status

    • info

      added the optional property ////////////////// to the response with the status