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

> Query and list disambiguated author profiles with filtering, sorting, and pagination.

Retrieves a paginated list of author profiles 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. `outputs_count:>100`, `orcid:https://orcid.org/...`).
</ParamField>

<ParamField query="sort" type="string">
  Sorting parameter (allowed fields: `cited_by_count`, `outputs_count`, `id`, `name`).
</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 author records.

  <Expandable title="results item attributes">
    <ResponseField name="id" type="string">Author ID (`HX_A...`).</ResponseField>
    <ResponseField name="orcid" type="string">ORCID iD URL.</ResponseField>
    <ResponseField name="name" type="string">Author display name.</ResponseField>
    <ResponseField name="full_name" type="string">Author full name.</ResponseField>
    <ResponseField name="outputs_count" type="integer">Outputs count.</ResponseField>
    <ResponseField name="cited_by_count" type="integer">Citations count.</ResponseField>

    <ResponseField name="last_known_institutions" type="array">
      Affiliated institutions array.

      <Expandable title="last_known_institutions attributes">
        <ResponseField name="id" type="string">Institution ID (`HX_I...`).</ResponseField>
        <ResponseField name="name" type="string">Institution display name.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="updated_date" type="string">ISO update date string.</ResponseField>
    <ResponseField name="created_date" type="string">ISO creation date string.</ResponseField>

    <ResponseField name="topics" type="array">
      Topics list array.

      <Expandable title="topics attributes">
        <ResponseField name="id" type="string">Topic ID (`HX_T...`).</ResponseField>
        <ResponseField name="name" type="string">Topic name.</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

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

  ```javascript JavaScript theme={null}
  fetch("https://api.hexagraph.in/authors?sort=cited_by_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/authors", params={"sort": "cited_by_count:desc", "per_page": 25})
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "meta": {
      "count": 123036863,
      "page": 1,
      "per_page": 25
    },
    "results": [
      {
        "id": "HX_A5028125522",
        "orcid": "https://orcid.org/0000-0001-5669-1937",
        "name": "T. Kobayashi",
        "full_name": "KOBAYASHI, Tatsuya",
        "outputs_count": 2429356,
        "cited_by_count": 3625,
        "last_known_institutions": [
          {
            "id": "HX_I135598925",
            "name": "Kyushu University"
          },
          {
            "id": "HX_I150993360",
            "name": "Hamamatsu Photonics (Japan)"
          },
          {
            "id": "HX_I199525922",
            "name": "National Institutes of Natural Sciences"
          },
          {
            "id": "HX_I200475212",
            "name": "The Graduate University for Advanced Studies, SOKENDAI"
          },
          {
            "id": "HX_I4210108322",
            "name": "National Institute for Fusion Science"
          }
        ],
        "updated_date": "2026-08-03T12:17:51",
        "created_date": "2016-06-24T00:00:00",
        "topics": [
          {
            "id": "HX_T10346",
            "name": "Magnetic confinement fusion research"
          },
          {
            "id": "HX_T10159",
            "name": "Ionosphere and magnetosphere dynamics"
          },
          {
            "id": "HX_T10251",
            "name": "Solar and Space Plasma Dynamics"
          },
          {
            "id": "HX_T10384",
            "name": "Laser-Plasma Interactions and Diagnostics"
          },
          {
            "id": "HX_T10781",
            "name": "Plasma Diagnostics and Applications"
          }
        ]
      }
    ]
  }
  ```

  ```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>