> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supahub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Labels

> Retrieve list of labels.

<ParamField body="GET" type="method" />

<ParamField body="/labels" type="path" />

### Query Parameters

Below are the query parameters available for customizing the response:

<ParamField body="id" type="string | undefined">
  Unique identifier for a specific label.
</ParamField>

<ParamField body="sortBy" default="slug:asc" type="(slug | createdAt):(asc | desc)">
  Criteria for sorting the labels list.
</ParamField>

<ParamField body="limit" default="10" type="1-100">
  Maximum number of labels to retrieve per request.
</ParamField>

<ParamField body="page" default="1" type="1-n">
  Page number for pagination.
</ParamField>

<RequestExample>
  ```javascript curl theme={null}
  // Replace API_KEY with your api key
  curl --location 'https://api.supahub.com/api/v1/labels?id=clrjfu0l1000nbfg811m40bwp&sortBy=slug%3Aasc&page=1&limit=10' \
  --header 'Authorization: Bearer API_KEY'
  ```

  ```javascript fetch theme={null}
  const myHeaders = new Headers();
  myHeaders.append("Authorization", "Bearer API_KEY"); // Replace API_KEY with your api key

  const requestOptions = {
    method: "GET",
    headers: myHeaders,
    redirect: "follow",
  };

  fetch(
    "https://api.supahub.com/api/v1/labels?id=clrjfu0l1000nbfg811m40bwp&sortBy=slug:asc&page=1&limit=10",
    requestOptions
  )
    .then((response) => response.text())
    .then((result) => console.log(result))
    .catch((error) => console.error(error));
  ```

  ```javascript axios theme={null}
  const axios = require("axios");

  let config = {
    method: "get",
    maxBodyLength: Infinity,
    url: "https://api.supahub.com/api/v1/labels?id=clrjfu0l1000nbfg811m40bwp&sortBy=slug:asc&page=1&limit=10",
    headers: {
      Authorization: "Bearer API_KEY", // Replace API_KEY with your api key
    },
  };

  async function makeRequest() {
    try {
      const response = await axios.request(config);
      console.log(JSON.stringify(response.data));
    } catch (error) {
      console.log(error);
    }
  }

  makeRequest();
  ```

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

  url = "https://api.supahub.com/api/v1/labels?id=clrjfu0l1000nbfg811m40bwp&sortBy=slug:asc&page=1&limit=10"

  headers = {
    'Authorization': 'Bearer API_KEY' # Replace API_KEY with your key.
  }

  response = requests.request("GET", url, headers=headers)

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