Calendar & Scheduling

The Calendar API allows you to programmatically manage your organization's availability, including standard opening hours and exceptional closures.

Opening Hours vs Events

Oquira distinguishes between your regular schedule and specific calendar events.

• Regular Schedule: Defined per service (e.g., Mon-Fri 9:00-18:00).
• Calendar Events: Temporary overrides like holidays, lunch breaks, or meetings.

Managing Events

List Events

Retrieve all events for a given period.

curl -X GET "https://api.oquira.com/v1/business/calendar?from=2024-03-01&to=2024-03-31" \
  -H "X-API-Key: your_api_key_here"

Event Types

Integration Example

Use the calendar to notify your users in advance about upcoming closures:

{
  "success": true,
  "data": {
    "events": [
      {
        "id": "evt_123",
        "title": "Easter Holiday",
        "type": "closure",
        "date": "2024-03-31",
        "allDay": true
      }
    ]
  }
}

Updating Schedules

To update the default opening hours of a service, please refer to the Services documentation.