---
title: "List partner sub-accounts"
method: GET
path: "/profiles/partner-accounts"
tags: ["Partner Accounts"]
---

# List partner sub-accounts

`GET /profiles/partner-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.

## Query parameters

- `account` string
- `limit` integer
- `page` integer

## Response `200`

Partner sub-account list

- ListPartnerAccountsResponse
  - `data` PartnerAccountListItem[], required
    - `profileId` integer, required — Profile ID of the partner-owned sub-account
    - `account` string, required — Wallet address of the sub-account
    - `displayName` string, required — Public display name of the sub-account
  - `limit` integer, required — Page size used by the server. Maximum is 25.
  - `page` integer, required — Current page number
  - `hasMore` boolean, required — Whether another page is available

## Other responses

- `400` — Invalid account, limit, or page query parameter
- `401` — Missing or invalid authentication
- `403` — Requires apiToken auth with account_creation scope

---

[API](https://skmtc.net/limitless-labs-group/apis/limitless-exchange-api.md) · [All operations](https://skmtc.net/limitless-labs-group/apis/limitless-exchange-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/limitless-labs-group/limitless-exchange-api/revisions/f60847044e0d/schema)