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

# List Partner Sub-Accounts

> Lists partner-owned sub-accounts created under the authenticated partner profile, or recovers a specific sub-account by account address. Requires HMAC authentication with the `account_creation` scope. Do not send `x-on-behalf-of`; results are always scoped to the authenticated partner.

<Info>
  Requires **HMAC authentication** with the `account_creation` scope. API key
  auth, Privy auth, and session auth are not accepted.
</Info>

Lists partner-owned sub-accounts created under the authenticated partner profile.
Use the optional `account` query parameter to recover the `profileId` for a
known sub-account address.

<Warning>
  Do not send `x-on-behalf-of` to this endpoint. It always scopes results to the
  authenticated partner.
</Warning>

## Query parameters

| Parameter | Type     | Required | Description                                                                         |
| --------- | -------- | -------- | ----------------------------------------------------------------------------------- |
| `account` | `string` | No       | Exact EVM address filter. Matching is case-insensitive.                             |
| `limit`   | `number` | No       | Positive integer page size. Defaults to `25`; values above `25` are capped to `25`. |
| `page`    | `number` | No       | Positive integer page number. Defaults to `1`.                                      |

## Response

```json theme={null}
{
  "data": [
    {
      "profileId": 294,
      "account": "0x1676716Ef7F19B5C5d690631CB57cf0bFD900A3d",
      "displayName": "user-bob"
    }
  ],
  "limit": 25,
  "page": 1,
  "hasMore": false
}
```

## Errors

| Status | Description                                                 |
| ------ | ----------------------------------------------------------- |
| `400`  | Invalid `account`, `limit`, or `page` query parameter.      |
| `401`  | Missing or invalid authentication.                          |
| `403`  | Requires api-token HMAC auth with `account_creation` scope. |


## OpenAPI

````yaml GET /profiles/partner-accounts
openapi: 3.0.0
info:
  title: Limitless Exchange API
  description: >-
    Production-ready REST API for prediction market trading, portfolio
    management, and market data on Limitless Exchange (Base L2).
  version: '1.0'
  contact:
    name: API Support
    url: https://limitless.exchange
    email: help@limitless.network
servers:
  - url: https://api.limitless.exchange
    description: Production API
security: []
tags:
  - name: Authentication
    description: User authentication and session management
  - name: Markets
    description: Browse, search, and analyze prediction markets
  - name: Market Navigation
    description: Navigation tree, market pages, and property filters
  - name: Trading
    description: Create, manage, and cancel orders
  - name: Portfolio
    description: Position tracking, trade history, and performance
  - name: API Tokens
    description: Scoped API token management for partner integrations
  - name: Partner Accounts
    description: Sub-account creation and allowance recovery for partner integrations
  - name: System
    description: Public API state and availability information
paths:
  /profiles/partner-accounts:
    get:
      tags:
        - Partner Accounts
      summary: List partner sub-accounts
      description: >-
        Lists partner-owned sub-accounts created under the authenticated partner
        profile, or recovers a specific sub-account by account address. Requires
        HMAC authentication with the `account_creation` scope. Do not send
        `x-on-behalf-of`; results are always scoped to the authenticated
        partner.
      operationId: ProfileController_listPartnerAccounts
      parameters:
        - name: account
          in: query
          required: false
          schema:
            type: string
          description: Optional EVM address filter. Matching is exact and case-insensitive.
          example: '0x1676716Ef7F19B5C5d690631CB57cf0bFD900A3d'
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            default: 25
          description: Page size. Values above 25 are capped to 25.
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
          description: Page number.
      responses:
        '200':
          description: Partner sub-account list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListPartnerAccountsResponse'
        '400':
          description: Invalid account, limit, or page query parameter
        '401':
          description: Missing or invalid authentication
        '403':
          description: Requires apiToken auth with account_creation scope
      security:
        - HmacAuth: []
components:
  schemas:
    ListPartnerAccountsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/PartnerAccountListItem'
        limit:
          type: integer
          description: Page size used by the server. Maximum is 25.
          example: 25
        page:
          type: integer
          description: Current page number
          example: 1
        hasMore:
          type: boolean
          description: Whether another page is available
          example: false
      required:
        - data
        - limit
        - page
        - hasMore
    PartnerAccountListItem:
      type: object
      properties:
        profileId:
          type: integer
          description: Profile ID of the partner-owned sub-account
          example: 294
        account:
          type: string
          description: Wallet address of the sub-account
          example: '0x1676716Ef7F19B5C5d690631CB57cf0bFD900A3d'
        displayName:
          type: string
          description: Public display name of the sub-account
          example: user-bob
      required:
        - profileId
        - account
        - displayName
  securitySchemes:
    HmacAuth:
      type: apiKey
      in: header
      name: lmts-api-key
      description: >-
        Scoped API token with HMAC-SHA256 signing. Requires three headers:
        lmts-api-key (token ID), lmts-timestamp (ISO-8601), lmts-signature
        (Base64-encoded HMAC). See Authentication docs for details.

````