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

# 초대 목록 조회

> 워크스페이스의 대기 중인 모든 초대의 페이지네이션된 목록을 조회합니다

### 쿼리 파라미터

<ParamField query="limit" type="number" default="20">
  반환할 항목 수.
</ParamField>

<ParamField query="offset" type="number" default="0">
  결과 수집을 시작하기 전에 건너뛸 항목 수.
</ParamField>

### 응답

<ResponseField name="items" type="Invite[]">
  <Expandable title="Invite">
    <ResponseField name="id" type="string">
      초대의 고유 식별자.
    </ResponseField>

    <ResponseField name="email" type="string">
      초대받는 사람의 이메일 주소. URL 기반 초대의 경우 null일 수 있습니다.
    </ResponseField>

    <ResponseField name="code" type="string">
      초대 코드.
    </ResponseField>

    <ResponseField name="role" type="string">
      초대받는 사람에게 할당된 역할. `admin`, `member` 중 하나.
    </ResponseField>

    <ResponseField name="expiresAt" type="string">
      초대가 만료되는 ISO8601 타임스탬프.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      초대가 생성된 ISO8601 타임스탬프.
    </ResponseField>

    <ResponseField name="isUrlInvite" type="boolean">
      URL 기반 초대인지 여부.
    </ResponseField>

    <ResponseField name="folders" type="Folder[]">
      <Expandable title="Folder">
        <ResponseField name="id" type="string">
          폴더 ID.
        </ResponseField>

        <ResponseField name="name" type="string">
          폴더 이름.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  <ResponseField name="limit" type="number">
    반환된 항목 수.
  </ResponseField>

  <ResponseField name="offset" type="number">
    건너뛴 항목 수.
  </ResponseField>

  <ResponseField name="total" type="number">
    사용 가능한 전체 항목 수.
  </ResponseField>
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl --request GET \
    --url https://api.caret.so/v1/invites?limit=20&offset=0 \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "items": [
      {
        "id": "inv_123",
        "email": "user@example.com",
        "code": "abc123xy",
        "role": "member",
        "expiresAt": "2026-02-27T10:00:00Z",
        "createdAt": "2026-01-28T10:00:00Z",
        "isUrlInvite": false,
        "folders": [
          {
            "id": "fol_456",
            "name": "Marketing"
          }
        ]
      }
    ],
    "pagination": {
      "limit": 20,
      "offset": 0,
      "total": 1
    }
  }
  ```
</ResponseExample>