List agent transactions

Retrieve a paginated list of transactions for the authenticated agent’s customer. Results are automatically scoped to the agent’s associated customer — no customer filter is needed or accepted.

GET /agents/me/transactions

cURL

cURL

curl --request GET \
  --url https://api.lightspark.com/grid/2025-10-13/agents/me/transactions \
  --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 transaction of client.agents.me.transactions.list()) {
  console.log(transaction);
}

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.transactions.TransactionListPage
import com.lightspark.grid.models.agents.me.transactions.TransactionListParams

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

    val page: TransactionListPage = client.agents().me().transactions().list()
}

200

{
  "data": [
    {
      "id": "Transaction:019542f5-b3e7-1d02-0000-000000000004",
      "type": "INCOMING",
      "destination": {
        "destinationType": "ACCOUNT",
        "accountId": "ExternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123",
        "currency": "EUR",
        "onChainTransaction": {
          "transactionHash": "h82pJGF9p7kpzb6eU326EFZf2cDnimbTFVeJtx1qtBmUNJAEqN76R7PwPfHt3oWb8R6cKvhgyxQdDn53jFrK6wFx",
          "network": "SOLANA"
        }
      },
      "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",
        "onChainTransaction": {
          "transactionHash": "h82pJGF9p7kpzb6eU326EFZf2cDnimbTFVeJtx1qtBmUNJAEqN76R7PwPfHt3oWb8R6cKvhgyxQdDn53jFrK6wFx",
          "network": "SOLANA"
        }
      },
      "fees": 10,
      "reconciliationInstructions": {
        "reference": "UMA-Q12345-REF",
        "transactionHash": "0x9f2c6b6f4b6c8f2a8d9e0b1c2d3e4f5061728394a5b6c7d8e9f00112233445566"
      },
      "rateDetails": {
        "gridApiMultiplier": 0.925,
        "gridApiFixedFee": 10,
        "gridApiVariableFeeRate": 0.003,
        "gridApiVariableFeeAmount": 30
      }
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>",
  "totalCount": 123
}

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

{
  "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

accountIdentifier · string

Filter by account identifier (matches either sender or receiver)

senderAccountIdentifier · string

Filter by sender account identifier

receiverAccountIdentifier · string

Filter by receiver account identifier

status · enum<string>

Filter by transaction status Status of a payment transaction.

Status	Description
CREATED	Initial lookup has been created
PENDING	Quote has been created
PROCESSING	Funding has been received and payment initiated
COMPLETED	Cross border payment has been received, converted and payment has been sent to the offramp network
REJECTED	Receiving institution or wallet rejected payment, payment has been refunded
FAILED	An error occurred during payment
REFUNDED	Payment was unable to complete and refunded
EXPIRED	Quote has expired

Available options: CREATED, PENDING, PROCESSING, COMPLETED, REJECTED, FAILED, REFUNDED, EXPIRED

type · enum<string>

Filter by transaction type Type of transaction (incoming payment or outgoing payment)

Available options: INCOMING, OUTGOING

reference · string

Filter by reference

startDate · string<date-time>

Filter by start date (inclusive) in ISO 8601 format

endDate · string<date-time>

Filter by end date (inclusive) in ISO 8601 format

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)

sortOrder · enum<string> · default: desc

Order to sort results in

Available options: asc, desc

Response

200

application/json

Successful operation

data · (Incoming Transaction · object | Outgoing Transaction · object | Card Transaction · object)[] · required

List of transactions matching the criteria

Incoming Transaction

Outgoing Transaction

Card Transaction

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 transactions matching the criteria (excluding pagination)