Skip to main content

Find Bookings Action

The Find Bookings action searches for bookings matching specified criteria and returns a collection of bookings.

Jerome Bajou avatar
Written by Jerome Bajou
Updated this week

Overview

The Find Bookings action searches for bookings matching specified criteria and returns a collection of bookings.


Configuration

Filters (Optional)

Filter conditions to find specific bookings. Supports multiple filters with AND logic.

Filter Structure:

  • Field - Booking field to filter on

  • Operator - Comparison operator (equals, greater than, contains, etc.)

  • Value - Value to compare (supports variables)

Filterable Fields:

  • id, quantity, gross_price, net_price

  • created_at, confirmed_at, cancelled_at

  • customer.id, provider.id, reseller.id

  • checked_in, is_refundable

  • And more...

Limit (Optional)

Maximum number of bookings to return. Default: 100

Examples:

100
50
{limit_variable}

Output

Returns a bookings array containing matching bookings.

Accessing Results

Use in a Loop action:

Loop over: {bookings}
Current item: {current_item}

Examples

1. Find Recent Bookings

Filters:
- Field: created_at
Operator: greater than
Value: {subtractDays(now(), 7)}
Limit: 50

2. Find High-Value Bookings

Filters:
- Field: gross_price
Operator: greater than
Value: 1000
Limit: 100

3. Find Customer Bookings

Filters:
- Field: customer.id
Operator: equals
Value: {customer.id}
Limit: 50

Best Practices

  1. Use appropriate limits - Don't fetch too many bookings

  2. Combine filters - Use multiple filters for precise searches

  3. Use loops - Process each booking in a loop

  4. Test filters - Verify filters work as expected


Related Documentation

Did this answer your question?