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

> Read an account's membership access settings

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

Returns the membership settings for an account, including whether domain auto-join is enabled. Requires `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        | In   | Type   | Required | Notes                     |
| ------------ | ---- | ------ | -------- | ------------------------- |
| `customerId` | path | string | Yes      | 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 immediately as members without admin approval. Defaults on for top-level organizations and off for child accounts; requires `customerDomain` to be set |

## Errors

* `401 UNAUTHORIZED` — missing or invalid bearer token.
* `403 FORBIDDEN` — caller is not an `ADMIN` on the target account.
* `404 NOT_FOUND` — the account does not exist or is not visible to the caller.

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

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