Skip to main content
The /institutions endpoints expose Hexagraph’s registry of research-performing organizations — universities, national laboratories, government agencies, hospitals, and private research centers. Institution records can be linked to affiliated Authors and, transitively, to their scholarly Outputs. Institutions are identified by the OA:I prefix system.

​
List institutions

​
search
string
Search for institutions by name. Partial matches are supported (e.g. MIT matches “Massachusetts Institute of Technology”).
​
filter
string
Narrow results with key-value filters. Multiple filters may be combined with a comma.
​
page
integer
default:"1"
Page number for paginated results. Starts at 1.
​
per_page
integer
default:"25"
Number of results returned per page. Maximum value is 200.
curl "https://hexagraph-core.onrender.com/institutions?search=MIT"

[
  {
    "id": "OA:I1290206310",
    "name": "Massachusetts Institute of Technology",
    "country": "US",
    "type": "education"
  },
  {
    "id": "OA:I2800528987",
    "name": "MIT Lincoln Laboratory",
    "country": "US",
    "type": "government"
  }
]

​
Get a single institution

Fetch a specific institution’s full record by its OA:I identifier. 
curl "https://hexagraph-core.onrender.com/institutions/OA:I1290206310"

{
  "id": "OA:I1290206310",
  "name": "Massachusetts Institute of Technology",
  "country": "US",
  "type": "education"
}

​
Response fields

​
id
string
required
Unique identifier for the institution. Always prefixed with OA:I (e.g. OA:I1290206310).
​
name
string
required
Full display name of the institution (e.g. "Massachusetts Institute of Technology").
​
country
string
Two-letter ISO 3166-1 alpha-2 country code representing the institution’s primary location (e.g. "US", "GB", "DE").
​
type
string
Classification of the institution. One of:
  • education — universities, colleges, and academic institutions
  • government — government agencies and national laboratories
  • healthcare — hospitals, medical centers, and health systems
  • nonprofit — non-governmental research organizations and foundations
  • company — private sector and corporate research entities
  • other — institutions that do not fit the above categories
Related endpoints: Authors include an affiliations array referencing institution IDs.