Notifications: list

Requires authorization

Retrieves a list of notifications. Try it now.


HTTP request



Parameter name Value Description
Path parameters
customer string The unique ID for the customer's G Suite account.
Optional query parameters
language string The ISO 639-1 code of the language notifications are returned in. The default is English (en).
maxResults unsigned integer Maximum number of notifications to return per page. The default is 100.
pageToken string The token to specify the page of results to retrieve.


This request requires authorization with the following scope (read more about authentication and authorization).


Request body

Do not supply a request body with this method.


If successful, this method returns a response body with the following structure:

  "kind": "admin#directory#notifications",
  "etag": etag,
  "unreadNotificationsCount": integer,
  "items": [
    notifications Resource
  "nextPageToken": string
Property name Value Description Notes
kind string The type of the resource.
etag etag ETag of the resource.
unreadNotificationsCount integer Number of unread notification for the domain.
items[] list List of notifications in this page.
nextPageToken string Token for fetching the next page of notifications.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.