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

# 목록 가져오기

생성한 트래킹 링크 목록을 불러옵니다.

```text GET theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
https://api.airbridge.io/v1/tracking-links
```

## Request

***

### Headers

<ParamField header="Accept-Language" type="string">
  API 요청 및 결과 반환에 사용할 언어를 지정할 수 있습니다. ISO-639-1 포맷을 따릅니다.
</ParamField>

<ParamField header="Content-Type" type="string">
  리소스의 미디어 타입을 나타냅니다. 기본값으로 `application/json`을 사용합니다.
</ParamField>

<ParamField header="Authorization" type="string">
  API 요청에 사용하는 키값입니다. [키값 생성 및 조회 방법](/ko/references/introduction)을 확인하여 획득할 수 있습니다.
</ParamField>

### Query Params

<ParamField query="from" type="string" required>
  생성한 트래킹 링크 목록을 조회할 기준 시작일.
</ParamField>

<ParamField query="to" type="string" required>
  생성한 트래킹 링크 목록을 조회할 기준 종료일.
</ParamField>

<ParamField query="skip" type="number">
  건너뛸 item의 갯수.
</ParamField>

<ParamField query="size" type="number">
  가져올 item의 갯수. (최대 500)
</ParamField>

<ParamField query="keyword" type="string">
  검색 키워드.
</ParamField>

<ParamField query="channel_name" type="string">
  채널 명 필터.
</ParamField>

<ParamField query="sort_key" type="enum">
  정렬 기준 (기본값: `createdAt`)

  | 벨류 | 설명 |
  | - | - |
  | `createdAt` | 생성 순 정렬 |
</ParamField>

<ParamField query="sort_type" type="enum">
  정렬 타입. (기본값: `DESC`)

  | 벨류 | 설명 |
  | - | - |
  | `DESC` | 내림차순 정렬. |
  | `ASC` | 오름차순 정렬. |
</ParamField>

<RequestExample>
  ```shellscript Request theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  curl -X GET 'https://api.airbridge.io/v1/tracking-links?from=2023-04-01&to=2023-04-02&skip=0&size=10&sort_key=createdAt&sort_type=DESC' \
    -H 'Accept-Language: ko' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer {AIRBRIDGE-API-TOKEN}'
  ```
</RequestExample>

## Response

***

### 200

### 400

입력한 필드가 오류가 있거나 형태가 올바르지 않습니다.

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  {
    "data": {
      "totalCount": 2,
      "trackingLinks": [
        {
          "id": 10001
        },
        {
          "id": 10002
        }
      ]
    }
  }
  ```

  ```json 400 theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  {
    "instance": [
      {
        "loc": [
          "size"
        ],
        "msg": "must be less than or equal to 1000",
        "type": "validation_error"
      }
    ],
    "detail": "invalid_request",
    "status": 400,
    "title": "Bad Request",
    "traceId": "1-68513579-369f49243aa5430b228cfa8a",
    "type": "about:blank"
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.