v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB
Greetings

Get Standard Greeting

Returns a standard greeting by ID.

get/restapi/v1.0/dictionary/greeting/{greetingId}

Path parameters

greetingIdstring required

Internal identifier of a greeting

Response

OK

idstring

Internal identifier of a greeting

uristring uri

Link to a greeting

namestring

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.

textstring

Text of a greeting, if any

contentUristring 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']

Example response

{
  "paging": {
    "perPage": 50,
    "page": 5,
    "pageEnd": 5,
    "totalPages": 25,
    "totalElements": 25
  }
}