> ## 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.

# Get membership

> Read an account's membership settings, including domain auto-join

`GET /api/v2/accounts/{customerId}/membership`

Returns the membership access settings for an account, including whether domain auto-join is enabled. Requires the `ADMIN` role.

## Request

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

## Parameters

| Field        | Type   | Required | Notes                                     |
| ------------ | ------ | -------- | ----------------------------------------- |
| `customerId` | string | Yes      | Path parameter. ID of the account to read |

## Response

```json theme={null}
{
  "customerId": 200,
  "allowDomainAutoJoin": false
}
```

| Field                 | Type    | Notes                                                                                                                                                                                                                        |
| --------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `customerId`          | integer | Account ID                                                                                                                                                                                                                   |
| `allowDomainAutoJoin` | boolean | Effective setting. When true, users with a verified matching-domain email join as members without admin approval. Defaults on for top-level organizations and off for child accounts; requires a registered `customerDomain` |

## Errors

* `401 UNAUTHORIZED` — caller is not an `ADMIN`.

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="Update membership" href="/v2/storefront/account/tasks/update-membership" icon="user-gear">
    Toggle domain auto-join
  </Card>

  <Card title="Update account domain" href="/v2/storefront/account/tasks/update-customer-domain" icon="globe">
    Set the registered domain
  </Card>
</CardGroup>