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

# List accounts

> List every account the authenticated user can access

`GET /api/v2/accounts`

Returns all accounts the authenticated user has active membership on. Use it to populate an account switcher or to discover the `id` you pass to admin operations.

## Request

```bash curl theme={null}
curl https://api.interchange.io/api/v2/accounts \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
```

## Parameters

None.

## Response

```json theme={null}
{
  "accounts": [
    {
      "id": 100,
      "company": "Acme Inc",
      "name": "Acme",
      "role": "ADMIN"
    },
    {
      "id": 205,
      "company": "Acme Retail",
      "name": "Acme Retail",
      "role": "MEMBER"
    }
  ]
}
```

| Field                | Type    | Notes                                                        |
| -------------------- | ------- | ------------------------------------------------------------ |
| `accounts`           | array   | Accounts the user has access to                              |
| `accounts[].id`      | integer | Account ID                                                   |
| `accounts[].company` | string  | Company name                                                 |
| `accounts[].name`    | string  | Display name                                                 |
| `accounts[].role`    | string  | User role on this account (`MEMBER`, `ADMIN`, `SUPER_ADMIN`) |

## Errors

* `401 UNAUTHORIZED` — missing or invalid bearer token.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Account tasks" href="/v2/buyer/account/tasks" icon="list-check">
    All account operations
  </Card>

  <Card title="Get current account" href="/v2/buyer/account/tasks/get-current-account" icon="circle-user">
    Your current context
  </Card>

  <Card title="Create account" href="/v2/buyer/account/tasks/create-child-account" icon="plus">
    Add an account under your organization
  </Card>
</CardGroup>