# FareHarbor Bookings Endpoints API

**Canonical:** https://apis.io/apis/fareharbor/fareharbor-bookings-endpoints-api/  
**Provider:** FareHarbor — https://apis.io/providers/fareharbor/  
**Base URL:** https://fareharbor.com/api/external/v1  
**Documentation:** https://developer.fareharbor.com/api/external/v1/

FareHarbor Bookings Endpoints API is one of 11 APIs that [FareHarbor](https://apis.io/providers/fareharbor/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Bookings Endpoints. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The bookings endpoints in the FareHarbor API provide comprehensive functionalities for managing reservations efficiently. These endpoints enable developers and business owners to integrate and automate booking-related operations seamlessly into their services. Through these endpoints, users can create, retrieve, update, and cancel bookings directly through the API. Key functionalities offered by the bookings endpoints include: * **Creating Bookings:** Enables the creation of new bookings, allowing customers to reserve spots for tours and activities directly through third-party applications. * **Retrieving Bookings:** Offers the ability to query and retrieve details of existing bookings, providing essential information like booking status, customer details, and payment information. * **Updating Bookings:** Supports modifications to existing bookings, which is crucial for managing changes in customer plans. * **Cancelling Bookings:** Allows for the cancellation of bookings, helping to manage availability and customer expectations effectively. These endpoints are designed to foster a more connected experience between tour and activity operators and their customers by simplifying the booking process through automation and integration. This ensures that businesses can focus more on providing an exceptional service experience, while the logistical aspects of bookings are handled efficiently through the API. **Things to Note:** * Orders: * Orders are a way of grouping collections of bookings so that they can be created or cancelled as a block. * A booking can belong to an order, but it doesn't have to. An order can include any number of bookings. * When `order` is not `null`, `order` is an object that provides the following property: * `display_id`: `string` - A unique identifier for the order. * See [Orders](#tag/Orders) to learn more about creating and retrieving orders.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| GET | `/companies/<affiliate-shortname>/agents/` | Agents |
| GET | `/companies/<affiliate-shortname>/desks/` | Desks |
| GET | `/companies/<shortname>/availabilities/<availability.pk>/bookings/` | Bookings |
| POST | `/companies/<shortname>/availabilities/<availability.pk>/bookings/` | Bookings |
| POST | `/companies/<shortname>/availabilities/<availability.pk>/bookings/validate/` | Validate |
| GET | `/companies/<shortname>/bookings/<Booking.uuid>/` | Booking |
| DELETE | `/companies/<shortname>/bookings/<Booking.uuid>/` | Booking |
| PUT | `/companies/<shortname>/bookings/<Booking.uuid>/note/` | Update Booking Note |
| PUT | `/companies/<shortname>/bookings/<Booking.uuid>/customer-custom-field-values/<custom_field_value.pk>/` | Update Customer Custom Field Value |
| PATCH | `/companies/<shortname>/bookings/<Booking.uuid>/resource-uses/<resource_use.pk>/` | Update Resource Use |
| GET | `/companies/<shortname>/minimal/bookings-by-create-date/<date>/` | Bookings By Create Date |
| POST | `/bookings/resend-confirmation-email/` | Resend Confirmation Email |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/fareharbor/openapi/fareharbor-bookings-endpoints-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/fareharbor/json-schema/fareharbor-booking-with-resource-uses-response-json-schema-schema.json
- **JSONSchema** — https://artifacts.apis.io/fareharbor/json-schema/fareharbor-booking-with-payments-response-json-schema-schema.json
- **JSONSchema** — https://artifacts.apis.io/fareharbor/json-schema/fareharbor-booking-response-json-schema-schema.json
- **JSONSchema** — https://artifacts.apis.io/fareharbor/json-schema/fareharbor-items-response-json-schema-schema.json
- **JSONSchema** — https://artifacts.apis.io/fareharbor/json-schema/fareharbor-item-response-json-schema-schema.json
- **JSONSchema** — https://artifacts.apis.io/fareharbor/json-schema/fareharbor-availability-response-json-schema-schema.json

## Other FareHarbor APIs (10)

- [FareHarbor Integration Center](https://apis.io/apis/fareharbor/fareharbor-integration-center/)
- [FareHarbor Availabilities Endpoints API](https://apis.io/apis/fareharbor/fareharbor-availabilities-endpoints-api/)
- [FareHarbor Checkin Endpoints API](https://apis.io/apis/fareharbor/fareharbor-checkin-endpoints-api/)
- [FareHarbor Company Endpoints API](https://apis.io/apis/fareharbor/fareharbor-company-endpoints-api/)
- [FareHarbor Crew Members Endpoints API](https://apis.io/apis/fareharbor/fareharbor-crew-members-endpoints-api/)
- [FareHarbor Items Endpoints API](https://apis.io/apis/fareharbor/fareharbor-items-endpoints-api/)
- [FareHarbor Lodging Endpoints API](https://apis.io/apis/fareharbor/fareharbor-lodging-endpoints-api/)
- [FareHarbor Ping API](https://apis.io/apis/fareharbor/fareharbor-ping-api/)
- [FareHarbor Roles Endpoints API](https://apis.io/apis/fareharbor/fareharbor-roles-endpoints-api/)
- [FareHarbor Users Endpoints API](https://apis.io/apis/fareharbor/fareharbor-users-endpoints-api/)

## Tags

Bookings Endpoints

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/fareharbor/fareharbor-bookings-endpoints-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/fareharbor/.