> ## Documentation Index > Fetch the complete documentation index at: https://docs.blips.network/llms.txt > Use this file to discover all available pages before exploring further. # List customer-owned internal accounts. > Read customer-owned internal accounts with optional currency, customerId, and cursor filters. This surface is distinct from GET /platform/internal-accounts. In the current MVP, same-currency funding is performed separately via POST /transfer-in. ## OpenAPI ````yaml /openapi/blips-public-reference.yaml get /customers/internal-accounts openapi: 3.1.0 info: title: BLIPS Public Reference API version: '2026-04-08' description: >- Public OpenAPI 3.1 subset for the first BLIPS Mintlify API Reference and Playground release. This document is bound to the confirmed Public Test Backend at https://public-test.blips.network, includes only the approved first-release public endpoints, uses only internal `$ref` values, and excludes callback-only webhook documentation and operator-only surfaces. servers: - url: https://public-test.blips.network description: >- Confirmed Public Test Backend ingress target for public BLIPS API Reference, Playground, and internet-testable Try It flows. security: - BasicAuth: [] tags: - name: Platform Setup description: >- Bootstrap and platform configuration surfaces for establishing the public BLIPS integration context. - name: Sandbox API description: >- Sandbox-only externally displayed helper surfaces. These routes either adjust quote inputs or create incoming-payment review cases, but they always feed the existing quote or transaction families and never become second outward API families. - name: Tokens description: >- Platform-scoped API credential create, list, detail, and revoke operations. - name: Customers description: >- Customer onboarding, profile lifecycle, and PPV payment-address issuance surfaces. - name: Accounts description: >- Customer-bound internal-account and external-account surfaces kept in the first-layer public contract. - name: Same-Currency Transfers description: >- Same-currency receiver lookup plus incoming and outgoing transfer primitives. - name: Cross-Currency Transfers description: >- PPV-first receiver lookup, quote creation/readback, and quote execution for cross-currency flows. - name: Transactions description: Transaction readback plus bounded incoming-review decision operations. - name: Webhooks description: >- Webhook connectivity verification surface for the public BLIPS integration. paths: /customers/internal-accounts: get: tags: - Accounts summary: List customer-owned internal accounts. description: >- Read customer-owned internal accounts with optional currency, customerId, and cursor filters. This surface is distinct from GET /platform/internal-accounts. In the current MVP, same-currency funding is performed separately via POST /transfer-in. operationId: listCustomerInternalAccounts parameters: - name: currency in: query required: false description: Filter by ISO 4217 currency code. schema: type: string - name: customerId in: query required: false description: Filter by the owning customer's system-generated BLIPS customer ID. schema: type: string - name: limit in: query required: false description: Maximum number of results to return. Defaults to 10 and caps at 100. schema: type: integer minimum: 1 maximum: 100 default: 10 - name: cursor in: query required: false description: Pagination cursor returned from a previous list response. schema: type: string responses: '200': description: Customer internal account list returned. content: application/json: schema: $ref: '#/components/schemas/CustomerInternalAccountsMvpResponse' examples: default: 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 '400': description: Invalid internal-account list query parameters. content: application/json: schema: $ref: '#/components/schemas/CustomerInternalAccountsMvpErrorResponse' examples: default: value: status: 400 code: INVALID_REQUEST message: Invalid internal-account list query parameters details: cursor: must be a non-negative integer offset '401': description: Invalid or missing API credentials. content: application/json: schema: $ref: '#/components/schemas/CustomerInternalAccountsMvpErrorResponse' examples: default: value: status: 401 code: UNAUTHORIZED message: Invalid or missing API credentials details: {} '500': description: Internal service error. content: application/json: schema: $ref: '#/components/schemas/CustomerInternalAccountsMvpErrorResponse' examples: default: value: status: 500 code: INTERNAL_ERROR message: Internal service error details: {} security: - BasicAuth: [] components: schemas: CustomerInternalAccountsMvpResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/CustomerInternalAccountMvp' description: Customer-owned internal accounts in the current page of results. hasMore: type: boolean description: Whether another page of internal accounts is available. nextCursor: type: string description: Cursor to use for the next page when hasMore is true. totalCount: type: integer description: Total number of matching internal accounts across all pages. required: - data - hasMore - nextCursor - totalCount additionalProperties: false CustomerInternalAccountsMvpErrorResponse: type: object description: Public error envelope for customer internal-account list failures. additionalProperties: false required: - status - code - message - details properties: status: type: integer description: >- HTTP status code returned for the failed customer internal-account list request. code: type: string description: >- Stable public error code for the failed customer internal-account list request. message: type: string description: >- Human-readable summary of the customer internal-account list failure. details: type: object nullable: true additionalProperties: true description: Additional structured error context when present. CustomerInternalAccountMvp: type: object properties: id: type: string description: Internal account ID for this customer-owned managed balance. customerId: type: string description: Owning customer ID as returned by the customer surface. currency: type: string description: ISO 4217 currency for this internal account. balance: $ref: '#/components/schemas/CustomerInternalAccountMvpBalance' description: Managed customer balance for this account and currency. createdAt: type: string format: date-time description: RFC 3339 creation timestamp for the internal account. updatedAt: type: string format: date-time description: RFC 3339 timestamp for the most recent internal-account update. required: - id - customerId - currency - balance - createdAt - updatedAt additionalProperties: false CustomerInternalAccountMvpBalance: type: object properties: amount: type: integer description: Managed balance amount in minor units. currency: type: string description: ISO 4217 currency for the balance amount. required: - amount - currency additionalProperties: false securitySchemes: BasicAuth: type: http scheme: basic description: >- Integration-key Basic Auth (`clientId:clientSecret`) as documented in docs/public/AUTHENTICATION.md. ````