Internal Accounts

List platform internal accounts

Changed on

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.

get/platform/internal-accounts

Request

  • Base URL: https://api.lightspark.com/grid/2025-10-13
  • URL: https://api.lightspark.com/grid/2025-10-13/platform/internal-accounts
  • Auth: HTTP basic

Query parameters

currencystring

Filter by currency code

type'INTERNAL_FIAT' | 'INTERNAL_CRYPTO' | 'EMBEDDED_WALLET' | 'RULE_BASED' | 'BULK_SETTLEMENT'

Classification of an internal account.

  • INTERNAL_FIAT: A Grid-managed fiat holding account (for example, the USD holding account used as the source for Payouts flows).
  • INTERNAL_CRYPTO: A Grid-managed crypto holding account denominated in a stablecoin such as USDC.
  • EMBEDDED_WALLET: A self-custodial Embedded Wallet provisioned for the customer. Outbound transfers require a session signature produced by the customer's device — see the Embedded Wallets guide.
  • RULE_BASED: An additional account number for an existing account holder, with a routing rule attached, so incoming payments can be attributed to a specific payer and swept automatically. Created with POST /internal-accounts.
  • BULK_SETTLEMENT: An account for receiving bulk payments (for example, a single settlement from a payment processor) that the platform then pays out to its customers. Only a platform can hold one, and funds in it can move only to the platform's customers.

Filter by internal account type. Use EMBEDDED_WALLET to find the self-custodial wallet provisioned for a customer, INTERNAL_FIAT / INTERNAL_CRYPTO for the platform-managed holding accounts, RULE_BASED for the additional account numbers issued with a sweep rule, or BULK_SETTLEMENT for the account that receives bulk settlements.

Response

Successful operation

Changes

  • 556180e5b2aeRevision changes
    • warning

      added the new ACH_SAME_DAY enum value to the //////////// response property for the response status

    • warning

      added the new ACH_SAME_DAY enum value to the ////////// response property for the response status

    • warning

      added the new BULK_SETTLEMENT enum value to the // response property for the response status

    • info

      added the new enum value BULK_SETTLEMENT to the query request parameter type

  • 5b4d838613abRevision changes
    • warning

      removed the optional property ////////////// from the response with the status

    • info

      added the optional property /////////// to the response with the status