Sign in
Institution

Get a page of the specific domain entity. Sorting and filtering is applied before paging

Changed on

Sorting: the sort parameter to sort the list of entities before paging the sort parameter is the name of the entity-model attribute to sort with a leading '-' sign for descending sort order. Note that not all entity-model attribute are suited for sorting while the most are.

</p> Filter: The filter attributes accepted by this API depend on the actual entity model (domain object) and are of the form [domain-attribute-name]=[filter-value]. E.g.: name=abc or type=EXAM. Usually filter attributes of text type are treated as SQL wildcard with %[text]% to filter all text containing a given text-snippet.
get/admin-api/v1/institution

Request

  • Base URL: http://localhost:8080
  • URL: http://localhost:8080/admin-api/v1/institution
  • Auth: oauth (defined in the document in a form this page cannot read)

Query parameters

page_numberinteger

The number of the page to get from the whole list. If the page does not exists, the API retruns with the first page.

page_sizeinteger

The size of the page to get.

sortstring

the sort parameter to sort the list of entities before paging

institutionIdinteger

The institution identifier of the request. Default is the institution identifier of the institution of the current user

namestring

Filters institutions by name.

activeboolean

Filters institutions by active state.

Response

OK

number_of_pagesinteger

The number of available pages for the specified page size.

page_numberinteger

The actual page number. Starting with 1.

page_sizeinteger

The the actual size of a page

sortstring

The page sort column name

completeboolean

Example response

{
  "content": [
    {
      "name": "ETH Zurich",
      "active": true
    }
  ]
}

Changes

  • 52e8143ac492Revision changes
    • warning

      removed the optional property // from the response with the status

  • 7b575f7932c2Revision changes
    • info

      api tag Institution added

    • info

      api tag institution-controller removed

    • info

      added the new optional query request parameter active

    • info

      added the new optional query request parameter name