---
title: "Read a Resource Preference"
method: GET
path: "/notifications/v1/resource-preferences/{id}"
tags: ["Resource Preferences (notifications/v1)"]
---

# Read a Resource Preference

`GET /notifications/v1/resource-preferences/{id}`

[![General Availability](https://img.shields.io/badge/Lifecycle%20Stage-General%20Availability-%2345c6e8)](#section/Versioning/API-Lifecycle-Policy)

Make a request to read a resource preference.

## Path parameters

- `id` string, required

## Response `200`

Resource Preference.

- object — `ResourcePreference` objects represent the intent of the customers to enable or disable all notifications at the resource level. A ResourcePreference is created for a specific Confluent Cloud Resource (e.g., a connector) and determines whether the user will receive notifications for that resource. This API allows you to create, retrieve, update and delete resourcePreferences. Related guide: [Cloud Notifications](https://docs.confluent.io/cloud/current/monitoring/configure-notifications.html#notifications-for-ccloud). ## The Resource Preferences Model <SchemaDefinition schemaRef="#/components/schemas/notifications.v1.ResourcePreference" />
  - `api_version` 'notifications/v1', required — APIVersion defines the schema version of this representation of a resource.
  - `kind` 'ResourcePreference', required — Kind defines the object this REST resource represents.
  - `id` string, required — ID is the "natural identifier" for an object within its scope/namespace; it is normally unique across time but not space. That is, you can assume that the ID will not be reclaimed and reused after an object is deleted ("time"); however, it may collide with IDs for other object `kinds` or objects of the same `kind` within a different scope/namespace ("space").
  - `metadata` object — ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
    - `self` string, uri, required — Self is a Uniform Resource Locator (URL) at which an object can be addressed. This URL encodes the service location, API version, and other particulars necessary to locate the resource at a point in time
    - `resource_name` string, uri — Resource Name is a Uniform Resource Identifier (URI) that is globally unique across space and time. It is represented as a Confluent Resource Name
    - `created_at` string, date-time — The date and time at which this object was created. It is represented in RFC3339 format and is in UTC.
    - `updated_at` string, date-time — The date and time at which this object was last updated. It is represented in RFC3339 format and is in UTC.
    - `deleted_at` string, date-time — The date and time at which this object was (or will be) deleted. It is represented in RFC3339 format and is in UTC.
  - `resource` string, required — Denotes the Confluent Cloud resource definition.
  - `resource_type` string, required — Denotes the Confluent Cloud resource type.
  - `current_state` string — Denotes the state of the resource preference. When the resource preference is ENABLED, the user will receive notifications for the Confluent Cloud resource. If the resource preference is DISABLED, the user will not receive any notification for the resource. Note that, you will still receive notifications for `REQUIRED` notification type even when it is DISABLED.

## Other responses

- `400` — Bad Request
- `401` — The request lacks valid authentication credentials for this resource.
- `403` — The access credentials were considered insufficient to grant access
- `404` — Not Found
- `429` — Rate Limit Exceeded
- `500` — Oops, something went wrong!

---

[API](https://skmtc.dev/confluent/apis/confluent-cloud-apis.md) · [All operations](https://skmtc.dev/confluent/apis/confluent-cloud-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/confluent/confluent-cloud-apis/revisions/a6a73f98a698/schema)