List of organization notifications

Disclaimer: This beta endpoint is evolving; the API contract may change.

Returns notifications for the organization, most recent first. Only notifications about resources the caller can access are returned, so two keys in the same organization can see different results. The notification types endpoint lists the types this organization can receive, so it shows what to expect here. Notifications are retained for 180 days. A page holds at most limit notifications (default 100, maximum 250; a larger value is clamped) and the server may return fewer. Every response carries limit and nextCursor; pass nextCursor as the cursor query parameter to fetch the next page, repeating until it is null.

GET

organizations

{organizationId}

notifications

List of organization notifications

curl --request GET \
  --url https://api.clickhouse.cloud/v1/organizations/{organizationId}/notifications \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://api.clickhouse.cloud/v1/organizations/{organizationId}/notifications"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.clickhouse.cloud/v1/organizations/{organizationId}/notifications', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.clickhouse.cloud/v1/organizations/{organizationId}/notifications",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.clickhouse.cloud/v1/organizations/{organizationId}/notifications"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.clickhouse.cloud/v1/organizations/{organizationId}/notifications")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

{
  "status": 200,
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "result": [
    {
      "id": "1b7e0a94-2d0f-4c3a-8f1e-6c9b2d5a4e7f",
      "type": "service_backup_failed",
      "severity": "warning",
      "resourceType": "service",
      "resourceId": "<string>",
      "createdAt": "2026-10-07T09:30:00Z",
      "title": "Backup failed for analytics-prod",
      "description": "A scheduled backup for analytics-prod did not complete. Review the backup settings (https://console.clickhouse.cloud/services/abc/backups).",
      "resourceName": "<string>"
    }
  ],
  "limit": 123,
  "nextCursor": "<string>"
}

{
  "status": 400,
  "error": "<string>",
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "status": 500,
  "error": "<string>",
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Beta Disclaimer: This beta endpoint is evolving; the API contract may change.

Returns notifications for the organization, most recent first. Only notifications about resources the caller can access are returned, so two keys in the same organization can see different results. The notification types endpoint lists the types this organization can receive, so it shows what to expect here. Notifications are retained for 180 days. A page holds at most limit notifications (default 100, maximum 250; a larger value is clamped) and the server may return fewer. Every response carries limit and nextCursor; pass nextCursor as the cursor query parameter to fetch the next page, repeating until it is null.

Authorizations

Authorization

string

header

required

Use key ID and key secret obtained in ClickHouse Cloud console: https://clickhouse.com/docs/cloud/manage/openapi

Path Parameters

organizationId

string<uuid>

required

ID of the organization the notifications belong to.

Query Parameters

limit

integer

default:100

Maximum number of results to return.

Required range: 1 <= x <= 250

cursor

string

Opaque cursor from a previous response's nextCursor, marking where to resume the list.

severity

string

Filter to notifications of this severity: 'info', 'warning', 'critical'.

Example:

"warning"

type

string

Filter to notifications of this type. New types are added over time; the notification types endpoint lists the ones this organization can receive.

resource_id

string

Filter to notifications about this resource. A service also matches the notifications of its ClickPipes; pass resource_type to narrow to one kind of resource.

resource_type

string

Filter to notifications about resources of this kind. One of 'service', 'organization', 'clickpipe', 'postgres'.

Example:

"service"

from_date

string<date-time>

Return notifications created at or after this time. An RFC 3339 timestamp, not a bare date.

Example:

"2026-10-01T00:00:00Z"

to_date

string<date-time>

Return notifications created at or before this time. An RFC 3339 timestamp, not a bare date.

Example:

"2026-10-08T00:00:00Z"

Response

Successful response

status

number

HTTP status code.

Example:

200

requestId

string<uuid>

Unique id assigned to every request. UUIDv4

result

object[]

Show child attributes

limit

integer

Maximum number of results returned in this page.

nextCursor

string | null

Cursor for the next page, to be sent as the cursor query parameter. Null on the last page.

List of organization notifications

curl --request GET \
  --url https://api.clickhouse.cloud/v1/organizations/{organizationId}/notifications \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://api.clickhouse.cloud/v1/organizations/{organizationId}/notifications"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.clickhouse.cloud/v1/organizations/{organizationId}/notifications', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.clickhouse.cloud/v1/organizations/{organizationId}/notifications",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.clickhouse.cloud/v1/organizations/{organizationId}/notifications"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.clickhouse.cloud/v1/organizations/{organizationId}/notifications")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

{
  "status": 200,
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "result": [
    {
      "id": "1b7e0a94-2d0f-4c3a-8f1e-6c9b2d5a4e7f",
      "type": "service_backup_failed",
      "severity": "warning",
      "resourceType": "service",
      "resourceId": "<string>",
      "createdAt": "2026-10-07T09:30:00Z",
      "title": "Backup failed for analytics-prod",
      "description": "A scheduled backup for analytics-prod did not complete. Review the backup settings (https://console.clickhouse.cloud/services/abc/backups).",
      "resourceName": "<string>"
    }
  ],
  "limit": 123,
  "nextCursor": "<string>"
}

{
  "status": 400,
  "error": "<string>",
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "status": 500,
  "error": "<string>",
  "requestId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Get started

Services and infrastructure

Bring Your Own Cloud

Data and integrations

Connect and query

Access management

Security and compliance

Monitoring and backups

AI tools and agents

Cloud API

Billing

Support

ClickHouse Private

List of organization notifications

Authorizations

Path Parameters

Query Parameters

Response