Duffel

What you can do

Available commands: 105 (57 read, 48 write). Enable only the commands your application needs.

Run Search flight offers with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "slices": [
    {
      "origin": "SFO",
      "destination": "JFK",
      "departureDate": "2027-02-10"
    }
  ],
  "adults": 1,
  "limit": 10
}

At most 2 provider requests per invocation; timeout: 30 seconds.

Run Stays: List loyalty programmes with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: Get accommodation reviews with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  },
  "query": {
    "limit": 10
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: Search for accommodation suggestions with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "data": {
    "query": "rits",
    "location": {
      "radius": 5,
      "geographic_coordinates": {
        "longitude": -0.1416,
        "latitude": 51.5071
      }
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: Get accommodation with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: List accommodation with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "limit": 10,
    "latitude": 51.5071,
    "longitude": -0.1416,
    "radius": 5
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Supporting Resources: List aircraft with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "limit": 10
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Supporting Resources: Get a single aircraft with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: List airline credits with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "limit": 10,
    "user_id": "icu_00009hj8USM7Ncg31cBCLL"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: Create an airline credit with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "data": {
    "user_id": "icu_00009hj8USM7Ncg31cBCLL",
    "type": "eticket",
    "issued_on": "2020-04-11",
    "given_name": "John",
    "family_name": "Smith",
    "expires_at": "2024-04-11T15:48:11.642Z",
    "code": "1234567890123",
    "amount_currency": "GBP",
    "amount": "90.80",
    "airline_iata_code": "AA"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: Get a single airline credit with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: Update an airline-initiated change with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  },
  "data": {
    "action_taken": "accepted"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: List airline-initiated changes with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "order_id": "ord_00009hthhsUZ8W4LxQgkjo"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: Accept the airline-initiated change with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Supporting Resources: Get a single airline with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Supporting Resources: List airlines with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "limit": 10
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Supporting Resources: List airports with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "limit": 10,
    "iata_country_code": "GB"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Supporting Resources: Get a single airport with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: Create a batch offer request with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "supplier_timeout": 10000
  },
  "data": {
    "slices": [
      {
        "origin": "LHR",
        "destination": "JFK",
        "departure_time": {
          "to": "17:00",
          "from": "09:45"
        },
        "departure_date": "2020-04-24",
        "arrival_time": {
          "to": "17:00",
          "from": "09:45"
        }
      }
    ],
    "private_fares": {
      "QF": [
        {
          "corporate_code": "FLX53",
          "tracking_reference": "ABN:2345678"
        }
      ],
      "UA": [
        {
          "corporate_code": "1234",
          "tour_code": "578DFL"
        }
      ]
    },
    "passengers": [
      {
        "family_name": "Earhart",
        "given_name": "Amelia",
        "loyalty_programme_accounts": [
          {
            "account_number": "12901014",
            "airline_iata_code": "BA"
          }
        ],
        "type": "adult"
      },
      {
        "age": 14
      },
      {
        "fare_type": "student"
      },
      {
        "age": 5,
        "fare_type": "contract_bulk_child"
      }
    ],
    "max_connections": 0,
    "include_split_ticket": true,
    "cabin_class": "economy",
    "airline_credit_ids": [
      "acd_00009hthhsUZ8W4LxQgkjo",
      "acd_0000thhsUZ8W4LxQgkjo00"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: Get a single batch offer request with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: Creating a booking payment instruction with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "booking_id": "resource_fixture"
  },
  "data": {
    "limit_currency": "USD",
    "limit_amount": "1437.55",
    "invoice": {
      "send_to": "[email protected]",
      "company_name": "Merchant",
      "address_region": "London",
      "address_postal_code": "SW1A 2AA",
      "address_line_2": "Westminster",
      "address_line_1": "10 Downing St",
      "address_country_code": "GB",
      "address_city": "London"
    },
    "card_id": "tcd_0000AS0NZdKjjnnHZmSUbI",
    "approved_charges": {
      "taxes": true,
      "other": "Parking up to $50. Food up to $20",
      "fees": true,
      "base": true
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: List bookings with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "limit": 10,
    "user_id": "icu_00009htyDGjIfajdNBZRlw"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: Creating a booking with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "data": {
    "users": [
      "icu_00009htyDGjIfajdNBZRlw"
    ],
    "quote_id": "quo_0000AS0NZdKjjnnHZmSUbI",
    "phone_number": "+442080160509",
    "payment": {
      "three_d_secure_session_id": "3ds_0000AWr2XsTRIF1Vp34gh5"
    },
    "metadata": {
      "customer_reference_number": "DLXYYZ5"
    },
    "loyalty_programme_account_number": "201154908",
    "guests": [
      {
        "user_id": "icu_00009htyDGjIfajdNBZRlw",
        "given_name": "Amelia",
        "family_name": "Earheart"
      }
    ],
    "email": "[email protected]",
    "accommodation_special_requests": "2:00 PM early check-in required"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: Cancel booking with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "booking_id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: Get booking with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: Update booking with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  },
  "data": {
    "users": [
      "icu_00009htyDGjIfajdNBZRlw"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: Get hotel brand with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: List hotel brands with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Payments: Create a Card with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "data": {
    "number": "4242424242424242",
    "name": "Neil Armstrong",
    "multi_use": false,
    "expiry_year": "23",
    "expiry_month": "02",
    "cvc": "123",
    "card_id": "tcd_00009hthhsUZ8W4LxQgkjb",
    "address_region": "London",
    "address_postal_code": "SW1A 2AA",
    "address_line_2": "Westminster",
    "address_line_1": "10 Downing St",
    "address_country_code": "GB",
    "address_city": "London"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Payments: Delete a Card with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Cars: Get a Booking with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Cars: Cancel a Booking with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Cars: Create a Booking with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "data": {
    "users": [
      "icu_0000B0nwceAOyWuOFJ23NJ"
    ],
    "quote_id": "qut_0000Bx4Af0b5l45AT50eqO",
    "payment": {
      "three_d_secure_session_id": "3ds_0000A3t2sL46m5eDF45kWW",
      "method": "card"
    },
    "metadata": {
      "custom_field": "custom_value_123"
    },
    "driver": {
      "user_id": "icu_0000B0nwceAOyWuOF3pz1M",
      "phone_number": "+442080160509",
      "given_name": "Amelia",
      "family_name": "Earheart",
      "email": "[email protected]",
      "date_of_birth": "1990-01-01"
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Cars: Create a Quote with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "data": {
    "rate_id": "rae_0000Bx4Af0b5l45AT50eqO"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Cars: Search for Cars with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "data": {
    "pickup_time": "10:30",
    "pickup_location": {
      "radius": 5,
      "geographic_coordinates": {
        "longitude": -0.1278,
        "latitude": 51.5074
      }
    },
    "pickup_date": "2024-01-15",
    "dropoff_time": "15:00",
    "dropoff_location": {
      "radius": 5,
      "geographic_coordinates": {
        "longitude": -0.1278,
        "latitude": 51.5074
      }
    },
    "dropoff_date": "2024-01-20",
    "driver": {
      "residence_country_code": "US",
      "age": 30
    }
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: Get hotel chain with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: List hotel chains with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Supporting Resources: List cities with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "limit": 10
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Supporting Resources: Get a single city with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Identity: Create a component client key with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "data": {
    "user_id": "icu_0000AgZitpOnQtd3NQxjwO"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Identity: List Customer User Groups with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

This tool has no input parameters.

Full JSON Schema

Full JSON Schema

Example input

{}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Identity: Create a Customer User Group with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "data": {
    "user_ids": [
      "icu_0000AgZitpOnQtd3NQxjwX"
    ],
    "name": "Northwind Solutions"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Identity: Delete a single customer user group with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Identity: Get a single customer user group with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Identity: Update a single customer user group with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  },
  "data": {
    "user_ids": [
      "icu_00009zg3q4J9z4z3"
    ],
    "name": "Northwind Solutions"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Identity: Get a single customer user with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Identity: Update a single customer user with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  },
  "data": {
    "preferred_language": "en",
    "phone_number": "+442080160509",
    "group_id": "usg_0000AgZitpOnQtd3NQxjwO",
    "given_name": "Amelia",
    "family_name": "Earhart",
    "email": "[email protected]"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Identity: List customer users with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "limit": 10,
    "email": "[email protected]"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Identity: Create a Customer User with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "data": {
    "preferred_language": "en",
    "phone_number": "+442080160509",
    "group_id": "usg_0000AgZitpOnQtd3NQxjwO",
    "given_name": "Amelia",
    "family_name": "Earhart",
    "email": "[email protected]"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Supporting Resources: Get a single loyalty programme with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Supporting Resources: List loyalty programmes with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "limit": 10
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: Delete a negotiated rate with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: Get a negotiated rate with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: Update a negotiated rate with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  },
  "data": {
    "display_name": "2025 Negotiated Rate",
    "chain_id": "chn_0000B6QFxO9EOY5cqw5kYK",
    "accommodation_ids": [
      "acc_0000AWr2VsUNIF1Vl91xg0"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: List negotiated rates with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "limit": 10
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Stays: Creating a negotiated rate with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "data": {
    "rate_access_code": "DUFFEL",
    "display_name": "2025 Negotiated Rate",
    "chain_id": "chn_0000B6QFxO9EOY5cqw5kYK",
    "accommodation_ids": [
      "acc_0000AWr2VsUNIF1Vl91xg0"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: Get a single offer request with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: List offer requests with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "limit": 10
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: Create an offer request with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "return_offers": false,
    "supplier_timeout": 10000
  },
  "data": {
    "slices": [
      {
        "origin": "LHR",
        "destination": "JFK",
        "departure_time": {
          "to": "17:00",
          "from": "09:45"
        },
        "departure_date": "2020-04-24",
        "arrival_time": {
          "to": "17:00",
          "from": "09:45"
        }
      }
    ],
    "private_fares": {
      "QF": [
        {
          "corporate_code": "FLX53",
          "tracking_reference": "ABN:2345678"
        }
      ],
      "UA": [
        {
          "corporate_code": "1234",
          "tour_code": "578DFL"
        }
      ]
    },
    "passengers": [
      {
        "family_name": "Earhart",
        "given_name": "Amelia",
        "loyalty_programme_accounts": [
          {
            "account_number": "12901014",
            "airline_iata_code": "BA"
          }
        ],
        "type": "adult"
      },
      {
        "age": 14
      },
      {
        "fare_type": "student"
      },
      {
        "age": 5,
        "fare_type": "contract_bulk_child"
      }
    ],
    "max_connections": 0,
    "include_split_ticket": true,
    "cabin_class": "economy",
    "airline_credit_ids": [
      "acd_00009hthhsUZ8W4LxQgkjo",
      "acd_0000thhsUZ8W4LxQgkjo00"
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: Get a single offer with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  },
  "query": {
    "return_available_services": true
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: Update a single offer passenger with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "offer_id": "resource_fixture",
    "offer_passenger_id": "resource_fixture"
  },
  "data": {
    "loyalty_programme_accounts": [
      {
        "airline_iata_code": "BA",
        "account_number": "12901014"
      }
    ],
    "given_name": "Amelia",
    "family_name": "Earhart"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: Price an offer with intended payment methods with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  },
  "data": {
    "intended_services": [
      {
        "quantity": 1,
        "id": "ase_00009UhD4ongolulWd9123"
      }
    ],
    "intended_payment_methods": [
      {
        "type": "card",
        "card_id": "tcd_0000A3t2sL46m5eDF45kWW"
      },
      {
        "type": "airline_credit",
        "airline_credit_id": "acd_0000A3t2sL46m5eDF45kWW"
      }
    ]
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: Get upsell offers for an offer with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: List offers with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "limit": 10,
    "offer_request_id": "orq_00009htyDGjIfajdNBZRlw",
    "sort": "total_amount",
    "max_connections": 0
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: List order cancellations with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "query": {
    "limit": 10,
    "order_id": "ord_00009hthhsUZ8W4LxQgkjo"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: Create a pending order cancellation with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "data": {
    "order_id": "ord_001"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: Get a single order cancellation with Duffel. This is a read command; it does not grant access beyond the connected account's permissions.

This is a read operation. Provider rate limits and data access rules still apply.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.

Full JSON Schema

Full JSON Schema

Example input

{
  "path": {
    "id": "resource_fixture"
  }
}

At most 1 provider requests per invocation; timeout: 30 seconds.

Run Flights: Confirm an order cancellation with Duffel. This command can change provider data. Review the target and input before invoking it.

This operation can change provider data. Review the input before allowing an agent to call it.

Connect and use

Parameters

Requiredness is local to the containing object. A required child is required only when its parent object or array item is provided. Alternative schemas are identified in the Constraints column; the linked full JSON Schema is authoritative.