Hotel chain
Marriott rates & Marriott Bonvoy points API
Every Marriott rate plan, the Bonvoy member rate, dynamic award nights in points and which 35k/40k/50k/85k free-night certificate covers them.
- Public rate
- ✓
- Member rate
- ✓
- Award points
- ✓
- Native calendar
- ✓
- Comp set batch
- ✓
- Credits per shop
- 1
- Comp set, per hotel
- 0.25
- Calendar, per night
- 0.1
- ·Award pricing is dynamic: the points cost of the same room moves by the night and by the day you ask.
- ·Comp sets ride a native area batch — up to 25 hotels in about one upstream call.
- ·Property codes are MARSHA codes (CHIRL); find them with GET /hotels.
curl -s https://api.directrate.dev/v1/shop \
-H "x-api-key: $DIRECTRATE_API_KEY" \
-H "content-type: application/json" \
-d '{"chain":"marriott","hotel_code":"CHIRL","checkin":"2026-11-10","los":1,"occupancy":{"adults":2}}'{
"chain": "marriott",
"hotel": {
"code": "CHIRL",
"currency": "USD",
"name": "Residence Inn by Marriott Chicago Downtown/Loop",
"brand": "Residence Inn"
},
"checkin": "2026-11-10",
"los": 1,
"status": "available",
"rates": [
{
"room_name": "Superior",
"rate_name": "Redemption with Points Upgrade",
"rate_type": "other",
"member_only": false,
"refundable": true,
"price_per_night": null,
"price_per_night_after_tax": 23.78,
"price_total": 23.78,
"tax_included": false,
"currency": "USD",
… 53 more lines
}shopped 2026-10-11 09:27Z, live
{
"chain": "marriott",
"hotel": {
"code": "CHIRL",
"currency": "USD",
"name": "Residence Inn by Marriott Chicago Downtown/Loop",
"brand": "Residence Inn"
},
"checkin": "2026-11-10",
"los": 1,
"status": "available",
"award_rates": [
{
"room_name": "Superior",
"rate_name": "Redemption with Points Upgrade",
"award_type": "standard",
"points_per_night": 60000,
"points_total": 60000,
"cash_copay": null,
… 51 more lines
}points, cpp and certificates for the same stay · 1 credit
FAQ
Marriott questions
Do I need a Marriott Bonvoy account?
No. The member rate is what Marriott quotes an anonymous visitor who is not logged in; it comes back as its own rows with member_only: true and under lowest.member. Points come back the same way, without any login.
What does a Marriott shop cost?
1 credit live, a quarter of that from cache; errors and unknown codes are free. On the Free plan's 250 credits that is 250 shops a month; on Growth (15,000) 15,000. A /calendar night is 0.1 credit through Marriott's native calendar.
Where do I find Marriott hotel codes?
GET /hotels?chain=marriott&q=<city or address> returns Marriott's own property codes around a place, nearest first — CHIRL is one. Codes are the chain's internal identifiers, not shared with any other chain.
All sources: coverage matrix · chains & coverage docs · weights.