openapi: 3.1.0 info: title: Deliverect Channel Accounts Opening Hours API description: Integrate ordering channels and marketplaces with Deliverect to create and cancel orders, sync menus, snooze products, update store and courier status, and exchange payment events. Authenticates with OAuth 2.0 machine-to-machine access tokens scoped via genericChannel. version: '1.0' x-generated-from: documentation x-source-url: https://developers.deliverect.com/reference x-last-validated: '2026-06-02' contact: name: Kin Lane email: kin@apievangelist.com license: name: All Rights Reserved servers: - url: https://api.deliverect.com description: Production - url: https://api.staging.deliverect.com description: Staging security: - oauth2: [] tags: - name: Opening Hours description: Opening Hours operations for the Deliverect Channel API. paths: /locations/channels/{locationId}/holidays: get: description: Deliverect Get_locations_channels_locationid_holidays responses: '200': description: '' content: application/json: examples: OK: summary: OK value: id: 63********************a7 holidays: - startTime: YYYY-MM-DDTHH:mm:ss.SSSSSSZ endTime: YYYY-MM-DDTHH:mm:ss.SSSSSSZ channels: - id: 63********************a7 holidays: - startTime: YYYY-MM-DDTHH:mm:ss.SSSSSSZ endTime: YYYY-MM-DDTHH:mm:ss.SSSSSSZ - startTime: YYYY-MM-DDTHH:mm:ss.SSSSSSZ endTime: YYYY-MM-DDTHH:mm:ss.SSSSSSZ - startTime: YYYY-MM-DDTHH:mm:ss.SSSSSSZ endTime: YYYY-MM-DDTHH:mm:ss.SSSSSSZ - startTime: YYYY-MM-DDTHH:mm:ss.SSSSSSZ endTime: YYYY-MM-DDTHH:mm:ss.SSSSSSZ schema: type: object properties: id: type: string example: 63********************a7 description: Unique location Id holidays: type: array items: type: object properties: startTime: type: string example: YYYY-MM-DDTHH:mm:ss.SSSSSSZ endTime: type: string example: YYYY-MM-DDTHH:mm:ss.SSSSSSZ channels: type: array items: type: object properties: id: type: string example: 63********************a7 description: The unique store identifier channelLinkId holidays: type: array items: type: object properties: startTime: type: string example: YYYY-MM-DDTHH:mm:ss.SSSSSSZ description: The start time of the holiday period in ISO 8601 date-time format (e.g., "2023-12-19T15:53:00Z") endTime: type: string example: YYYY-MM-DDTHH:mm:ss.SSSSSSZ description: The endTime of the holiday period in ISO 8601 date-time format (e.g., "2023-12-19T16:10"00Z") description: Array containing an object list of holidays description: An array of channel link objects within the location with specific holiday hours set required: - id - holidays '400': content: application/json: schema: type: object properties: {} examples: Bad Request: summary: Bad Request value: '{}' description: Bad Request parameters: - in: path name: locationId schema: type: string required: true description: Unique location Id example: 5cecc6489f0001b8 operationId: get_locations_channels_locationid_holidays summary: Deliverect Get_locations_channels_locationid_holidays tags: - Opening Hours x-microcks-operation: delay: 0 dispatcher: FALLBACK /locations/openingHours: post: summary: Deliverect Create/Update Opening Hours responses: '204': description: No Content content: application/json: schema: type: object properties: {} examples: No Content: summary: No Content value: '{}' '400': description: Bad Request content: application/json: schema: type: object properties: {} examples: Bad Request: summary: Bad Request value: '{}' requestBody: content: application/json: schema: type: object required: - locations properties: locations: type: array items: type: object properties: id: type: string example: 609a1b2c3d4e5f6a7b8c9d0e triggerUpdate: type: boolean example: true openingHours: type: array items: type: object channels: type: array items: type: object examples: Update Example: summary: Update Example value: locations: - id: '{locationId}' triggerUpdate: true openingHours: - dayOfWeek: 1 startTime: '10:00' endTime: '17:00' channels: - id: 6200****fd1f openingHours: - dayOfWeek: 1 startTime: 08:00 endTime: '20:00' operationId: post_post_locations_openinghours description: Deliverect Create/Update Opening Hours tags: - Opening Hours x-microcks-operation: delay: 0 dispatcher: FALLBACK /locations/holidays: post: tags: - Opening Hours summary: Deliverect Holiday Hours for Locations responses: default: description: default content: text/plain: schema: type: string example: null requestBody: content: application/json: schema: type: object properties: {} examples: Example Update: summary: Example Update value: locations: - id: 61c30761e41eefadd03072af holidays: - startTime: '2023-12-19T15:53:00Z' endTime: '2023-12-19T16:10:00Z' - startTime: '2023-12-20T04:00:00Z' endTime: '2023-12-20T05:00:00Z' operationId: post_post_locations_holidays description: Deliverect Holiday Hours for Locations x-microcks-operation: delay: 0 dispatcher: FALLBACK /locations/channels/holidays: post: tags: - Opening Hours summary: Deliverect Holiday Hours for Locations and ChannelLinks requestBody: content: application/json: schema: type: object examples: - locations: - id: someLocationId channels: - id: someChannelLinkId holidays: - startTime: '2021-12-19T15:53:00Z' endTime: '2021-12-19T16:10:00Z' - startTime: '2022-05-18T04:00:00Z' endTime: '2022-05-18T05:00:00Z' - startTime: '2022-05-17T17:37:00Z' endTime: '2022-05-17T17:39:00Z' - startTime: '2023-08-04T09:00:00Z' endTime: '2023-08-04T19:00:00Z' examples: Example Update: summary: Example Update value: locations: - id: 63********************a7 channels: - id: 63********************a7 holidays: - startTime: YYYY-MM-DDTHH:mm:ss.SSSSSSZ endTime: YYYY-MM-DDTHH:mm:ss.SSSSSSZ - startTime: YYYY-MM-DDTHH:mm:ss.SSSSSSZ endTime: YYYY-MM-DDTHH:mm:ss.SSSSSSZ responses: default: description: default content: text/plain: schema: type: string example: null operationId: post_post_locations_channels_holidays description: Deliverect Holiday Hours for Locations and ChannelLinks x-microcks-operation: delay: 0 dispatcher: FALLBACK /account/{accountId}/openingHours: get: tags: - Opening Hours summary: Deliverect Get Account Opening Hours parameters: - name: accountId in: path schema: type: string required: true description: The accountId value. example: 5b71c6489f00290d4 responses: '200': description: Successful response content: application/json: examples: OK: summary: OK value: '{}' '400': content: application/json: schema: type: object properties: {} examples: Bad Request: summary: Bad Request value: '{}' description: Bad Request operationId: get_get_account_accountid_openinghours description: Deliverect Get Account Opening Hours x-microcks-operation: delay: 0 dispatcher: FALLBACK /location/{locationId}/openingHours: get: tags: - Opening Hours summary: Deliverect Get Store Opening Hours parameters: - name: locationId in: path schema: type: string required: true description: The locationId value. example: 5cecc6489f0001b8 responses: '200': description: Successful response content: application/json: examples: OK: summary: OK value: _id: 633d62de0f1565acdf**3bdf status: ACTIVE locationName: Location 1 tags: [] openingHours: - dayOfWeek: 1 startTime: 00:00 endTime: '23:59' - dayOfWeek: 2 startTime: 00:00 endTime: '23:59' - dayOfWeek: 3 startTime: 00:00 endTime: '23:59' channels: - _id: 633d6******565acdf893bf1 status: 2 channelName: Channel 1 channel: 1 tags: [] openingHours: [] - _id: 6476183fe******c858de0b0 status: 2 channelName: Channel 2 channel: 10057 tags: [] openingHours: [] - _id: 669519a1fe******040bdaf2 status: 2 channelName: Channel 3 channel: 10000 tags: [] openingHours: [] schema: type: object properties: _id: type: string example: 633d62de0f1565acdf**3bdf status: type: string example: ACTIVE locationName: type: string example: Location 1 tags: type: array items: type: object properties: {} openingHours: type: array items: type: object properties: dayOfWeek: type: integer example: 1 default: 0 startTime: type: string example: 00:00 endTime: type: string example: '23:59' channels: type: array items: type: object properties: _id: type: string example: 633d6******565acdf893bf1 status: type: integer example: 2 default: 0 channelName: type: string example: Channel 1 channel: type: integer example: 1 default: 0 tags: type: array items: type: object properties: {} openingHours: type: array items: type: object properties: {} '400': content: application/json: schema: type: object properties: {} examples: Bad Request: summary: Bad Request value: '{}' description: Bad Request operationId: get_get_location_locationid_openinghours description: Deliverect Get Store Opening Hours x-microcks-operation: delay: 0 dispatcher: FALLBACK /location/{locationId}/holidays: get: tags: - Opening Hours summary: Deliverect Holiday Hours for Locations parameters: - name: locationId in: path schema: type: string required: true description: The locationId value. example: 5cecc6489f0001b8 responses: '200': description: Successful response content: application/json: {} operationId: get_get_location_locationid_holidays description: Deliverect Holiday Hours for Locations x-microcks-operation: delay: 0 dispatcher: FALLBACK components: securitySchemes: oauth2: type: oauth2 description: OAuth 2.0 machine-to-machine client-credentials. Exchange client_id/client_secret at POST /oauth/token for a Bearer access_token. flows: clientCredentials: tokenUrl: https://api.deliverect.com/oauth/token scopes: {}