> ## Documentation Index
> Fetch the complete documentation index at: https://www.plain.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Business hours

> Read business hours schedules and manage the overrides that change their hours on specific dates.

A business hours schedule is a named set of weekly hours in one timezone, such as `EMEA Hours`, Mon–Fri 09:00–17:00 in `Europe/London`. An override replaces a schedule's weekly hours on a range of dates, for a holiday or a one-off closure. SLA targets, auto-responders, and workflows read both. For how they work in the app, see [Business hours](https://www.plain.com/docs/product/platform/business-hours.md).

<Snippet file="graphql/sdk-note.mdx" />

Use the API to list your schedules, which gives you the IDs that [SLA policy targets](https://www.plain.com/docs/graphql/sla-policies/manage.md) and overrides reference, and to [manage overrides](https://www.plain.com/docs/graphql/business-hours/overrides.md) from your own systems, for example to sync your company's holiday calendar.

These operations require the following permissions:

* `businessHours:read`

## Get business hours schedules

Schedules are sorted by name. Each schedule's `timezone` is the IANA timezone its weekly hours and overrides are read in. This endpoint supports [Pagination](https://www.plain.com/docs/graphql/pagination.md).

<Snippet file="graphql/get-business-hours-schedules.mdx" />

To fetch one schedule, use `businessHoursSchedule(businessHoursScheduleId:)`. It returns `null` when no schedule has the ID.

## How changes reach SLAs

Changing a schedule's hours, or adding, editing, or deleting an override, moves the deadlines of SLA targets counting down on that schedule. The time a target has used stays as it was, and the time left counts against the new hours. See [How SLA time is counted](https://www.plain.com/docs/product/platform/slas/sla-time.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.