GET drillable/…/reviews

Retrieves the reviews of a given public drillable.

Resource URL

https://www.drillster.com/api/2.1.1/drillable/{drillable_id}/reviews

Parameters

Field Type Description
drillable_id
required
String The ID of the drill or course to retrieve the reviews for.

Example value: eSxMA4MISaCjJA43PgMEnQ

Response

A 2.1.1 Reviews object containing the reviews of the drillable.

Example request

GET https://www.drillster.com/api/2.1.1/drillable/eSxMA4MISaCjJA43PgMEnQ/reviews

Response

{
  "total": 1,
  "reviews": [{
    "timestamp": "2015-06-12T07:16:23Z",
    "reviewer": {
      "type": "USER",
      "id": "m3XfGV1LQhu729lfVYa_sQ",
      "name": "Jane Doe",
    },
    "content": "I found this drill to be very useful!"
  }]
}

Error responses

The following error situations are possible:

ID Response code Description
missing_drillable_id 400 (Bad request) Missing or invalid drillable ID
no_access 403 (Forbidden) No access to requested drillable
drillable_not_found 404 (Not found) Requested drillable not found