Skip to main content
GET
/
customers
/
external-accounts
List Customer external accounts
curl --request GET \
  --url https://api.lightspark.com/grid/2025-10-13/customers/external-accounts \
  --header 'Authorization: Basic <encoded-value>'
{
  "data": [
    {
      "id": "ExternalAccount:e85dcbd6-dced-4ec4-b756-3c3a9ea3d965",
      "customerId": "Customer:da459a29-1fb7-41ce-a4cb-eb3a3c9fd7a7",
      "status": "ACTIVE",
      "platformAccountId": "acc_123456789",
      "currency": "USD",
      "accountInfo": {
        "accountType": "US_ACCOUNT",
        "accountNumber": "123456789",
        "routingNumber": "987654321",
        "accountCategory": "CHECKING",
        "bankName": "Chase Bank",
        "beneficiary": {
          "fullName": "John Michael Doe",
          "birthDate": "1990-01-15",
          "nationality": "US",
          "address": {},
          "beneficiaryType": "INDIVIDUAL"
        }
      }
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>",
  "totalCount": 123
}

Authorizations

​
Authorization
string
header
required

API token authentication using format <api token id>:<api client secret>

Query Parameters

​
currency
string

Filter by currency code

​
customerId
string

Filter by external accounts associated with a specific customer

​
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

Successful operation

​
data
object[]
required

List of external accounts matching the filter criteria

​
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 external accounts matching the criteria (excluding pagination)

⌘I