# Get grant settings

> **GET** `https://api.us.nylas.com/v3/grants/{grant_id}/settings`

Source: https://developer.nylas.com/docs/reference/api/manage-grants/get_grant_settings/

Returns every public setting for the grant, one key per setting. A setting that isn't set is
`null`. The response schema describes each setting.

**Authentication:** NYLAS_API_KEY

## Parameters

### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `grant_id` | string | Yes | ID of the grant to access. |

## Responses

### 200 - OK

- `request_id` (string) - The request ID.
- `data` (object) - The grant's public settings. Each key is the setting name, the same as in the path. A setting that isn't set
is `null`.
  - `synced-calendars` (array, nullable, maxItems: 50) - The calendars that Nylas syncs and sends `calendar.*` and `event.*` notifications for on this
grant, as provider calendar IDs. `null` when the grant has no list, which means the
**Subscribe to primary calendars only** setting in the Dashboard applies. For how the two
interact, see
[Sync and notify for specific calendars](/docs/v3/calendar/#sync-and-notify-for-specific-calendars).

### 401 - Not Authenticated

- `request_id` (string) **(required)** - ID of the request
- `error` (object) **(required)** - Error object
  - `type` (string) - Type of error
  - `message` (string, default: `"Authentication error"`) - Informative error message
  - `provider_error` (object) - (OPTIONAL) informative error message from provider's side

## Code samples

### cURL

```bash
curl --request GET \
  --url 'https://api.us.nylas.com/v3/grants/<NYLAS_GRANT_ID>/settings' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <NYLAS_API_KEY>'

```