This is an old revision of the document!



List institutions using the filters set as parameters. The number of institutions is represented in the X-Count header - use the HEAD request to simply count the number of institutions matching the filters. Use the GET request to actually fetch them.

Note that in most use cases there will only be one institution in the system. However, in exchange management setups as well as collaborative systems there may be a larger number of institutions.


GET /api/institutions
Authorization: DREAM apikey="..."


?byStatuses Optional Comma or space-separated list of statuses, currently limited to: Online, Draft
?byStatuses Optional Comma or space-separated list of ISO 3166-1 alpha-2 country codes

Response headers

Content-Type: application/json
Content-Length: 1456
X-Count: 15