---
title: "주문 내역 조회"
method: GET
path: "/api/v3/shopping-fep/orders/v2"
tags: ["주문"]
---

# 주문 내역 조회

`GET /api/v3/shopping-fep/orders/v2`

커서 기반 페이지네이션을 사용하여 주문 내역을 조회합니다.

## 조회 조건
- 조회 범위는 최대 31일까지 조회 가능합니다
- `status` 파라미터를 생략하면 전체 주문 상태를 조회합니다
- `limit`은 최소 1, 최대 50까지 설정 가능하며, 범위를 벗어나면 자동으로 50으로 조정됩니다

## 페이지네이션
- 첫 페이지 조회 시 `nextCursor`를 생략합니다
- 다음 페이지 조회 시 응답으로 받은 `nextCursor` 값을 그대로 전달합니다
- 응답의 `nextCursor`가 null이면 마지막 페이지입니다

## Query parameters

- `status` 'PAID' | 'CANCELED_PAYMENT' | 'PREPARING_PRODUCT' | 'DELIVERING' | 'DELIVERED' | 'CONFIRMED_ORDER'
- `startDate` string, date, required
- `endDate` string, date, required
- `nextCursor` string
- `limit` integer
- `partnerName` string

## Response `200`

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

- object
  - `resultType` 'SUCCESS' | 'FAIL' — 응답 결과 타입
  - `error` object — 에러 응답, resultType FAIL 시 제공
    - `errorCode` 'INVALID_REQUEST' | 'INVALID_DATE_RANGE' | 'COMMON_ERROR' — 에러 코드
    - `reason` string — 에러 사유
  - `success` OrderCursorFepResponse — 주문 응답 객체
    - `results` GetOrderHistoriesCursorResponse[], required — 주문 내역 목록
      - `orderedAt` string, date-time, required — 주문 시각
      - `canceledAt` string, date-time — 주문 취소 시각
      - `confirmedAt` string, date-time — 구매확정 일시
      - `shippingDeadlineAt` string, date — 배송 마감 기한
      - `orderId` integer, required — 주문 ID, 주문건별 ID이므로 하나의 주문에 여러 상품이 포함될 수 있음
      - `orderProductId` integer, required — 주문 상품 ID, 주문에 포함된 주문상품별 ID
      - `productId` integer, required — 상품 ID
      - `stockId` integer, required — 재고 ID
      - `ordererName` string, required — 주문자 이름
      - `ordererPhone` string, required — 주문자 휴대전화번호
      - `ordererRealPhone` string — 주문자 실제 휴대전화번호
      - `receiverName` string, required — 수령인 이름
      - `receiverPhone` string, required — 수령인 휴대전화번호
      - `receiverRealPhone` string — 수령인 실제 휴대전화번호
      - `address` string, required — 배송지
      - `detailAddress` string, required — 배송지 상세
      - `zipCode` string, required — 우편번호
      - `shippingNote` string — 주문요청사항
      - `productName` string, required — 상품명
      - `optionName` string, required — 옵션명
      - `quantity` integer, required — 주문 수량
      - `price` integer, required — 판매가 주문 총금액 (판매가 * 주문 수량)
      - `originPrice` integer, required — 정상가 주문 총금액 (정상가 * 주문 수량)
      - `totalDiscountPrice` integer, required — 총 할인금액 (토스쇼핑 자체 할인금액 + 토스페이 할인금액). 추후 할인정책이 추가될 경우, 총 할인금액에 추가 항목이 포함될 수 있습니다
      - `tossShoppingDiscount` integer, required — 토스쇼핑 자체 할인금액
      - `tossPayDiscount` integer, required — 토스페이 할인금액
      - `tossPayPoint` integer, required — 토스포인트 사용 금액
      - `orderProductStatus` 'BEFORE_PAYMENT' | 'PAID' | 'PREPARING_PRODUCT' | 'DELIVERING' | 'DELIVERED' | 'CONFIRMED_ORDER' | 'CLAIM_REQUESTED_CANCEL' | 'CANCELED_PAYMENT' | 'CLAIM_REJECTED_CANCEL' | 'REQUESTED_EXCHANGE' | 'ONGOING_EXCHANGE' | 'COMPLETED_EXCHANGE' | 'CLAIM_REJECTED_EXCHANGE' | 'REQUESTED_RETURN' | 'ONGOING_RETURN' | 'COMPLETED_RETURN' | 'CLAIM_REJECTED_RETURN' | 'CLAIM_COLLECTING' | 'CLAIM_COLLECTED' | 'CLAIM_DELIVERING', required — 주문 상품 상태
      - `deliveryCompanyCode` string — 배송 회사 코드 (CJ대한통운, 우체국택배, 한진택배, 로젠택배 등)
      - `shippingTrackingNumber` string — 송장번호
      - `deliveryFeeGroupId` integer — 묶음그룹 ID, 하나의 묶음 단위 ID
      - `deliveryFee` integer — 총 배송비 (일반 배송비 + 제주/도서산간배송비)
      - `deliveryLocationType` 'JEJU' | 'MOUNTAIN' | 'NORMAL' — 배송지 유형
      - `normalDeliveryFee` integer — 일반 배송비
      - `jejuDeliveryFee` integer — 제주 배송비
      - `mountainDeliveryFee` integer — 도서산간 배송비
      - `productManagementCode` string — 상품 관리 코드
      - `productItemManagementCode` string — 옵션 관리 코드
    - `nextCursor` string — 다음 페이지 커서 정보. 마지막 페이지면 null

---

[API](https://skmtc.net/toss/apis/shoppingfep-api.md) · [All operations](https://skmtc.net/toss/apis/shoppingfep-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/toss/shoppingfep-api/revisions/57a25c0addc6/schema)