---
title: How booking rules apply to API bookings
description: Bookings made through the Calira API go through the same rules, approvals and notifications as the app. Here is what is checked and why a booking can be refused.
---

[Skip to content](https://help.calira.co/how-booking-rules-apply-to-api-bookings#main-content)

[![Calira Logo](https://help.calira.co/hs-fs/hubfs/Calira%20Logo.png?width=274&height=63&name=Calira%20Logo.png)](https://calira.co/)

Open main navigation

Close main navigation

- [Contact us](https://calira.co/contact)

[Contact us](https://calira.co/contact)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Calira help centre | Guides and support](https://help.calira.co/?hsLang=en)
2. [Integrations](https://help.calira.co/integrations?hsLang=en)
3. [Calira API](https://help.calira.co/integrations?hsLang=en#calira-api)

# How booking rules apply to API bookings

When another system can create bookings in Calira, the obvious worry is that it will ignore the rules you've set up. It can't. Every booking made through the API goes through the same checks as one made in Calira. This article covers those checks, what happens when a booking is refused, and the settings some booking types need.

### The same checks as the app

Every API booking is checked against the instrument's settings:

- Overlap protection
- Usage limits
- Minimum and maximum booking durations
- Advance notice
- Business hours

Booking start and end times must fall on 15-minute boundaries.

### Approvals

If an instrument needs approval, API bookings join the same approval queue as bookings made in Calira, and admins are notified in the usual way. The API response says whether the booking is confirmed or pending approval.

### Notifications

The usual notifications are sent when a booking is created or updated through the API. If participants are removed from a booking, they are notified and the booking is removed from their Outlook calendar. Notes added through the API sync to the booking's Outlook event and send the usual note notifications.

### When a booking is refused

If a booking breaks a rule, it is refused and the API explains which rule it hit, so whoever built the integration knows what to change.

The most common reasons are:

- The user doesn't have access to the instrument through an access group
- The booking falls outside the instrument's booking window, business hours or advance notice
- The booking is shorter or longer than the instrument allows
- The booking overlaps an existing booking
- It's a maintenance booking set up as a group booking, which isn't supported

A request can also fail before any booking rules are checked, if the access token has expired or the application doesn't have the permission it needs. See [API permissions explained](https://help.calira.co/api-permissions-explained?hsLang=en).

### Free slots are a guide

The free slots check shows time on an instrument, within a defined period (up to two weeks long), that has no existing bookings (including bookings waiting for approval) and no periods marked as unavailable. It doesn't apply the booking rules for the person booking, such as business hours or maximum duration. A slot shown as free can still be refused when you try to book it.

### Recurring bookings

Each booking in a recurring series is checked. By default, any that clash with existing bookings are skipped. Admins and instructors can choose to overlap the existing bookings instead.

### Group bookings and booking on behalf of someone

- **Group bookings:** the lab's "Multiple users per booking" setting must be on, and your plan must support it. Lab members other than admins and instructors also need their access group to allow group bookings. Everyone invited must be a lab member with access to the instrument. Guests can't invite others, participants can't be added after a booking has ended, and maintenance bookings can't be group bookings.
- **Booking on behalf of someone:** only admins and instructors of the instrument can do this, and the person must be an active user with access to it.
- **Projects:** bookings can be assigned to lab projects when the lab has projects turned on.

For what each permission allows, see [API permissions explained](https://help.calira.co/api-permissions-explained?hsLang=en).

- [About Calira](https://help.calira.co/about-calira?hsLang=en)
- [Account](https://help.calira.co/account?hsLang=en)
- [Announcements](https://help.calira.co/announcements?hsLang=en)
- [Bookings](https://help.calira.co/bookings?hsLang=en)
- [Custom Forms](https://help.calira.co/custom-forms?hsLang=en)
- [Data and Safety](https://help.calira.co/data-and-safety?hsLang=en)
- [Equipment](https://help.calira.co/equipment?hsLang=en#main-content)

    - [Creating Equipment](https://help.calira.co/equipment?hsLang=en#creating-equipment)
    - [Charging For Equipment](https://help.calira.co/equipment?hsLang=en#charging-for-equipment)
    - [Equipment Booking Rules](https://help.calira.co/equipment?hsLang=en#equipment-booking-rules)
- [Integrations](https://help.calira.co/integrations?hsLang=en#main-content)

    - [Calira API](https://help.calira.co/integrations?hsLang=en#calira-api)
    - [Benchling Integration](https://help.calira.co/integrations?hsLang=en#benchling-integration)
    - [External Calendars](https://help.calira.co/integrations?hsLang=en#external-calendars)
    - [LabTrack Integration](https://help.calira.co/integrations?hsLang=en#labtrack-integration)
    - [Single Sign-On (SSO)](https://help.calira.co/integrations?hsLang=en#single-sign-on-sso)
    - [Asset Monitoring Integrations](https://help.calira.co/integrations?hsLang=en#asset-monitoring-integrations)
    - [Electronic Lab Notebooks (ELN's)](https://help.calira.co/integrations?hsLang=en#electronic-lab-notebooks-elns)
- [Maintenance](https://help.calira.co/maintenance?hsLang=en)
- [Projects](https://help.calira.co/projects?hsLang=en)
- [Reports](https://help.calira.co/reports?hsLang=en)
- [Subscriptions & Billing](https://help.calira.co/subscriptions-billing?hsLang=en)
- [System Information](https://help.calira.co/system-information?hsLang=en)
- [Troubleshooting](https://help.calira.co/troubleshooting?hsLang=en)
- [Users](https://help.calira.co/users?hsLang=en#main-content)

    - [Inviting New Users](https://help.calira.co/users?hsLang=en#inviting-new-users)
    - [User Training](https://help.calira.co/users?hsLang=en#user-training)
    - [Assigning Equipment to a User](https://help.calira.co/users?hsLang=en#assigning-equipment-to-a-user)
- [Workflows](https://help.calira.co/workflows?hsLang=en)

[![Chill listening crop-3](https://help.calira.co/hubfs/Icon%20black%20(1).svg "Chill listening crop-3")](https://calira.co/)

Clustermarket Ltd (trading as Calira) is a company registered in England and Wales (No.09485659). Registered office: 34 Lime Street, London, EC3M 7AT, United Kingdom.

<https://www.linkedin.com/company/calira/> <https://www.instagram.com/calirasoftware/> <https://www.facebook.com/calirasoftware/> <https://twitter.com/calirasoftware> <https://open.spotify.com/show/5KwOlyFLach2TMm6KslzeI?si=3264764283014524> <https://www.youtube.com/@calirasoftware> [mailto:support@calira.co](mailto:support@calira.co)

Copyright © 2026, Calira

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://calira.co/#organization",
  "@type" : "Organization",
  "logo" : "https://cdn.prod.website-files.com/68824ff75537b66dd8766992/69f9f2bbb669ebffba10349e_calira-logo.png",
  "name" : "Calira",
  "sameAs" : [ "https://www.linkedin.com/company/calira/", "https://www.crunchbase.com/organization/calira" ],
  "url" : "https://calira.co"
}
```

```json
{
  "@context" : "https://schema.org",
  "@id" : "https://help.calira.co/#website",
  "@type" : "WebSite",
  "inLanguage" : "en-GB",
  "name" : "Calira help centre",
  "publisher" : {
    "@id" : "https://calira.co/#organization"
  },
  "url" : "https://help.calira.co"
}
```

```json
{
  "@context" : "https://schema.org",
  "@type" : "TechArticle",
  "about" : {
    "@id" : "https://calira.co/#software"
  },
  "author" : {
    "@id" : "https://calira.co/#organization"
  },
  "dateModified" : "2026-11-17T11:27:37+00:00",
  "datePublished" : "",
  "description" : "Bookings made through the Calira API go through the same rules, approvals and notifications as the app. Here is what is checked and why a booking can be refused.",
  "headline" : "How booking rules apply to API bookings",
  "inLanguage" : "en-GB",
  "isPartOf" : {
    "@id" : "https://help.calira.co/#website"
  },
  "mainEntityOfPage" : "https://help.calira.co/how-booking-rules-apply-to-api-bookings",
  "publisher" : {
    "@id" : "https://calira.co/#organization"
  },
  "url" : "https://help.calira.co/how-booking-rules-apply-to-api-bookings"
}
```