# 지정된 기간의 주문 목록 가져오기

가장 빠른 생성 날짜부터 최근 생성 날짜 순으로 정렬된 주문 목록을 검색합니다.

Endpoint: POST /v3/project/{project_id}/admin/order/search
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    프로젝트 ID입니다. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 확인할 수 있습니다.
    Example: 44056

## Request fields (application/json):

  - `created_date_from` (string)
    [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)에 따른 주문 생성 기간의 시작 날짜 또는 날짜-시간입니다.
    Example: "2020-04-15T18:16:00+05:00"

  - `created_date_until` (string)
    [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)에 따른 주문 생성 기간의 종료 날짜 또는 날짜-시간입니다.
    Example: "2020-04-16T18:16:00+05:00"

  - `limit` (integer)
    응답에 포함되는 주문 수에 대한 제한입니다.

  - `offset` (integer)
    목록이 생성되는 주문 수입니다(개수는 0부터 시작).

## Response 200 fields (application/json):

  - `has_more` (boolean)
    추가 페이지가 있는지 여부입니다.
    Example: true

  - `orders` (array)
    주문 목록입니다.

  - `orders.coupons` (array,null)
    주문에 적용된 쿠폰 목록입니다.

  - `orders.coupons.code` (string)
    사용된 쿠폰 코드입니다. 대소문자를 구분하는 고유한 코드입니다. 문자와 숫자를 포함합니다.

  - `orders.coupons.coupon_id` (integer)
    쿠폰으로 프로모션을 생성할 때 엑솔라가 생성한 쿠폰 ID입니다.

  - `orders.coupons.sku` (string)
    쿠폰으로 프로모션을 생성할 때 엑솔라가 생성하는 쿠폰 SKU입니다.

  - `orders.coupons.type` (string)
    쿠폰의 종류입니다.
    Enum: "unique_catalog_offer", "coupon", "promocode"

  - `orders.date_created` (string)
    [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)에 따른 주문 생성 날짜 또는 날짜-시간 코드입니다.
    Example: "2020-08-11T10:00:00+03:00"

  - `orders.invoice_id` (string)
    인보이스 ID입니다.

  - `orders.is_free` (boolean)
    주문이 무료인지 여부입니다.

  - `orders.items` (array)
    아이템 목록입니다.

  - `orders.items.description` (object,null)
    아이템에 대한 정보가 있는 개체입니다.

  - `orders.items.description.description` (string)
    아이템 설명입니다.

  - `orders.items.description.image_url` (string)
    아이템 이미지 URL입니다.

  - `orders.items.description.name` (string)
    아이템 이름입니다.

  - `orders.items.is_bonus` (boolean)
    아이템이 보너스인지 여부입니다.

  - `orders.items.is_free` (boolean)
    아이템이 무료인지 여부입니다.

  - `orders.items.item_id` (integer)
    아이템 ID입니다. 아이템을 생성할 때 엑솔라에 의해 생성됩니다.
    Example: 1

  - `orders.items.order_item_id` (integer)
    주문의 아이템 ID입니다. 주문 생성 중에 엑솔라에 의해 생성됩니다.

  - `orders.items.price` (object,null)
    아이템 가격입니다.

  - `orders.items.price.amount` (string)
    할인된 아이템 가격입니다.
    Example: "30"

  - `orders.items.price.amount_without_discount` (string)
    할인이 없는 아이템 가격입니다.
    Example: "30"

  - `orders.items.price.currency` (string)
    [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)에 따른 인게임 재화의 SKU 또는 3자리 코드입니다. [엑솔라에서 지원하는 통화](https://developers.xsolla.com/ko/doc/pay-station/references/supported-currencies/)에 대한 자세한 정보는 설명서를 참조하십시오.
    Example: "USD"

  - `orders.items.price.is_virtual_currency` (boolean)
    통화가 인게임 재화인지 여부입니다.

  - `orders.items.quantity` (integer)
    아이템 수량입니다.
    Example: 1

  - `orders.items.region_id` (integer,null)
    아이템을 사용할 수 있는 지역의 ID입니다. 지역별 판매 제한에 대한 자세한 정보는 [설명서](https://developers.xsolla.com/ko/doc/shop-builder/features/regional-restrictions/)를 참조하십시오.

  - `orders.items.sku` (string)
    생성하는 동안 지정된 아이템 ID입니다. SKU는 소문자 및 대문자 라틴 영숫자, 마침표, 대시 및 밑줄만 포함할 수 있습니다.
    Example: "elven_shield"

  - `orders.items.tax_category` (string)
    세금 범주입니다.
    Example: "DG00002"

  - `orders.items.type` (string)
    아이템 유형입니다.
    Enum: "virtual_good", "virtual_currency", "bundle", "game_key", "physical_good", "value_point"

  - `orders.mode` (string)
    주문 생성 모드입니다.
    Enum: "default", "sandbox"

  - `orders.order_id` (integer)
    주문 ID입니다.
    Example: 1

  - `orders.price` (object,null)
    주문 가격입니다.

  - `orders.price.amount` (string)
    최종 주문 가격입니다.
    Example: "30"

  - `orders.price.amount_without_discount` (string)
    할인이 없는 주문 가격입니다.
    Example: "30"

  - `orders.price.currency` (string)
    [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)에 따른 인게임 재화의 SKU 또는 실제 통화의 3자리 코드입니다. [엑솔라에서 지원하는 통화](https://developers.xsolla.com/ko/doc/pay-station/references/supported-currencies/)에 대한 자세한 정보는 설명서를 확인하십시오.
    Example: "USD"

  - `orders.project_id` (integer)
    프로젝트 ID입니다. 이 매개 변수는 [관리자 페이지](https://publisher.xsolla.com/)의 프로젝트 이름 옆에서 확인할 수 있습니다.
    Example: 44056

  - `orders.promotions` (array,null)
    주문에 적용된 프로모션 목록입니다.

  - `orders.promotions.promotion_id` (integer)
    프로젝트 내의 프로모션 ID입니다.
    Example: 111425

  - `orders.status` (string)
    주문 상태입니다.
    Enum: "new", "paid", "done", "canceled", "expired"

  - `orders.user` (object)

  - `orders.user.country` (string)
    [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)에 따른 대문자 2자리 국가 코드입니다. [액솔라에서 지원하는 국가](https://developers.xsolla.com/ko/doc/shop-builder/references/supported-countries/)에 대한 자세한 정보는 설명서를 참조하십시오.
    Example: "US"

  - `orders.user.email` (string)
    [RFC 822](https://www.w3.org/Protocols/rfc822/#z8) 프로토콜에 따라 형식이 지정된 사용자 이메일입니다.
    Example: "user@xsolla.com"

  - `orders.user.id` (string)
    주문을 생성할 때 전달된 사용자 ID입니다.
    Example: "07e653a2b15011e6818f005056a54369"

  - `orders.user.region_id` (integer,null)
    사용자의 지역 ID입니다. 지역별 판매 제한이 설정된 경우 반환됩니다. 주문을 생성할 때 전달된 사용자의 국가는 [지역을 생성](https://developers.xsolla.com/ko/api/shop-builder/operation/admin-create-region/)할 때 지정된 국가 목록과 일치합니다. 지역별 판매 제한에 대한 자세한 내용은 [설명서](https://developers.xsolla.com/ko/doc/shop-builder/features/regional-restrictions/)를 참조하십시오.
    Example: 12

  - `total_items_count` (integer)
    지정된 기간 동안의 총 주문 수입니다.
    Example: 1

## Response 401 fields (application/json):

  - `errorCode` (integer)
    Example: 1020

  - `errorMessage` (string)
    Example: "[0401-1020]: Error in Authentication method occurred"

  - `statusCode` (integer)
    Example: 401