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

# Author

> Retrieve detailed metadata for a single researcher profile by its HX_A identifier.

Retrieves a single disambiguated researcher profile by its `HX_A` identifier. Profiles include output counts, citation totals, ORCID iDs, institutional affiliation history, topic expertise, and summary stats.

### Path Parameters

<ParamField path="id" type="string" required>
  Unique author identifier (e.g. `HX_A5028125522`). Must be prefixed with `HX_A`.
</ParamField>

### Response Fields

<ResponseField name="id" type="string" required>
  Unique author identifier prefixed with `HX_A` (e.g. `HX_A5028125522`).
</ResponseField>

<ResponseField name="orcid" type="object">
  ORCID profile and external identifiers.

  <Expandable title="orcid attributes">
    <ResponseField name="id" type="string">ORCID iD number string.</ResponseField>
    <ResponseField name="name" type="string">Author full name on ORCID.</ResponseField>
    <ResponseField name="biography" type="string">ORCID biography statement.</ResponseField>
    <ResponseField name="emails" type="array">Email addresses array.</ResponseField>

    <ResponseField name="externalIdentifiers" type="array">
      External authority IDs array.

      <Expandable title="externalIdentifiers attributes">
        <ResponseField name="id" type="string">External identifier value.</ResponseField>
        <ResponseField name="name" type="string">Identifier system name (e.g. `Scopus Author ID`).</ResponseField>
        <ResponseField name="url" type="string">External profile URL.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="websites" type="array">
      Author website links array.

      <Expandable title="websites attributes">
        <ResponseField name="url" type="string">Website URL.</ResponseField>
        <ResponseField name="name" type="string">Website display name.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="outputs_count" type="integer">ORCID recorded outputs count.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="name" type="string" required>
  Author display name.
</ResponseField>

<ResponseField name="full_name" type="string">
  Author full name.
</ResponseField>

<ResponseField name="outputs_count" type="integer">
  Total number of indexed publications authored by this researcher.
</ResponseField>

<ResponseField name="cited_by_count" type="integer">
  Total citation count across all authored publications.
</ResponseField>

<ResponseField name="last_known_institutions" type="array">
  Primary institutional affiliations.

  <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 last updated timestamp.
</ResponseField>

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

<ResponseField name="affiliations" type="array">
  Institutional affiliation history with years active.

  <Expandable title="affiliations attributes">
    <ResponseField name="id" type="string">Institution ID (`HX_I...`).</ResponseField>
    <ResponseField name="name" type="string">Institution display name.</ResponseField>
    <ResponseField name="years" type="array">Years active at this institution.</ResponseField>
  </Expandable>
</ResponseField>

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

  <Expandable title="summary_stats attributes">
    <ResponseField name="2yr_mean_citedness" type="number">Two-year mean citation rate.</ResponseField>
    <ResponseField name="h_index" type="integer">Calculated h-index score.</ResponseField>
    <ResponseField name="i10_index" type="integer">Calculated i10-index score.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="topics" type="array">
  Research topic expertise clusters.

  <Expandable title="topics attributes">
    <ResponseField name="id" type="string">Topic ID (`HX_T...`).</ResponseField>
    <ResponseField name="name" type="string">Topic name.</ResponseField>
    <ResponseField name="count" type="integer">Outputs count for topic.</ResponseField>
    <ResponseField name="share" type="number">Topic output share proportion.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="counts_by_year" type="array">
  Outputs and citation metrics grouped by year.

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

<ResponseField name="display_name_alternatives" type="array">
  Alternative display name strings array.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.hexagraph.in/authors/HX_A5028125522"
  ```

  ```javascript JavaScript theme={null}
  fetch("https://api.hexagraph.in/authors/HX_A5028125522")
    .then(response => response.json())
    .then(data => console.log(data));
  ```

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

  response = requests.get("https://api.hexagraph.in/authors/HX_A5028125522")
  print(response.json())
  ```

  ```go Go theme={null}
  package main

  import (
  	"fmt"
  	"io"
  	"net/http"
  )

  func main() {
  	resp, err := http.Get("https://api.hexagraph.in/authors/HX_A5028125522")
  	if err != nil {
  		fmt.Println("Error:", err)
  		return
  	}
  	defer resp.Body.Close()
  	body, _ := io.ReadAll(resp.Body)
  	fmt.Println(string(body))
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "HX_A5028125522",
    "orcid": {
      "id": "0000-0001-5669-1937",
      "name": "Tatsuya Kobayashi",
      "biography": null,
      "emails": null,
      "externalIdentifiers": [
        {
          "id": "55578306300",
          "name": "Scopus Author ID",
          "url": "http://www.scopus.com/inward/authorDetails.url?authorID=55578306300&partnerID=MN8TOARS"
        },
        {
          "id": "1000030733703",
          "name": "Researcher Name Resolver ID",
          "url": "https://nrid.nii.ac.jp/nrid/1000030733703/"
        }
      ],
      "websites": [
        {
          "url": "http://www.wanggenerator.com/",
          "name": "http://www.wanggenerator.com/"
        }
      ],
      "outputs_count": 207
    },
    "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",
    "affiliations": [
      {
        "id": "HX_I109009565",
        "name": "Dokkyo University",
        "years": [
          1992
        ]
      },
      {
        "id": "HX_I112524849",
        "name": "Yamagata University",
        "years": [
          2021
        ]
      },
      {
        "id": "HX_I135598925",
        "name": "Kyushu University",
        "years": [
          2026,
          2025,
          2024
        ]
      }
    ],
    "summary_stats": {
      "2yr_mean_citedness": 0.000026759443716450348,
      "h_index": 28,
      "i10_index": 99
    },
    "topics": [
      {
        "id": "HX_T10346",
        "name": "Magnetic confinement fusion research",
        "count": 186,
        "share": 0.000724
      },
      {
        "id": "HX_T10159",
        "name": "Ionosphere and magnetosphere dynamics",
        "count": 122,
        "share": 0.0002281
      },
      {
        "id": "HX_T10251",
        "name": "Solar and Space Plasma Dynamics",
        "count": 53,
        "share": null
      }
    ],
    "counts_by_year": [
      {
        "year": 1966,
        "outputs_count": 1,
        "oa_outputs_count": 0,
        "cited_by_count": 0
      },
      {
        "year": 1974,
        "outputs_count": 1,
        "oa_outputs_count": 0,
        "cited_by_count": 37
      },
      {
        "year": 1980,
        "outputs_count": 1,
        "oa_outputs_count": 0,
        "cited_by_count": 0
      },
      {
        "year": 1981,
        "outputs_count": 1,
        "oa_outputs_count": 0,
        "cited_by_count": 0
      },
      {
        "year": 1984,
        "outputs_count": 1,
        "oa_outputs_count": 0,
        "cited_by_count": 2
      }
    ],
    "display_name_alternatives": [
      "KOBAYASHI, Tatsuya",
      "Kobayashi, T.",
      "Kobayashi, Tatsuya",
      "T Kobayashi",
      "T. KOBAYASHI",
      "T. Kobayashi",
      "T.C. Kobayashi",
      "TATSUYA KOBAYASHI",
      "Tatsuya KOBAYASHI",
      "Tatsuya Kobayashi"
    ]
  }
  ```

  ```json 400 Bad Request theme={null}
  {
    "statusCode": 400,
    "message": "Only HX_ prefixed IDs are allowed",
    "error": "Bad Request"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "statusCode": 404,
    "message": "Author with ID HX_A9999999999 not found",
    "error": "Not Found"
  }
  ```

  ```json 429 Too Many Requests theme={null}
  {
    "statusCode": 429,
    "error": "Too Many Requests",
    "message": "IP rate limit exceeded (max 30 requests per minute). Please try again in 42 seconds (at 11:40:32 UTC).",
    "reset_in_seconds": 42,
    "reset_at_utc": "2026-08-05T11:40:32.000Z"
  }
  ```
</ResponseExample>
