---
title: "List Standard Greetings"
method: GET
path: "/restapi/v1.0/dictionary/greeting"
tags: ["Greetings"]
---

# List Standard Greetings

`GET /restapi/v1.0/dictionary/greeting`

Returns the list of predefined standard greetings. Custom greetings
recorded by user are not returned in response to this request. See Get Extension
Custom Greetings.

## Query parameters

- `page` integer
- `perPage` integer
- `type` 'Introductory' | 'Announcement' | 'ConnectingMessage' | 'ConnectingAudio' | 'Voicemail' | 'Unavailable' | 'HoldMusic' | 'Company'
- `usageType` 'UserExtensionAnsweringRule' | 'ExtensionAnsweringRule' | 'DepartmentExtensionAnsweringRule' | 'CompanyAnsweringRule' | 'CompanyAfterHoursAnsweringRule' | 'VoicemailExtensionAnsweringRule' | 'AnnouncementExtensionAnsweringRule' | 'SharedLinesGroupAnsweringRule'

## Response `200`

OK

- DictionaryGreetingList
  - `uri` string, uri — Canonical URI of greetings list resource
  - `records` DictionaryGreetingInfo[] — List of greetings
    - `id` string — Internal identifier of a greeting
    - `uri` string, uri — Link to a greeting
    - `name` string — Name of a greeting
    - `usageType` 'UserExtensionAnsweringRule' | 'ExtensionAnsweringRule' | 'DepartmentExtensionAnsweringRule' | 'BlockedCalls' | 'CallRecording' | 'CompanyAnsweringRule' | 'CompanyAfterHoursAnsweringRule' | 'LimitedExtensionAnsweringRule' | 'VoicemailExtensionAnsweringRule' | 'AnnouncementExtensionAnsweringRule' | 'SharedLinesGroupAnsweringRule' — Usage type of greeting, specifying if the greeting is applied for user extension or department (call queue) extension.
    - `text` string — Text of a greeting, if any
    - `contentUri` string, uri — Link to a greeting content (audio file), if any
    - `type` 'Introductory' | 'Announcement' | 'AutomaticRecording' | 'BlockedCallersAll' | 'BlockedCallersSpecific' | 'BlockedNoCallerId' | 'BlockedPayPhones' | 'ConnectingMessage' | 'ConnectingAudio' | 'StartRecording' | 'StopRecording' | 'Voicemail' | 'Unavailable' | 'InterruptPrompt' | 'HoldMusic' | 'Company' — Type of greeting, specifying the case when the greeting is played.
    - `category` 'Music' | 'Message' | 'RingTones' | 'None' — Category of a greeting, specifying data form. The category value 'None' specifies that greetings of a certain type ('Introductory', 'ConnectingAudio', etc.) are switched off for an extension = ['Music', 'Message', 'RingTones', 'None']
    - `navigation` PageNavigationModel — Links to other pages of the current result set
      - `firstPage` PageNavigationUri
        - `uri` string, uri — Canonical URI to retrieve the particular page of the result set
      - `nextPage` PageNavigationUri
        - `uri` string, uri — Canonical URI to retrieve the particular page of the result set
      - `previousPage` PageNavigationUri
        - `uri` string, uri — Canonical URI to retrieve the particular page of the result set
      - `lastPage` PageNavigationUri
        - `uri` string, uri — Canonical URI to retrieve the particular page of the result set
    - `paging` EnumeratedPagingModel
      - `perPage` integer, required — Current page size, describes how many items are in each page. Matches "perPage" parameter from the request.
      - `page` integer — The current page number. 1-indexed, so the first page is 1 by default. May be omitted if result is empty (because non-existent page was specified or perPage=0 was requested)
      - `pageStart` integer — The zero-based number of the first element on the current page. Omitted if the page is omitted or result is empty
      - `pageEnd` integer — The zero-based index of the last element on the current page. Omitted if the page is omitted or result is empty
      - `totalPages` integer — The total number of pages in a dataset. May be omitted for some resources due to performance reasons
      - `totalElements` integer — The total number of elements in a dataset. May be omitted for some resource due to performance reasons
  - `navigation` PageNavigationModel — Links to other pages of the current result set
    - `firstPage` PageNavigationUri
      - `uri` string, uri — Canonical URI to retrieve the particular page of the result set
    - `nextPage` PageNavigationUri
      - `uri` string, uri — Canonical URI to retrieve the particular page of the result set
    - `previousPage` PageNavigationUri
      - `uri` string, uri — Canonical URI to retrieve the particular page of the result set
    - `lastPage` PageNavigationUri
      - `uri` string, uri — Canonical URI to retrieve the particular page of the result set
  - `paging` EnumeratedPagingModel
    - `perPage` integer, required — Current page size, describes how many items are in each page. Matches "perPage" parameter from the request.
    - `page` integer — The current page number. 1-indexed, so the first page is 1 by default. May be omitted if result is empty (because non-existent page was specified or perPage=0 was requested)
    - `pageStart` integer — The zero-based number of the first element on the current page. Omitted if the page is omitted or result is empty
    - `pageEnd` integer — The zero-based index of the last element on the current page. Omitted if the page is omitted or result is empty
    - `totalPages` integer — The total number of pages in a dataset. May be omitted for some resources due to performance reasons
    - `totalElements` integer — The total number of elements in a dataset. May be omitted for some resource due to performance reasons

## Other responses

- `500` — General response with **HTTP 500 "Internal Server Error"** status.<br> Reasons: general server-side error.
- `503` — General response with **HTTP 503 "Service not available"** status.<br> Reasons: server cannot process the request because of being overloaded, misconfiguration or other issues.

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/revisions/8d602198ec97/schema)