# 쿠폰 목록 조회

## UI 소개

{% tabs %}
{% tab title="자동화" %}

<figure><img src="https://1362923181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PH5ktGI0BWG6g9fvtcn%2Fuploads%2FhucX7A7dxkVj2VK2O3xo%2FScreenshot%200006-10-13%20at%203.27.44%E2%80%AFPM.png?alt=media&#x26;token=b25bd1fa-c6d7-4820-ace5-1bae4d0aa9b9" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="데이터플로우" %}

<figure><img src="https://1362923181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5PH5ktGI0BWG6g9fvtcn%2Fuploads%2F0YfhLGwe8cOij3pkPtuN%2FScreenshot%200006-10-13%20at%207.17.19%E2%80%AFPM.png?alt=media&#x26;token=fd00165b-66b5-40bd-83ac-8fda422a6bad" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

<table><thead><tr><th width="173" align="center">항목명</th><th width="288" align="center">항목소개</th><th align="center">비고</th></tr></thead><tbody><tr><td align="center">쿠폰 코드</td><td align="center">특정 쿠폰 코드를 조회합니다. (선택)</td><td align="center"></td></tr><tr><td align="center">검색어</td><td align="center">검색어와 일치하는 쿠폰을 조회합니다. (선택)</td><td align="center"></td></tr><tr><td align="center">정렬 대상 선택</td><td align="center">쿠폰을 정렬할 대상을 선택합니다.</td><td align="center"><ul><li>날자 : 쿠폰 발행일 기준으로 정렬합니다. (기본값) </li><li>수정일 : 쿠폰정보 수정일 기준으로 정렬합니다. </li><li>쿠폰 ID : 쿠폰 ID를 기준으로 정렬합니다. </li><li>쿠폰코드 : 쿠폰코드를 기준으로 정렬합니다. </li><li>슬러그 : 쿠폰의 슬러그를 기준으로 정렬합니다. </li></ul></td></tr><tr><td align="center">정렬 기준 선택</td><td align="center">정렬 대상의 조회 기준을 선택합니다. </td><td align="center"><ul><li>내림차순(기본값) </li><li>오름차순 </li></ul></td></tr></tbody></table>

## 실행 결과&#x20;

<table><thead><tr><th width="342">데이터 값</th><th>데이터 내용</th></tr></thead><tbody><tr><td>id</td><td>쿠폰 ID</td></tr><tr><td>code</td><td>쿠폰 코드</td></tr><tr><td>amount</td><td>할인 금액</td></tr><tr><td>date_created</td><td>쿠폰 생성 일시(쇼핑몰 시간 설정 기준)</td></tr><tr><td>date_created_gmt</td><td>쿠폰 생성 일시(GMT 시간 기준)</td></tr><tr><td>date_modified</td><td>쿠폰 수정 일시(쇼핑몰 시간 설정 기준)</td></tr><tr><td>date_modified_gmt</td><td>쿠폰 수정 일시(GMT 시간 설정 기준)</td></tr><tr><td>discount_type</td><td>할인 유형<br>- fixed_cart : 고정금액 할인<br>- percent : 퍼센트 할인</td></tr><tr><td>description</td><td>쿠폰 설명</td></tr><tr><td>date_expires</td><td>쿠폰 만료 일시(쇼핑몰 시간 설정 기준)</td></tr><tr><td>date_expires_gmt</td><td>쿠폰 만료 일시(GMT 시간 설정 기준)</td></tr><tr><td>usage_count</td><td>쿠폰 사용 회수</td></tr><tr><td>individual_use</td><td>다른 쿠폰과 중복 사용 여부<br>  - true : 중복 사용 가능<br>  - false : 중복 사용 불가</td></tr><tr><td>product_ids</td><td>쿠폰 적용 가능 상품 ID</td></tr><tr><td>excluded_product_ids</td><td>쿠폰 미적용 상품 ID</td></tr><tr><td>usage_limit</td><td>전체 쿠폰 사용 제한 수</td></tr><tr><td>usage_limit_per_user</td><td>개인별 쿠폰 사용 제한 수</td></tr><tr><td>limit_usage_to_x_items</td><td>쿠폰 적용 가능한 최대 상품 수</td></tr><tr><td>free_shipping</td><td>무료배송 제공 여부<br>  - true : 허용<br>  - false : 제외</td></tr><tr><td>product_categories</td><td>쿠폰 사용 가능 상품 카테고리</td></tr><tr><td>excluded_product_categories</td><td>쿠폰 사용 불가 상품 카테고리</td></tr><tr><td>exclude_sale_items</td><td>할인 상품 적용 가능 여부<br>  - true : 허용<br>  - false : 제외</td></tr><tr><td>minimum_amount</td><td>쿠폰 적용 최소 주문금액</td></tr><tr><td>maximum_amount</td><td>쿠폰 적용 최대 주문금액</td></tr><tr><td>email_restrictions</td><td>이메일 제한 목록</td></tr><tr><td>used_by</td><td>쿠폰 사용자 목록</td></tr><tr><td>meta_data</td><td>쿠폰 추가 메타데이터</td></tr></tbody></table>