> ## 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 has active membership on

`GET /api/v2/accounts`

Returns every account you can switch into. Use it to discover the accounts under your organization or to find the account ID for a subsequent domain or membership operation.

## Request

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

## Parameters

None. Accounts are scoped to the authenticated user's memberships.

## Response

```json theme={null}
{
  "accounts": [
    {
      "id": 100,
      "company": "Northwind Media",
      "name": "Northwind",
      "role": "ADMIN"
    },
    {
      "id": 200,
      "company": "Northwind Retail",
      "name": "Retail",
      "role": "MEMBER"
    }
  ]
}
```

| Field                | Type    | Notes                                                                        |
| -------------------- | ------- | ---------------------------------------------------------------------------- |
| `accounts[]`         | array   | One entry per account you have access to                                     |
| `accounts[].id`      | integer | Account ID                                                                   |
| `accounts[].company` | string  | Company name                                                                 |
| `accounts[].name`    | string  | Display name                                                                 |
| `accounts[].role`    | string  | Your role on this account (`MEMBER`, `ADMIN`, `SUPER_ADMIN`). May be omitted |

## Errors

* `401 UNAUTHORIZED` — missing or invalid API key.

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

## Related

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

  <Card title="Get current account" href="/v2/storefront/account/tasks/get-current-account" icon="id-card">
    The account you are operating as
  </Card>

  <Card title="Create account" href="/v2/storefront/account/tasks/create-child-account" icon="plus">
    Provision a new account
  </Card>
</CardGroup>