---
title: "List counterparty accounts"
method: GET
path: "/v1/counterparties/{counterpartyId}/accounts"
tags: ["Counterparties"]
---

# List counterparty accounts

`GET /v1/counterparties/{counterpartyId}/accounts`

## Request

- Base URL: `http://localhost:8787`
- URL: `http://localhost:8787/v1/counterparties/{counterpartyId}/accounts`
- Auth: HTTP bearer

Lists payment accounts for a counterparty. Crypto-wallet accounts can be used by payment flows that send funds to a counterparty wallet.

## Path parameters

- `counterpartyId` string, required: Counterparty identifier.

## Query parameters

- `page` integer: Page number (1-based).
- `pageSize` integer: Items per page (max 100).
- `includeArchived` boolean: Include archived counterparty accounts in results.
- `accountKind` 'crypto_wallet': Filter accounts by account kind.

## Headers

- `x-project-id` string: Required for dashboard sessions. API keys use their assigned project.

## Response `200`

Counterparty account list

- object: Standard success response envelope.
  - `data` object, required: Paginated list of counterparty accounts.
    - `accounts` object[], required: Counterparty accounts.
      - `id` string, required: Counterparty account identifier.
      - `organizationId` string, required: Organization identifier.
      - `projectId` string, required: Project identifier.
      - `counterpartyId` string, required: Counterparty identifier.
      - `accountKind` 'crypto_wallet', required: Counterparty account kind.
      - `label` string, nullable, required: Optional human-readable account label.
      - `details` object, required: Account details. For crypto_wallet accounts, include network: "solana" and address as a Solana wallet address.
      - `providerAccountData` object, required: Provider-specific account metadata preserved by SDP.
      - `status` 'active' | 'archived', required: Counterparty account status.
      - `createdAt` string, date-time, required: Creation timestamp.
      - `updatedAt` string, date-time, required: Last update timestamp.
    - `total` integer, required: Total counterparty accounts matching the query.
    - `page` integer, required: Current page number.
    - `pageSize` integer, required: Items per page.
  - `meta` object, required: Response metadata.
    - `requestId` string, required: Request identifier for tracing.
    - `timestamp` string, date-time, required: ISO 8601 timestamp.

## Other responses

- `400`: Error
- `401`: Error
- `403`: Forbidden. Requires the `counterparties.read` action: an API key must hold it (a module's `manage` or `execute` also covers its `read`), and a signed-in member's organization role must include it. Without it the error is INSUFFICIENT_PERMISSIONS and `error.details.action` names the action. Any other 403 names its own reason.
- `404`: Error
- `500`: Error

## Changes

- **2026-11-02** `9f0b1d561064`: 5 warning
  - added the new `CUSTODY_POLICY_REFUSED` enum value to the `error/code` response property for the response status `400`
  - added the new `CUSTODY_POLICY_REFUSED` enum value to the `error/code` response property for the response status `401`
  - added the new `CUSTODY_POLICY_REFUSED` enum value to the `error/code` response property for the response status `403`
  - added the new `CUSTODY_POLICY_REFUSED` enum value to the `error/code` response property for the response status `404`
  - …1 more
- **2026-10-30** `f4a0135eca08`: 30 warning
  - added the new `RPC_UNAVAILABLE` enum value to the `error/code` response property for the response status `400`
  - added the new `RPC_UNAVAILABLE` enum value to the `error/code` response property for the response status `401`
  - added the new `RPC_UNAVAILABLE` enum value to the `error/code` response property for the response status `403`
  - added the new `RPC_UNAVAILABLE` enum value to the `error/code` response property for the response status `404`
  - …26 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/solana/apis/solana-developer-platform-api/changes/v1/counterparties/:counterpartyId/accounts/get.md)

---

[API](https://skmtc.dev/solana/apis/solana-developer-platform-api.md) - [All operations](https://skmtc.dev/solana/apis/solana-developer-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/solana/apis/solana-developer-platform-api/revisions/47682f5c382e?raw)