---
title: "List platform internal accounts"
method: GET
path: "/platform/internal-accounts"
tags: ["Internal Accounts"]
---

# List platform internal accounts

`GET /platform/internal-accounts`

Retrieve a list of all internal accounts that belong to the platform, as opposed to an individual customer.

These accounts are created automatically when the platform is configured for each supported currency. They can be used for things like distributing bitcoin rewards to customers, or for other platform-wide purposes.

## Query parameters

- `currency` string

## Response `200`

Successful operation

- object
  - `data` InternalAccount[], required — List of internal accounts matching the filter criteria
    - `id` string, required — The ID of the internal account
    - `customerId` string — The ID of the customer associated with the internal account. If this field is empty, the internal account belongs to the platform.
    - `balance` CurrencyAmount, required
      - `amount` integer, required — Amount in the smallest unit of the currency (e.g., cents for USD/EUR, satoshis for BTC)
      - `currency` Currency, required
        - `code` string — Three-letter currency code (ISO 4217) for fiat currencies. Some cryptocurrencies may use their own ticker symbols (e.g. "BTC" for Bitcoin, "USDC" for USDC, etc.)
        - `name` string — Full name of the currency
        - `symbol` string — Symbol of the currency
        - `decimals` integer — Number of decimal places for the currency
    - `fundingPaymentInstructions` PaymentInstructions[], required — Payment instructions for funding the account
      - `instructionsNotes` string — Additional human-readable instructions for making the payment
      - `isPlatformAccount` boolean — Indicates whether the account is a platform account or a customer account.
      - `accountOrWalletInfo` union, required
        - ClabeAccountInfo
          - `accountType` 'CLABE', required
          - `clabeNumber` string, required — 18-digit CLABE number (Mexican banking standard)
        - UsAccountInfo
          - `accountType` 'US_ACCOUNT', required
          - `accountNumber` string, required — US bank account number
          - `routingNumber` string, required — ACH routing number (9 digits)
          - `accountCategory` 'CHECKING' | 'SAVINGS', required — Type of account (checking or savings)
          - `bankName` string — Name of the bank
        - PixAccountInfo
          - `accountType` 'PIX', required
          - `pixKey` string, required — PIX key for Brazilian instant payments
          - `pixKeyType` 'CPF' | 'CNPJ' | 'EMAIL' | 'PHONE' | 'RANDOM', required — Type of PIX key being used
          - `taxId` string, required — Tax ID of the account holder
        - IbanAccountInfo
          - `accountType` 'IBAN', required
          - `iban` string, required — International Bank Account Number
          - `swiftBic` string, required — SWIFT/BIC code (8 or 11 characters)
        - UpiAccountInfo
          - `accountType` 'UPI', required
          - `vpa` string, required — Virtual Payment Address for UPI payments
        - SparkWalletInfo
          - `accountType` 'SPARK_WALLET', required
          - `address` string, required — Spark wallet address
        - object
          - `accountType` 'LIGHTNING', required
          - `invoice` string, required — Invoice for the payment
        - SolanaWalletInfo
          - `accountType` 'SOLANA_WALLET', required
          - `address` string, required — Solana wallet address
        - TronWalletInfo
          - `accountType` 'TRON_WALLET', required
          - `address` string, required — Tron wallet address
        - PolygonWalletInfo
          - `accountType` 'POLYGON_WALLET', required
          - `address` string, required — Polygon eth wallet address
        - BaseWalletInfo
          - `accountType` 'BASE_WALLET', required
          - `address` string, required — Base eth wallet address
    - `createdAt` string, date-time, required — Timestamp when the internal account was created
    - `updatedAt` string, date-time, required — Timestamp when the internal account was last updated

## Other responses

- `400` — Bad request - Invalid parameters
- `401` — Unauthorized
- `500` — Internal service error

## Changes

- **2026-01-28** `f3b295b6fbcc` — 2 info
  - removed `FBO` discriminator mapping keys from the `data/items/fundingPaymentInstructions/items/accountOrWalletInfo` response property for the response status `200`
  - removed `#/components/schemas/PaymentFboAccountInfo` from the `data/items/fundingPaymentInstructions/items/accountOrWalletInfo` response property `oneOf` list for the response status `200`
- **2026-01-28** `d1490309094a` — 1 info
  - removed `subschema #1` from the `data/items/fundingPaymentInstructions/items/accountOrWalletInfo/oneOf[subschema #5: FBO Account]/` response property `allOf` list for the response status `200`
- **2026-01-28** `60af1189794c` — 1 breaking, 1 info
  - the `data/items/fundingPaymentInstructions/items/accountOrWalletInfo` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - added the required property `data/items/fundingPaymentInstructions/items/accountOrWalletInfo/accountType` to the response with the `200` status
- **2026-01-24** `36c697116132` — 1 breaking, 1 info
  - the `data/items/fundingPaymentInstructions/items/accountOrWalletInfo/oneOf[subschema #8: Lightning Invoice]/` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - removed `#/components/schemas/PaymentAccountOrWalletInfo` from the `data/items/fundingPaymentInstructions/items/accountOrWalletInfo/oneOf[subschema #8: Lightning Invoice]/` response property `allOf` list for the response status `200`

[Change history](https://skmtc.dev/lightsparkdev/apis/grid-api/changes/platform/internal-accounts/get.md)

---

[API](https://skmtc.dev/lightsparkdev/apis/grid-api.md) · [All operations](https://skmtc.dev/lightsparkdev/apis/grid-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lightsparkdev/grid-api/revisions/f3b295b6fbcc/schema)