> ## 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 funders

> Query and list research funding agencies with filtering, sorting, and pagination.

Retrieves a paginated list of funding agencies with filtering and sorting capabilities.

### Query Parameters

<ParamField query="page" default="1" type="integer">
  Page number for pagination. Default is `1`.
</ParamField>

<ParamField query="per_page" default="25" type="integer">
  Results per page. Allowed values: `10`, `25`, `50`, `100`.
</ParamField>

<ParamField query="filter" type="string">
  Filter expression (e.g. `country_code:US`).
</ParamField>

<ParamField query="sort" type="string">
  Sorting parameter (e.g. `outputs_count:desc`, `cited_by_count:desc`).
</ParamField>

### Response Fields

<ResponseField name="meta" type="object" required>
  Pagination metadata.

  <Expandable title="meta attributes">
    <ResponseField name="count" type="integer">Total matching records count.</ResponseField>
    <ResponseField name="page" type="integer">Current page number.</ResponseField>
    <ResponseField name="per_page" type="integer">Items per page.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="results" type="array" required>
  Array of funder records.

  <Expandable title="results item attributes">
    <ResponseField name="id" type="string">Funder ID (`HX_F...`).</ResponseField>
    <ResponseField name="name" type="string">Funder display name.</ResponseField>
    <ResponseField name="alternate_titles" type="array">Alternative titles or abbreviations.</ResponseField>

    <ResponseField name="country" type="object">
      Country details.

      <Expandable title="country attributes">
        <ResponseField name="code" type="string">Two-letter country code.</ResponseField>
        <ResponseField name="name" type="string">Country display name.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="description" type="string">Summary description.</ResponseField>
    <ResponseField name="homepage_url" type="string">Official website URL.</ResponseField>
    <ResponseField name="image_url" type="string">Image URL.</ResponseField>
    <ResponseField name="image_thumbnail_url" type="string">Thumbnail image URL.</ResponseField>
    <ResponseField name="grants_count" type="integer">Grants count.</ResponseField>
    <ResponseField name="awards_count" type="integer">Awards count.</ResponseField>
    <ResponseField name="outputs_count" type="integer">Outputs count.</ResponseField>
    <ResponseField name="cited_by_count" type="integer">Citations count.</ResponseField>

    <ResponseField name="summary_stats" type="object">
      Aggregated impact metrics.

      <Expandable title="summary_stats attributes">
        <ResponseField name="2yr_mean_citedness" type="number">2-year mean citedness.</ResponseField>
        <ResponseField name="h_index" type="integer">h-index of the funder.</ResponseField>
        <ResponseField name="i10_index" type="integer">i10-index of the funder.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="ids" type="object">
      External identifiers.

      <Expandable title="ids attributes">
        <ResponseField name="doi" type="string">Digital Object Identifier.</ResponseField>
        <ResponseField name="ror" type="string">Research Organization Registry ID.</ResponseField>
        <ResponseField name="wikidata" type="string">Wikidata URL.</ResponseField>
        <ResponseField name="crossref" type="string">Crossref identifier.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="counts_by_year" type="array">
      Yearly metrics.

      <Expandable title="counts_by_year attributes">
        <ResponseField name="year" type="integer">Calendar year.</ResponseField>
        <ResponseField name="outputs_count" type="integer">Outputs count in the year.</ResponseField>
        <ResponseField name="oa_outputs_count" type="integer">Open Access outputs count in the year.</ResponseField>
        <ResponseField name="cited_by_count" type="integer">Citations count in the year.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="roles" type="array">
      Entity roles.

      <Expandable title="roles attributes">
        <ResponseField name="role" type="string">Role name (e.g. `funder`).</ResponseField>
        <ResponseField name="id" type="string">Role unique ID.</ResponseField>
        <ResponseField name="outputs_count" type="integer">Outputs count associated with this role.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="updated_date" type="string">Last updated timestamp.</ResponseField>
    <ResponseField name="created_date" type="string">Creation timestamp.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.hexagraph.in/funders?sort=outputs_count:desc&per_page=10"
  ```

  ```javascript JavaScript theme={null}
  fetch("https://api.hexagraph.in/funders?sort=outputs_count:desc&per_page=10")
    .then(response => response.json())
    .then(data => console.log(data));
  ```

  ```python Python theme={null}
  import requests

  response = requests.get("https://api.hexagraph.in/funders", params={"sort": "outputs_count:desc", "per_page": 10})
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "meta": {
      "count": 45639,
      "page": 1,
      "per_page": 25
    },
    "results": [
      {
        "id": "HX_F4320321001",
        "name": "National Natural Science Foundation of China",
        "alternate_titles": [
          "NNSF of China",
          "Guójiā Zìrán Kēxué Jījīn Wěiyuánhuì",
          "NSF of China",
          "The National Natural Science Foundation of China"
        ],
        "country": {
          "code": "CN",
          "name": "China"
        },
        "description": "Chinese government body",
        "homepage_url": "https://www.nsfc.gov.cn",
        "image_url": "https://commons.wikimedia.org/w/index.php?title=Special:Redirect/file/National Natural Science Foundation of China (20230310102823).jpg",
        "image_thumbnail_url": "https://commons.wikimedia.org/w/index.php?title=Special:Redirect/file/National Natural Science Foundation of China (20230310102823).jpg&width=300",
        "grants_count": 1698,
        "awards_count": 1190293,
        "outputs_count": 4455709,
        "cited_by_count": 113648084,
        "summary_stats": {
          "2yr_mean_citedness": 5.924197295373457,
          "h_index": 1211,
          "i10_index": 2243793
        },
        "ids": {
          "ror": "https://ror.org/01h0zpd94",
          "wikidata": "https://www.wikidata.org/entity/Q4501917",
          "crossref": "501100001809",
          "doi": "10.13039/501100001809"
        },
        "counts_by_year": [
          {
            "year": 2028,
            "outputs_count": 4,
            "oa_outputs_count": 4,
            "cited_by_count": 0
          }
        ],
        "roles": [
          {
            "role": "funder",
            "id": "HX_F4320321001",
            "outputs_count": 4455709
          }
        ],
        "updated_date": "2026-08-05T04:01:50",
        "created_date": "2023-02-13T20:32:25"
      }
    ]
  }
  ```

  ```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"
  }
  ```
</ResponseExample>
