---
title: "Get User Business Hours"
method: GET
path: "/restapi/v1.0/account/{accountId}/extension/{extensionId}/business-hours"
tags: ["Business Hours"]
---

# Get User Business Hours

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

## Request

- Base URL: `https://platform.ringcentral.com`
- URL: `https://platform.ringcentral.com/restapi/v1.0/account/{accountId}/extension/{extensionId}/business-hours`
- Auth: OAuth 2
  - Authorization code: `https://platform.ringcentral.com/restapi/oauth/authorize`
  - Token URL: `https://platform.ringcentral.com/restapi/oauth/token`
- TypeScript: <https://skmtc.dev/ringcentral/apis/ringcentral-api/docs/restapi/v1.0/account/:accountId/extension/:extensionId/business-hours/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Path parameters

- `accountId` string, required
- `extensionId` string, required

## Response `200`

OK

- GetUserBusinessHoursResponse
  - `uri` string, uri: Canonical URI of a business-hours resource
  - `schedule` ScheduleInfoUserBusinessHours: Schedule when an answering rule is applied
    - `weeklyRanges` WeeklyScheduleInfo: Weekly schedule
      - `monday` TimeInterval[]: Time intervals for a particular day
        - `from` string: Time in format hh:mm
        - `to` string: Time in format hh:mm
      - `tuesday` TimeInterval[]: Time intervals for a particular day
        - `from` string: Time in format hh:mm
        - `to` string: Time in format hh:mm
      - `wednesday` TimeInterval[]: Time intervals for a particular day
        - `from` string: Time in format hh:mm
        - `to` string: Time in format hh:mm
      - `thursday` TimeInterval[]: Time intervals for a particular day
        - `from` string: Time in format hh:mm
        - `to` string: Time in format hh:mm
      - `friday` TimeInterval[]: Time intervals for a particular day
        - `from` string: Time in format hh:mm
        - `to` string: Time in format hh:mm
      - `saturday` TimeInterval[]: Time intervals for a particular day
        - `from` string: Time in format hh:mm
        - `to` string: Time in format hh:mm
      - `sunday` TimeInterval[]: Time intervals for a particular day
        - `from` string: Time in format hh:mm
        - `to` string: Time in format hh:mm

## Other responses

- `404`: General response with **HTTP 404 "Not found"** status.<br> Reasons: the entity with given ID (typically specified in a path parameter), is not found or inaccessible
- `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.dev/ringcentral/apis/ringcentral-api.md) - [All operations](https://skmtc.dev/ringcentral/apis/ringcentral-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ringcentral/apis/ringcentral-api/revisions/8d602198ec97?raw)