# Get a grant setting

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

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

Returns one setting for the grant, in the same shape as
[Get grant settings](/docs/reference/api/manage-grants/get_grant_settings/). If the setting isn't
set, its value is `null`.

**Authentication:** NYLAS_API_KEY

## Parameters

### Path parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `grant_id` | string | Yes | ID of the grant to access. |
| `setting_name` | string, one of: `synced-calendars` | Yes | The setting name. Request and response bodies use the same name as the JSON key. |

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

### 404 - Not Found

- `request_id` (string) - The request ID.
- `error` (object) - The response error object.
  - `type` (string) - The error type.
  - `message` (string) - The error message.

## Code samples

### cURL

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

```