Skip to main content
GET
/
customers
/
internal-accounts
List customer-owned internal accounts.
curl --request GET \
  --url https://{publicHost}/customers/internal-accounts \
  --header 'Authorization: Basic <encoded-value>'
{
  "data": [
    {
      "id": "InternalAccount:a12dcbd6-dced-4ec4-b756-3c3a9ea3d123",
      "customerId": "Customer:019542f5-b3e7-1d02-0000-000000000001",
      "currency": "USD",
      "balance": {
        "amount": 25000,
        "currency": "USD"
      },
      "createdAt": "2025-07-21T17:32:28Z",
      "updatedAt": "2025-07-21T17:32:28Z"
    }
  ],
  "hasMore": false,
  "nextCursor": "",
  "totalCount": 1
}

Authorizations

​
Authorization
string
header
required

Integration-key Basic Auth (clientId:clientSecret) as documented in docs/public/AUTHENTICATION.md.

Query Parameters

​
currency
string

Filter by ISO 4217 currency code.

​
customerId
string

Filter by the owning customer's system-generated BLIPS customer ID.

​
limit
integer
default:10

Maximum number of results to return. Defaults to 10 and caps at 100.

Required range: 1 <= x <= 100
​
cursor
string

Pagination cursor returned from a previous list response.

Response

Customer internal account list returned.

​
data
object[]
required

Customer-owned internal accounts in the current page of results.

​
hasMore
boolean
required

Whether another page of internal accounts is available.

​
nextCursor
string
required

Cursor to use for the next page when hasMore is true.

​
totalCount
integer
required

Total number of matching internal accounts across all pages.