Negotiated Rates

• Discounted pricing: Money off the best available public rate

• Additional benefits: Free breakfast, Wi-Fi, parking, or room upgrades

• Guaranteed availability: Rooms reserved for the company even during busy periods

• Consistent terms: Same cancellation policies and benefits across properties

Phase 1: Negotiate

Phase 2: Load Rates

• The RAC matches what was agreed with the hotel

• The signed contract terms are accurately reflected on your negotiated rate - including any discounts is reflected in the price, and contracted benefits such as included breakfast, Wi-Fi, or parking appear in either the included amenities or conditions

• The negotiated rate is bookable

• It's important to check that the rate displays consistently across all contracted properties, as loading errors sometimes affect only certain locations

Phase 3: Search and Book

Step 1: Create a Negotiated Rate

JSON
curl -X POST --compressed "https://api.duffel.com/stays/negotiated_rates" \
-H "Accept-Encoding: gzip" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Duffel-Version: v2" \
-H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \
-d '{
  "data": {
    "display_name": "Stark Enterprises Corporate Rate 2025",
    "rate_access_code": "DUFF",
    "accommodation_ids": [
      "acc_0000AWr2VsUNIF1Vl91xg0"
    ]
  }
}'

JSON
{
  "data": {
    "id": "nre_00009htyDGjIfajdNBZRlw",
    "live_mode": false,
    "display_name": "Stark Enterprises Corporate Rate 2025",
    "rate_access_code": "DUFF",
    "accommodation_ids": ["acc_0000AWr2VsUNIF1Vl91xg0"]
  }
}

Step 2: Search with Negotiated Rates

• Rate appears in search results for all contracted accommodation

• Discount percentage matches the contract

• All promised amenities appear in rate conditions

• Cancellation policies are correct

• Rate is only accessible to authorised user groups

Shell
curl -X POST --compressed "https://api.duffel.com/stays/search" \
-H "Accept-Encoding: gzip" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Duffel-Version: v2" \
-H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \
-d '{
  "data": {
    "rooms": 1,
    "negotiated_rate_ids": ["nre_00009htyDGjIfajdNBZRlw"]
    "location": {
      "radius": 2,
	    "geographic_coordinates": {
	      "latitude": -24.38,
	      "longitude": -128.32
      }
    },
    "check_in_date": "2025-10-04",
    "check_out_date": "2025-10-07",
    "guests": [
      {
        "type": "adult"
      }
    ]
  }
}'


...
View full sample

JSON
{
  "data": {
    "results": [
      {
        "accommodation": {
          "id": "acc_0000AWr2VsUNIF1Vl91xg0",
          "name": "Duffel Test Hotel",
          "supported_negotiated_rates": [
            {
              "id": "nre_00009htyDGjIfajdNBZRlw",
              "display_name": "Stark Enterprises Corporate Rate 2025"
            }
          ]
          // ... other fields
        }
      }
    ]
  }
}

Step 3: Fetch Rates and Identify Negotiated Rates

Shell
curl -X POST --compressed "https://api.duffel.com/stays/search_results/{id}/fetch_rates" \
-H "Accept-Encoding: gzip" \
-H "Accept: application/json" \
-H "Duffel-Version: v2" \
-H "Authorization: Bearer <YOUR_ACCESS_TOKEN>"

• rate_code showing the Rate Code (e.g. "TEST")

• negotiated_rate_id which corresponds to a Negotiated Rate created in step 1

• The corresponding negotiated_rate_id will also be returned on the rate object when possible, at fetch rates, quote and booking

JSON
{
  "rates": [
    {
      "total_amount": "180.00",
      "total_currency": "USD",
      "rate_code": "TEST",
      "negotiated_rate_id": "nre_00009htyDGjIfajdNBZRlw",
      "conditions": [
		      {
			      "title": "Duffel Test Hotel Negotiated Rate Condition"
			      "description": "10%BAR, 12%COMM, Stark Enterprises employees enjoy an exclusive rate, including complimentary breakfast, Wi-Fi, and access to executive lounge."
		      },
          {
            "title": "Parking",
            "description": "Public parking is available nearby for £15 per day"
          }
        ],
      // ... other rate details
    }
  ]
}

Step 4: Update or Delete a Negotiated Rate

• the set of accommodation which your Negotiated Rate is loaded against changes, for example if another hotel is added to the contract

• the negotiated rate display name needs to be updated

Shell
curl -X PATCH --compressed "https://api.duffel.com/stays/negotiated_rates/nre_00009htyDGjIfajdNBZRlw" \
-H "Accept-Encoding: gzip" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Duffel-Version: v2" \
-H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \
-d '{
  "data": {
    "accommodation_ids": ["acc_0000AWr2VsUNIF1Vl91xg0", "acc_0000AWr2VsUNIF1Vl91xg1"],
    "display_name": "Stark Enterprises Corporate Rate 2026"
  }
}'

Shell
curl -X DELETE --compressed "https://api.duffel.com/stays/negotiated_rates/nre_00009htyDGjIfajdNBZRlw" \
-H "Accept-Encoding: gzip" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Duffel-Version: v2" \
-H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \

Rate not appearing in searches

• Confirm the accommodation IDs are correct

• Ensure the user has appropriate access permissions

• Check that the hotel has completed loading the rate in their systems

• Allow up to 72 hours for rate propagation - after the hotel confirms loading, there can be a delay before the rate becomes visible

Incorrect pricing or benefits

• Compare the rate details with the contract

• Contact the hotel to verify their rate configuration

• Check if there are date-specific restrictions you haven't configured.

• Check for blackout periods or special conditions. For example, some negotiated rates exclude peak periods or require advance booking

Access control issues

• Verify the customer user is associated with the correct group

• Check that the negotiated rate is configured for the right distribution type

• Ensure the rate hasn't expired