> ## 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 sources
> Query and list publication venues with filtering, sorting, and pagination.
Retrieves a paginated list of publication sources 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:journal`, `is_oa:true`).
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 source records.
Source ID (`HX_S...`).
Linking ISSN.
List of ISSN strings.
Source display name.
Host organization name.
Outputs count.
Open Access outputs count.
Citations count.
Summary statistics object.
Two-year mean citation rate.
Calculated h-index score.
Calculated i10-index score.
`true` if Open Access.
`true` if in DOAJ.
Year indexed in DOAJ.
`true` if high OA rate.
Year high OA rate started.
`true` if in SciELO.
`true` if using OJS.
`true` if preprint repository.
`true` if core journal.
Year source flipped to OA.
First publication year.
Last publication year.
Homepage URL.
APC pricing array.
APC price in USD.
APC USD breakdown by year.
Country metadata object (`{ code, name }`).
Affiliated societies array.
Alternate title strings array.
Source type (`journal`, `repository`, etc.).
Yearly outputs and citations breakdown.
Year number.
Outputs count in year.
Open Access outputs count in year.
Citations count in year.
ISO updated date string.
ISO creation date string.
Topics list array.
Topic ID (`HX_T...`).
Topic display name.
```bash cURL theme={null}
curl -X GET "https://api.hexagraph.in/sources?filter=type:repository&sort=outputs_count:desc&per_page=25"
```
```javascript JavaScript theme={null}
fetch("https://api.hexagraph.in/sources?filter=type:repository&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/sources", params={"filter": "type:repository", "sort": "outputs_count:desc", "per_page": 25})
print(response.json())
```
```json 200 OK theme={null}
{
"meta": {
"count": 255083,
"page": 1,
"per_page": 25
},
"results": [
{
"id": "HX_S7407052672",
"issn_l": null,
"issn": null,
"name": "NIFS",
"host_organization_name": null,
"outputs_count": 40589702,
"oa_outputs_count": 40589702,
"cited_by_count": 1,
"summary_stats": {
"2yr_mean_citedness": 2.463679087863222e-8,
"h_index": 1,
"i10_index": 0
},
"is_oa": false,
"is_in_doaj": false,
"is_in_doaj_since_year": null,
"is_high_oa_rate": false,
"is_high_oa_rate_since_year": null,
"is_in_scielo": false,
"is_ojs": false,
"is_preprint_repository": false,
"is_core": false,
"oa_flip_year": null,
"first_publication_year": 2024,
"last_publication_year": 2026,
"homepage_url": null,
"apc_prices": null,
"apc_usd": null,
"apc_usd_by_year": null,
"country": null,
"societies": [],
"alternate_titles": [],
"type": "repository",
"counts_by_year": [
{
"year": 2026,
"outputs_count": 11649566,
"oa_outputs_count": 11649566,
"cited_by_count": 0
},
{
"year": 2025,
"outputs_count": 18939996,
"oa_outputs_count": 18939996,
"cited_by_count": 1
},
{
"year": 2024,
"outputs_count": 10000140,
"oa_outputs_count": 10000140,
"cited_by_count": 0
}
],
"updated_date": "2026-07-28T14:16:12",
"created_date": "2025-10-10T00:00:00",
"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"
}
```