List agent's own actions

Retrieve a paginated list of actions submitted by the authenticated agent. Use this to poll for approval decisions after submitting an action that requires approval.

GET /agents/me/actions

cURL

cURL

curl --request GET \
  --url https://api.lightspark.com/grid/2025-10-13/agents/me/actions \
  --header 'Authorization: Bearer <token>'

import LightsparkGrid from '@lightsparkdev/grid';

const client = new LightsparkGrid({
  agentAccessToken: process.env['GRID_AGENT_ACCESS_TOKEN'], // This is the default and can be omitted
});

// Automatically fetches more pages as needed.
for await (const agentAction of client.agents.me.actions.list()) {
  console.log(agentAction.id);
}

package com.lightspark.grid.example

import com.lightspark.grid.client.LightsparkGridClient
import com.lightspark.grid.client.okhttp.LightsparkGridOkHttpClient
import com.lightspark.grid.models.agents.me.actions.ActionListPage
import com.lightspark.grid.models.agents.me.actions.ActionListParams

fun main() {
    val client: LightsparkGridClient = LightsparkGridOkHttpClient.fromEnv()

    val page: ActionListPage = client.agents().me().actions().list()
}

200

{
  "data": [
    {
      "id": "AgentAction:019542f5-b3e7-1d02-0000-000000000099",
      "agentId": "Agent:019542f5-b3e7-1d02-0000-000000000042",
      "customerId": "Customer:019542f5-b3e7-1d02-0000-000000000010",
      "platformCustomerId": "user-a1b2c3",
      "createdAt": "2025-10-03T15:00:00Z",
      "updatedAt": "2025-10-03T15:02:00Z",
      "quote": {
        "id": "Quote:019542f5-b3e7-1d02-0000-000000000006",
        "status": "PENDING",
        "createdAt": "2025-10-03T12:00:00Z",
        "expiresAt": "2025-10-03T12:05:00Z",
        "source": {
          "sourceType": "ACCOUNT",
          "accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965",
          "customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001"
        },
        "destination": {
          "destinationType": "ACCOUNT",
          "accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123",
          "paymentRail": "ACH"
        },
        "sendingCurrency": {
          "code": "USD",
          "name": "United States Dollar",
          "symbol": "$",
          "decimals": 2
        },
        "receivingCurrency": {
          "code": "USD",
          "name": "United States Dollar",
          "symbol": "$",
          "decimals": 2
        },
        "totalSendingAmount": 123010,
        "totalReceivingAmount": 1000,
        "exchangeRate": 123,
        "feesIncluded": 10,
        "transactionId": "Transaction:019542f5-b3e7-1d02-0000-000000000005",
        "paymentInstructions": [
          {
            "accountOrWalletInfo": {
              "accountType": "USD_ACCOUNT",
              "paymentRails": [
                "ACH",
                "WIRE"
              ],
              "accountNumber": "1234567890",
              "routingNumber": "021000021",
              "bankName": "Chase Bank",
              "reference": "UMA-Q12345-REF"
            },
            "instructionsNotes": "Include reference UMA-Q12345-REF in memo"
          },
          {
            "accountOrWalletInfo": {
              "accountType": "SPARK_WALLET",
              "assetType": "BTC",
              "address": "spark1pgssyuuuhnrrdjswal5c3s3rafw9w3y5dd4cjy3duxlf7hjzkp0rqx6dj6mrhu",
              "invoice": "lnbc15u1p3xnhl2pp5jptserfk3zk4qy42tlucycrfwxhydvlemu9pqr93tuzlv9cc7g3sdqsvfhkcap3xyhx7un8cqzpgxqzjcsp5f8c52y2stc300gl6s4xswtjpc37hrnnr3c9wvtgjfuvqmpm35evq9qyyssqy4lgd8tj637qcjp05rdpxxykjenthxftej7a2zzmwrmrl70fyj9hvj0rewhzj7jfyuwkwcg9g2jpwtk3wkjtwnkdks84hsnu8xps5vsq4gj5hs"
            }
          }
        ],
        "counterpartyInformation": {
          "FULL_NAME": "John Sender",
          "BIRTH_DATE": "1985-06-15",
          "NATIONALITY": "DE"
        },
        "rateDetails": {
          "counterpartyMultiplier": 1.08,
          "counterpartyFixedFee": 10,
          "gridApiMultiplier": 0.925,
          "gridApiFixedFee": 10,
          "gridApiVariableFeeRate": 0.003,
          "gridApiVariableFeeAmount": 30
        }
      },
      "transferDetails": {
        "amount": 50000,
        "currency": "USD",
        "sourceAccountId": "InternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123",
        "destinationAccountId": "ExternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965"
      },
      "transaction": {
        "id": "Transaction:019542f5-b3e7-1d02-0000-000000000004",
        "type": "INCOMING",
        "destination": {
          "destinationType": "ACCOUNT",
          "accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123",
          "currency": "EUR"
        },
        "customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001",
        "platformCustomerId": "18d3e5f7b4a9c2",
        "receivedAmount": {
          "amount": 12550,
          "currency": {
            "code": "USD",
            "name": "United States Dollar",
            "symbol": "$",
            "decimals": 2
          }
        },
        "settledAt": "2025-08-15T14:30:00Z",
        "createdAt": "2025-08-15T14:25:18Z",
        "updatedAt": "2025-08-15T14:30:00Z",
        "receiptDeliveryConfirmedAt": "2025-08-15T14:31:00Z",
        "agentId": "Agent:019542f5-b3e7-1d02-0000-000000000042",
        "description": "Payment for invoice #1234",
        "counterpartyInformation": {
          "FULL_NAME": "John Sender",
          "BIRTH_DATE": "1985-06-15",
          "NATIONALITY": "DE"
        },
        "source": {
          "sourceType": "ACCOUNT",
          "accountId": "InternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965",
          "currency": "USD"
        },
        "fees": 10,
        "reconciliationInstructions": {
          "reference": "UMA-Q12345-REF",
          "transactionHash": "0x9f2c6b6f4b6c8f2a8d9e0b1c2d3e4f5061728394a5b6c7d8e9f00112233445566"
        },
        "rateDetails": {
          "gridApiMultiplier": 0.925,
          "gridApiFixedFee": 10,
          "gridApiVariableFeeRate": 0.003,
          "gridApiVariableFeeAmount": 30
        }
      },
      "rejectionReason": "Transaction amount exceeds customer's current risk limit."
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>",
  "totalCount": 123
}

{
  "status": 401,
  "message": "<string>",
  "details": {}
}

{
  "status": 500,
  "message": "<string>",
  "details": {}
}

Authorizations

Authorization · string · header · required

Bearer token authentication for agent-scoped endpoints. The token is the accessToken returned when redeeming a device code via POST /agents/device-codes/{code}/redeem. Agent credentials are user-scoped: all requests are automatically bound to the agent's associated customer and subject to the agent's policy.

Query Parameters

status · enum<string>

Filter by action status Status of an agent action.

Status	Description
PENDING_APPROVAL	Submitted by the agent, awaiting platform approval before execution
APPROVED	Approved by the platform; execution is in progress or completed
REJECTED	Rejected by the platform; the underlying transaction was not executed
FAILED	Approved but execution failed (e.g. quote expired, insufficient funds)

Available options: PENDING_APPROVAL, APPROVED, REJECTED, FAILED

limit · integer · default: 20

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

Required range: 1 <= x <= 100

cursor · string

Cursor for pagination (returned from previous request)

Response

200

application/json

Successful operation

data · object[] · required

List of agent actions matching the filter criteria.

Show child attributes

hasMore · boolean · required

Indicates if more results are available beyond this page.

nextCursor · string

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

totalCount · integer

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