Divisions

Non-hierarchical taxonomy used to attribute content to a school or division.

Get a collection

Endpoint
GET /divisions HTTP/1.1

Query string parameters

All query string parameters are optional.

callback string

Wraps the response in a callback function of the given name. Use this parameter to facilitate JSONP requests.

excluded_ids comma-separated list of IDs

Returns divisions, except those with the given IDs.

ids comma-separated list of IDs

Return divisions with the given IDs.

order_by comma-separated list

Sort divisions by one or more ORDER_BY and ORDER parameter pairs. Options:

  • ORDER:
    • asc: order from lowest to highest values
    • desc: order from highest to lowest values
  • ORDER_BY:
    • id: order by division ID
    • list: order by the order of IDs given in the ids parameter
    • name: order by term name
    • weight: order by term weight

Format: ORDER_BY|ORDER[,ORDER_BY|ORDER,...]

Default value: name|asc

page integer

Return divisions from a specific page of a collection.

Default value: 1

per_page integer

Number of divisions to return per page of a collection. Maximum: 100

Default value: 5

slug comma-separated list

Return divisions matching the given slug(s).

Response

In the example response, embedded divisions are truncated for illustrative purposes. In the real-world version of the response, "...division object..." is an entire division resource.

The division collection
{
   "_embedded": {
      "divisions": [
         "...division object...",
         "...division object...",
         "...division object...",
         "...division object...",
         "...division object..."
      ]
   },
   "_links": {
      "find": {
         "href": "/divisions/{?id}",
         "templated": true
      },
      "next": {
         "href": "/divisions?page=3"
      },
      "prev": {
         "href": "/divisions?page=1"
      },
      "self": {
         "href": "/divisions?page=2"
      }
   },
   "page": 1,
   "per_page": 5,
   "return_count": 5,
   "total_available": 100
}

Attributes

_embedded hash

Embedded resources.

_embedded.divisions[] array

An array of division objects.

page integer

The page number of the returned collection.

per_page integer

The number of divisions requested per page.

return_count integer

Number of divisions returned.

total_available integer

Total number of divisions available in the collection.

Get one

Endpoint
GET /divisions/:id HTTP/1.1

Endpoint parameters

id integer required

The unique identifier of the division.

Response

GET /divisions/98
{
   "_embedded": {},
   "_links": {
      "self": {
         "href": "/divisions/98"
      }
   },
   "id": 98,
   "name": "Peabody Institute",
   "slug": "peabody-institute",
   "type": "division",
   "url": {
      "articles": "https://hub.jhu.edu/divisions/peabody-institute/articles/",
      "events": "https://hub.jhu.edu/divisions/peabody-institute/events/"
   }
}

Attributes

_embedded hash

Embedded resources.

id integer

Unique identifier of the division.

name string

The nice name of the division.

slug string

The name of the division used in URLs.

type string

Type of resource.

url hash

URLs that point to collections of content in this division on the Hub website.

url.articles string

Points to the collection of articles in this division on the Hub.

url.events string

Points to the collection of events in this division on the Hub.

Get a subcollection

A subcollection is a collection of objects contained within a division.

Endpoint
GET /divisions/:id/:subcollection HTTP/1.1

Endpoint parameters

id integer
The unique identifier of the division.
subcollection string

The name of the subcollection to retrieve. Options: announcements, articles, or events

Query string parameters

To filter the subcollection, see the list of available parameters associated with the chosen subcollection:

Response

See the response associated with the chosen subcollection: