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

> Retrieve a paginated list of UN Sustainable Development Goals (SDGs).

Retrieves a paginated list of UN Sustainable Development Goals (SDGs).

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

### Response Fields

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

  <Expandable title="meta attributes">
    <ResponseField name="count" type="integer">
      Total number of matching records.
    </ResponseField>

    <ResponseField name="page" type="integer">
      Current page number.
    </ResponseField>

    <ResponseField name="per_page" type="integer">
      Number of records returned per page.
    </ResponseField>
  </Expandable>
</ResponseField>

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

  <Expandable title="results item attributes">
    <ResponseField name="id" type="integer">
      SDG ID.
    </ResponseField>

    <ResponseField name="name" type="string">
      Sustainable Development Goal title.
    </ResponseField>

    <ResponseField name="description" type="string">
      Description of the goal.
    </ResponseField>

    <ResponseField name="wikidata" type="string">
      Wikidata URL.
    </ResponseField>

    <ResponseField name="image_url" type="string">
      Full SVG image URL for the SDG icon.
    </ResponseField>

    <ResponseField name="image_thumbnail_url" type="string">
      Thumbnail URL for the SDG icon image.
    </ResponseField>

    <ResponseField name="outputs_count" type="integer">
      Total research outputs count linked to this SDG.
    </ResponseField>

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

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

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

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.hexagraph.in/references/sdgs?page=1&per_page=25"
  ```

  ```javascript JavaScript theme={null}
  fetch("https://api.hexagraph.in/references/sdgs?page=1&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/references/sdgs",
      params={"page": 1, "per_page": 25}
  )

  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "meta": {
      "count": 17,
      "page": 1,
      "per_page": 25
    },
    "results": [
      {
        "id": 1,
        "name": "No poverty",
        "description": "End poverty in all its forms everywhere.",
        "wikidata": "https://www.wikidata.org/wiki/Q50214636",
        "image_url": "https://commons.wikimedia.org/w/index.php?title=Special:Redirect/file/Sustainable Development Goal 01NoPoverty.svg",
        "image_thumbnail_url": "https://commons.wikimedia.org/w/index.php?title=Special:Redirect/file/Sustainable Development Goal 01NoPoverty.svg&width=300",
        "outputs_count": 2047954,
        "cited_by_count": 33936648,
        "created_date": "2024-02-09T16:05:05.000Z",
        "updated_date": "2026-08-02T06:02:45.000Z"
      }
    ]
  }
  ```

  ```json 400 Bad Request theme={null}
  {
    "statusCode": 400,
    "message": "Bad Request - Invalid query parameters",
    "error": "Bad Request"
  }
  ```

  ```json 429 Too Many Requests theme={null}
  {
    "statusCode": 429,
    "message": "Rate limit exceeded. Maximum 30 requests per minute.",
    "error": "Too Many Requests"
  }
  ```
</ResponseExample>