> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rolla.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# List Accounts

> Lists all accounts owned by the same user as your API key's business, including the originating account, with their application status.

Lists every account owned by the same user as your API key's business — including the account your API key belongs to — with each application's status.

## Example Request

```bash theme={null}
curl -X GET "https://api.rolla.xyz/api/v1/external/accounts?page=1&pageSize=20" \
  -H "X-API-Key: your_api_key_here"
```

## Example Response

```json theme={null}
{
  "success": true,
  "message": "Accounts retrieved successfully",
  "data": {
    "accounts": [
      {
        "id": "6adb1c69-f42c-493c-9f66-6e8cfd6d2c35",
        "name": "Acme Trading Ltd",
        "email": "owner@example.com",
        "entityType": "business",
        "applicationId": "4d4ad44f-8e72-4be8-83f6-1e6c69e77962",
        "applicationStatus": "approved",
        "currentStep": 6,
        "isComplete": true,
        "createdAt": "2026-06-12T23:28:05.373Z"
      },
      {
        "id": "b6075be0-f1d0-451f-a468-3e94563101d2",
        "name": "Jane Doe",
        "email": "owner@example.com",
        "entityType": "individual",
        "applicationId": "f436daf8-146b-4949-bf28-9b36440085a4",
        "applicationStatus": "submitted",
        "currentStep": 3,
        "isComplete": true,
        "createdAt": "2026-06-12T23:30:43.040Z"
      }
    ],
    "page": 1,
    "pageSize": 20,
    "totalCount": 2,
    "totalPages": 1,
    "hasMore": false
  }
}
```

## Query Parameters

| Parameter    | Type    | Required | Description                                                                                      |
| ------------ | ------- | -------- | ------------------------------------------------------------------------------------------------ |
| `page`       | integer | No       | Page number (default `1`)                                                                        |
| `pageSize`   | integer | No       | Results per page (default `20`, max `100`)                                                       |
| `entityType` | string  | No       | Filter by `business` or `individual`                                                             |
| `status`     | string  | No       | Filter by application status (`draft`, `submitted`, `approved`, `rejected`, `changes_requested`) |


## OpenAPI

````yaml GET /accounts
openapi: 3.1.0
info:
  title: Rolla Developer API
  description: >-
    API for programmatic transaction management on the Rolla platform. Monetary
    `amount` fields use the smallest unit of the referenced currency unless an
    endpoint says otherwise (e.g. NGN = kobo, USD = cents, where **100 cents =
    USD 1.00**).
  version: 1.0.0
servers:
  - url: https://api.rolla.xyz/api/v1/external
    description: Production server
security:
  - apiKeyAuth: []
paths:
  /accounts:
    get:
      summary: List Accounts
      description: >-
        Lists all accounts owned by the same user as your API key's business,
        including the originating account, with their application status.
      operationId: listAccounts
      parameters:
        - name: page
          in: query
          schema:
            type: integer
            default: 1
        - name: pageSize
          in: query
          schema:
            type: integer
            default: 20
            maximum: 100
        - name: entityType
          in: query
          schema:
            type: string
            enum:
              - business
              - individual
        - name: status
          in: query
          description: Filter by application status
          schema:
            type: string
            enum:
              - draft
              - submitted
              - approved
              - rejected
              - changes_requested
      responses:
        '200':
          description: Accounts retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Accounts retrieved successfully
                  data:
                    type: object
                    properties:
                      accounts:
                        type: array
                        items:
                          $ref: '#/components/schemas/Account'
                      page:
                        type: integer
                      pageSize:
                        type: integer
                      totalCount:
                        type: integer
                      totalPages:
                        type: integer
                      hasMore:
                        type: boolean
        '401':
          description: Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: >-
            Your business is not a white-label tenant. The entire /accounts
            onboarding API (create, onboard, issue bank accounts, list, get) is
            available to white-label partners only.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                status: 403
                message: >-
                  Account onboarding is available to white-label partners only.
                  Contact Rolla to enable white-label for your business.
components:
  schemas:
    Account:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
          example: Beta Logistics LLC
        email:
          type: string
          format: email
          description: Owner's email (shared across all of the owner's accounts)
        entityType:
          type: string
          enum:
            - business
            - individual
        applicationId:
          type: string
          format: uuid
        applicationStatus:
          type: string
          enum:
            - draft
            - submitted
            - approved
            - rejected
            - changes_requested
        currentStep:
          type: integer
          example: 1
        isComplete:
          type: boolean
        createdAt:
          type: string
          format: date-time
    Error:
      type: object
      properties:
        success:
          type: boolean
          example: false
        message:
          type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Your Rolla API key

````