Sign in

v1

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

Get User Business Hours

Returns the user business hours schedule. Business hours (and After hours - all the remaining time) schedules are commonly used for setting call handling rules - business-hours-rule and after-hours-rule correspondingly. Please note: If the user business hours are set to 'Custom hours' then a particular schedule is returned; however if set to '24 hours/7 days a week' the schedule will be empty.

get/restapi/v1.0/account/{accountId}/extension/{extensionId}/business-hours

Path parameters

accountIdstring required

Internal identifier of the RingCentral account (can be set to "~" to indicate that the account associated with current authorization session should be used)

extensionIdstring required

Internal identifier of the RingCentral extension/user (can be set to "~" to indicate that the extension associated with current authorization session should be used)

Response

OK

uristring uri

Canonical URI of a business-hours resource

Example response

{
  "uri": "https://restapi/v1.0/account/401800045008/extension/401800045008/business-hours",
  "schedule": {
    "weeklyRanges": {
      "wednesday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "friday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "tuesday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "monday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ],
      "thursday": [
        {
          "from": "09:00",
          "to": "18:00"
        }
      ]
    }
  }
}