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

# Field

> Retrieve detailed metadata for a single research field by its numeric ID.

Retrieves a broad research field (Level 1 taxonomy node) by its numeric identifier (e.g. `17` for Computer Science).

### Path Parameters

<ParamField path="id" type="string" required>
  Unique numeric field identifier (e.g. `17`).
</ParamField>

### Response Fields

<ResponseField name="id" type="string" required>
  Numeric field identifier (e.g. `"17"`).
</ResponseField>

<ResponseField name="name" type="string" required>
  Field display name (e.g. `"Computer Science"`).
</ResponseField>

<ResponseField name="description" type="string">
  Scope description.
</ResponseField>

<ResponseField name="display_name_alternatives" type="array">
  Alternative display names or abbreviations.
</ResponseField>

<ResponseField name="domain" type="object">
  Parent domain.

  <Expandable title="domain attributes">
    <ResponseField name="id" type="string">Domain numeric ID.</ResponseField>
    <ResponseField name="name" type="string">Domain display name.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="subfields" type="array">
  Child subfields.

  <Expandable title="subfields attributes">
    <ResponseField name="id" type="integer">Subfield numeric ID.</ResponseField>
    <ResponseField name="name" type="string">Subfield display name.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="siblings" type="array">
  Sibling fields.

  <Expandable title="siblings attributes">
    <ResponseField name="id" type="integer">Sibling field numeric ID.</ResponseField>
    <ResponseField name="name" type="string">Sibling field display name.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="outputs_count" type="integer">
  Total number of indexed outputs in this field.
</ResponseField>

<ResponseField name="cited_by_count" type="integer">
  Total citation count received.
</ResponseField>

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

  <Expandable title="ids attributes">
    <ResponseField name="wikidata" type="string">Wikidata URL.</ResponseField>
    <ResponseField name="wikipedia" type="string">Wikipedia URL.</ResponseField>
  </Expandable>
</ResponseField>

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

<ResponseField name="created_date" type="string">
  Creation timestamp.
</ResponseField>

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

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

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

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

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

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

  func main() {
  	resp, err := http.Get("https://api.hexagraph.in/fields/17")
  	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": 17,
    "name": "Computer Science",
    "description": "study of computation",
    "ids": {
      "wikidata": "https://www.wikidata.org/wiki/Q21198",
      "wikipedia": "https://en.wikipedia.org/wiki/Computer_science"
    },
    "display_name_alternatives": [
      "CS",
      "science of computing",
      "information processing science",
      "computing sciences",
      "sciences of computing",
      "computation science",
      "computing",
      "computer studies",
      "comp sci",
      "comp. sci",
      "comp. sci.",
      "compsci",
      "informatics"
    ],
    "domain": {
      "id": "3",
      "name": "Physical Sciences"
    },
    "subfields": [
      {
        "id": 1702,
        "name": "Artificial Intelligence"
      }
    ],
    "siblings": [
      {
        "id": 11,
        "name": "Agricultural and Biological Sciences"
      }
    ],
    "outputs_count": 23921112,
    "cited_by_count": 159243397,
    "updated_date": "2026-08-05T03:01:44",
    "created_date": "2024-01-23T15:21:08"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "statusCode": 404,
    "message": "Field with ID 999 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>