> ## Documentation Index
> Fetch the complete documentation index at: https://hexagraph-docs.voyla.in/llms.txt
> Use this file to discover all available pages before exploring further.
# List institutions
> Query and list academic institutions with filtering, sorting, and pagination.
Retrieves a paginated list of academic institutions with filtering and sorting capabilities.
### Query Parameters
Page number for pagination. Default is `1`.
Results per page. Allowed values: `10`, `25`, `50`, `100`.
Filter expression (e.g. `type:education`, `country_code:US`).
Sorting parameter (e.g. `outputs_count:desc`, `cited_by_count:desc`).
### Response Fields
Pagination metadata.
Total matching records count.
Current page number.
Items per page.
Array of institution records.
Institution ID (`HX_I...`).
Research Organization Registry (ROR) URL.
Institution display name.
Country metadata object.
ISO country code (e.g. `"JP"`).
Country display name.
Institution classification (`facility`, `education`, etc.).
Homepage URL.
Image logo URL.
Thumbnail image URL.
List of acronyms.
List of alternative names.
Associated repositories list.
Repository source ID (`HX_S...`).
Repository display name.
Total outputs count.
Total citations count.
Summary statistics object.
Two-year mean citation rate.
Calculated h-index score.
Calculated i10-index score.
Associated parent/child institutions.
Institution ID (`HX_I...`).
Institution display name.
Relationship type (`parent`, `child`, `related`).
Yearly breakdown of outputs and citations.
Year number.
Outputs count in year.
Open Access outputs count in year.
Citations count in year.
Roles array.
Role type (`funder`, `institution`, `publisher`).
Entity ID.
Outputs count in role.
Geographic location object.
City name.
GeoNames city identifier.
Region / state name.
ISO country code.
Country display name.
Geographic latitude coordinate.
Geographic longitude coordinate.
International metadata object.
ISO update date string.
ISO creation date string.
Topics list array.
Topic ID (`HX_T...`).
Topic name.
```bash cURL theme={null}
curl -X GET "https://api.hexagraph.in/institutions?filter=type:facility&sort=outputs_count:desc&per_page=25"
```
```javascript JavaScript theme={null}
fetch("https://api.hexagraph.in/institutions?filter=type:facility&sort=outputs_count:desc&per_page=25")
.then(response => response.json())
.then(data => console.log(data));
```
```python Python theme={null}
import requests
response = requests.get("https://api.hexagraph.in/institutions", params={"filter": "type:facility", "sort": "outputs_count:desc", "per_page": 25})
print(response.json())
```
```json 200 OK theme={null}
{
"meta": {
"count": 134448,
"page": 1,
"per_page": 25
},
"results": [
{
"id": "HX_I4210108322",
"ror": "https://ror.org/01t3wyv61",
"name": "National Institute for Fusion Science",
"country": {
"code": "JP",
"name": "Japan"
},
"type": "facility",
"homepage_url": "https://www.nifs.ac.jp",
"image_url": null,
"image_thumbnail_url": null,
"display_name_acronyms": [
"NIFS"
],
"display_name_alternatives": [
"Kakuyugo Kagaku Kenkyujo",
"Kakuyugou Kagaku Kenkyuujo",
"Kakuyūgō Kagaku Kenkyūjo",
"NINS National Institute for Fusion Science",
"National Institute for Fusion Science",
"National Institutes of Natural Sciences National Institute for Fusion Science",
"かくゆうごうかがくけんきゅうじょ",
"カクユウゴウカガクケンキュウジョ",
"核融合科学研究所"
],
"repositories": [
{
"id": "HX_S4306401138",
"name": "National Institute for Fusion Science Repository (National Institute for Fusion Science)"
}
],
"outputs_count": 40567916,
"cited_by_count": 2350640,
"summary_stats": {
"2yr_mean_citedness": 0.000029117814157264747,
"h_index": 194,
"i10_index": 18840
},
"associated_institutions": [
{
"id": "HX_I199525922",
"name": "National Institutes of Natural Sciences",
"relationship": "parent"
}
],
"counts_by_year": [
{
"year": 2026,
"outputs_count": 11617444,
"oa_outputs_count": 11617410,
"cited_by_count": 49
},
{
"year": 2025,
"outputs_count": 18940305,
"oa_outputs_count": 18940235,
"cited_by_count": 442
},
{
"year": 2024,
"outputs_count": 10000445,
"oa_outputs_count": 10000376,
"cited_by_count": 1130
}
],
"roles": [
{
"role": "funder",
"id": "HX_F4320338091",
"outputs_count": 2266
},
{
"role": "institution",
"id": "HX_I4210108322",
"outputs_count": 40567916
}
],
"geo": {
"city": "Toki",
"geonames_city_id": "1850207",
"region": null,
"country_code": "JP",
"country": "Japan",
"latitude": 35.349998474121094,
"longitude": 137.18333435058594
},
"international": {},
"updated_date": "2026-08-05T05:59:45",
"created_date": "2022-02-02T04:48:36",
"topics": [
{
"id": "HX_T12157",
"name": "Geochemistry and Geologic Mapping"
},
{
"id": "HX_T13067",
"name": "Geological Modeling and Analysis"
},
{
"id": "HX_T10346",
"name": "Magnetic confinement fusion research"
}
]
}
]
}
```
```json 400 Bad Request theme={null}
{
"statusCode": 400,
"message": "Bad Request - Invalid query parameters",
"error": "Bad Request"
}
```
```json 429 Rate Limit Exceeded theme={null}
{
"statusCode": 429,
"message": "Rate limit exceeded. Maximum 30 requests per minute.",
"error": "Too Many Requests"
}
```