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

# Accounts

> Trading account management for partners

The Accounts API provides trading account information for partners. Accounts are the containers for positions, balances, and order history.

<Info>
  **Automatic Account Creation**

  Trading accounts are created automatically when a user's KYC verification is approved. There is no manual account creation endpoint. See [KYC Verification](/partners/kyc/overview) for details on the user onboarding flow.
</Info>

## Endpoints

| Method | Endpoint       | Description           |
| ------ | -------------- | --------------------- |
| `GET`  | `/v1/accounts` | List trading accounts |

<Note>
  For user identity information, see the [Users API](/partners/users) which provides `GET /v1/whoami` and `GET /v1/users`.
</Note>

## Account Hierarchy

```
Partner (Firm)
└── Users (created via KYC)
    └── Accounts (auto-provisioned)
        └── Positions & Orders
```

* **Firm**: Your partner organization
* **Users**: Individual retail traders (created when KYC is approved)
* **Accounts**: Trading accounts (automatically provisioned with user)

## List Accounts

Returns the trading accounts available to the authenticated user.

### Request

```bash theme={null}
GET /v1/accounts
```

Optional query parameter:

* `user` - Filter by user ID

### Response

```json theme={null}
{
  "accounts": [
    "firms/ISV-Participant-Acme/accounts/user-123-trading",
    "firms/ISV-Participant-Acme/accounts/user-456-trading"
  ],
  "displayNames": [
    "John's Trading Account",
    "Jane's Trading Account"
  ]
}
```

### Response Fields

| Field          | Type  | Description                                   |
| -------------- | ----- | --------------------------------------------- |
| `accounts`     | array | EP3 account identifiers                       |
| `displayNames` | array | Human-readable account names (parallel array) |

## User vs Account

| Entity      | Description                                                                   |
| ----------- | ----------------------------------------------------------------------------- |
| **User**    | A person with identity (KYC verified). Created automatically on KYC approval. |
| **Account** | A trading account with balances and positions. Auto-provisioned with user.    |

A user can have multiple accounts for different purposes (e.g., separate trading strategies).

## Related APIs

* [Users API](/partners/users) - Get user identity and list users
* [KYC Verification](/partners/kyc/overview) - User onboarding (creates users & accounts)
* [Positions API](/api-reference/positions/overview) - Check account balances and positions