> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Hours of Operation API

<Badge icon="arrow-left" color="gray">[Back to API List](/ai-for-service/apis/contact-center/api-list)</Badge>

Use this API to get the hours of operation by providing the `orgId` and `queueId`.

| Method | GET |
| :- | :- |
| **Endpoint** | `https://{{host}}/agentassist/api/public/organizations/{{orgId}}/operationshours/{{queueId}}` |
| **Content-Type** | `application/json` |
| **Authorization** | `auth: {{JWT}}` See [How to generate the JWT Token](/ai-for-service/apis/automation/api-introduction#generating-the-jwt-token). |
| **API Scope** | Configuration |

## Path Parameters

| Parameter | Description | Type |
| :- | :- | :- |
| `host` | Environment URL, for example, `https://platform.kore.ai` | string, required |
| `orgId` | The unique identifier of the organization. In the application, navigate to any screen and check the API response to locate the orgId. Open the browser's developer tools using **F12**, **Ctrl+Shift+J** (Windows/Linux), or **Cmd+Opt+J** (macOS). | string, required |
| `queueId` | The unique identifier of the queue. | string, required |

## Sample Request

```bash theme={null}
curl --location --request GET 'https://{{host}}/agentassist/api/public/organizations/{{orgId}}/operationshours/{{queueId}}' \
--header 'auth: <token>' \
--header 'Content-Type: application/json' \
--header 'accountId: <accountId>'
--header 'IId: <IId>'
```

## Headers

| Header | Description | Required/Optional |
| :- | :- | :- |
| `accountId` | The account ID associated with the API request. | required |
| `auth` | JWT token for authentication. | required |
| `IId` | The appId or streamId. | required |

## Sample Response

```json expandable=true theme={null}
{
    "name": "Default Hours of Operation(Auto Created)1",
    "standardDays": {
        "frequency": "WEEKLY",
        "days": [
            { "start": "9:00 AM", "end": "11:00 PM", "day": "SU" },
            { "start": "12:00 AM", "end": "11:59:59.999 PM", "day": "MO" },
            { "start": "12:00 AM", "end": "11:59:59.999 PM", "day": "TU" },
            { "start": "12:00 AM", "end": "11:00 PM", "day": "WE" },
            { "start": "12:00 AM", "end": "11:00 PM", "day": "TH" },
            { "start": "12:00 AM", "end": "11:00 PM", "day": "FR" },
            { "start": "12:00 AM", "end": "11:59:59.999 PM", "day": "SA" }
        ]
    },
    "specialDays": {
        "frequency": "YEARLY",
        "days": []
    },
    "status": "ACTIVE",
    "lname": "default hours of operation(auto created)1",
    "isDefault": true,
    "orgId": "o-ee9eb154-b7e9-5387-a4a9-bc027a60xxxx",
    "createdBy": "u-d59dd137-fd97-52c2-8e86-fe6b42caxxxx",
    "timezone": "Asia/Kolkata",
    "id": "63c0e807509f957d6601xxxx",
    "isHoursOfOperationValid": true
}
```

## Response Body Parameters

| Parameter | Description | Type |
| :- | :- | :- |
| `name` | Display name of the hours of operation configuration. | string |
| `lname` | Lowercase version of the name. | string |
| `standardDays` | Configuration for regular operating hours. | object |
| `standardDays.frequency` | Frequency of the standard schedule (for example, `"WEEKLY"`). | string |
| `standardDays.days` | An array of daily schedule configurations. | array |
| `standardDays.days[].start` | Start time in 12-hour format (for example, `"9:00 AM"`). | string |
| `standardDays.days[].end` | End time in 12-hour format (for example, `"11:00 PM"`). | string |
| `standardDays.days[].day` | Two-letter day code (SU, MO, TU, WE, TH, FR, SA). | string |
| `specialDays` | Configuration for special operating hours. | object |
| `specialDays.frequency` | Frequency of special schedules (for example, `"YEARLY"`). | string |
| `specialDays.days` | An array of special schedule configurations. | array |
| `status` | Current status of the configuration (for example, `"ACTIVE"`). | string |
| `isDefault` | Indicates if this is the default hours of operation configuration. | boolean |
| `orgId` | The unique identifier of the organization. | string |
| `createdBy` | User ID of the creator. | string |
| `createdByAId` | Creator's agent ID. | string |
| `timezone` | Timezone in IANA format (for example, `"Asia/Kolkata"`). | string |
| `iId` | Internal identifier. | string |
| `id` | Unique identifier for the configuration. | string |
| `isHoursOfOperationValid` | Indicates if the hours of operation configuration is valid. | boolean |


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