GET group/…/drills

GET Retrieves all drills of a specific group. These can be regular drills, and courses. A course is a collection of (regular) drills.

Resource URL

https://www.drillster.com/api/2/group/{group_id}/drills

The group ID is the unique identifier of the group.

Parameters

None, other than the group ID in the URL.

Response

A group object, populated with its drill contents. The drill contents elements can be drills or courses, which is indicated by the type property. Per drill contents element, the drill ID and name is listed. Courses also contain a list of drills.

Example request

GET https://www.drillster.com/api/2/group/nYrK9udUc-UGvRS2kxaPtaB-0wzeHAJzM6vlL1te6wI/drills

Response

{
  "id" : "nYrK9udUc-UGvRS2kxaPtaB-0wzeHAJzM6vlL1te6wI",
  "name" : "European geography",
  "description" : "Learn the countries and capitals of Europe",
  "drills" : [ {
    "type" : "drill",
    "id" : "86KQcmCWSzCsgjRr2lkO9Q",
    "name" : "East European countries"
  }, {
    "type" : "course",
    "id" : "aisay8ZAS-22lDlB3k-64w",
    "name" : "North European countries",
    "drills" : [ {
    "type" : "drill",
      "id" : "QnOsNpGQTQSUVyXWdUjgqA",
      "name" : "Scandinavian countries"
    }, {
      "type" : "drill",
      "id" : "wL5Sj3hfQhmb3G1nzo0wYw",
      "name" : "Baltic countries"
    } ]
  }, {
    "type" : "drill",
    "id" : "bcW3mGSRSECKtdBQsiieeg",
    "name" : "South European countries"
  } ]
}

Error responses

The following error situations are possible:

ID Description
group_not_found Could not retrieve group details.
drill_code_missing No drill specified.
no_group_access You are not allowed to access this group.