Menu

Bedful Reviews

Reviews represent reviews of a site. Typically these are only relevant on sales channels which accept reviews via the Bedful system.

Get Review

Use GET /reviews/:id to fetch information on one review.

curl https://devapi.bedful.com/reviews/1 \
-u BEDFUL_KEY: 

Parameters available

  • id : specified in the url

This will return JSON like this for the matched record, or a 404 error if no record is found for the given id.

{
  "id": 123,
  "site_id": 123,
  "channel_id": 1,
  "booking_id": 123,
  "user_id": 123,
  "status": 100,
  "rating": 100,
  "created_at": "2020-09-20T12:36:37Z",
  "updated_at": "2020-09-21T17:02:41Z",
  "summary": "This is how camping should be!",
  "text": "The situation is stunning, with beautiful views whichever direction you look.",
  "owner_text": ""
}

Review Fields

  • ID: The unique id of the review
  • Status: The status of the review (0 is draft, 11 Suspended, 100 Live)
  • Rating: A rating from 0 to 100 in tranches of 20
  • SiteID: The site for this review
  • ChannelID: The channel for this review
  • UserID: The user who wrote the review
  • BookingID: The booking (if any) associated with this review (leads to verified review status if set)
  • Summary: The title of the review
  • Text: The text of the review
  • Owner Text: The partner response to the review

Get Reviews

Use GET /reviews to fetch information on more than one review.

curl https://devapi.bedful.com/reviews \
-u BEDFUL_KEY: 
Parameters available
  • site_id: reviews for a given site

This will return JSON like this for the matched records, or an empty list if no records are found.

{
  "reviews": [{
  "id": 123,
  "site_id": 123,
  "channel_id": 1,
  "booking_id": 123,
  "user_id": 123,
  "status": 100,
  "rating": 100,
  "created_at": "2020-09-20T12:36:37Z",
  "updated_at": "2020-09-21T17:02:41Z",
  "summary": "This is how camping should be!",
  "text": "The situation is stunning, with beautiful views whichever direction you look.",
  "owner_text": ""
}]
}