---
title: Order API v2
description: "**Note:** This is the **v2** version of the **Order API** supports guest checkout payment flows. If you need to support member checkout payment flows, please use the [v1 beta](/api-docs/buy/order_v1/overview.html) version of the **Order API**. The **Order API** is part of the eBay Buy APIs. It is used to purchase items and track the purchase orders. The Order API supports the complete checkout process. Use the Order API with the other Buy APIs to create a buying application that lets eBay members buy from eBay sellers without visiting the eBay site. The Buy APIs provide the ability to purchase eBay items from your app or website. **Note:** This is a [![](https://developer.ebay.com/cms/img/docs/partners-api.svg \"Limited Release\")(Limited Release)](/api-docs/static/versioning.html#limited) API available only to select developers approved by business units. For information on how to obtain access to this API in production, see the [Buy APIs Requirements](/api-docs/buy/static/buy-requirements.html)."
api_version: 1.0
api_name: order_api_v2
api_type: REST
api_group: buy/order_api_v2
source_url:
  html: https://developer.ebay.com/develop/api/buy/order_api_v2
  md: https://developer.ebay.com/develop/api/buy/order_api_v2.md
---

# Order API v2 API

**Note:** This is the **v2** version of the **Order API** supports guest checkout payment flows. If you need to support member checkout payment flows, please use the [v1 beta](/api-docs/buy/order_v1/overview.html) version of the **Order API**.

  
The **Order API** is part of the eBay Buy APIs. It is used to purchase items and track the purchase orders. The Order API supports the complete checkout process. Use the Order API with the other Buy APIs to create a buying application that lets eBay members buy from eBay sellers without visiting the eBay site. The Buy APIs provide the ability to purchase eBay items from your app or website.  
  

**Note:** This is a [![](https://developer.ebay.com/cms/img/docs/partners-api.svg "Limited Release")(Limited Release)](/api-docs/static/versioning.html#limited) API available only to select developers approved by business units. For information on how to obtain access to this API in production, see the [Buy APIs Requirements](/api-docs/buy/static/buy-requirements.html).

## API Methods

The following API methods are available:

### applyGuestCoupon

#### POST /guest_checkout_session/{checkoutSessionId}/apply_coupon
**Description:** **Note:** The Order V2 API supports guest checkout payment flows. If you need to support member checkout payment flows, please use the [v1 version](/api-docs/buy/order_v1/resources/methods) of the Order V2 API.  

**Important!** [![Limited Release](/cms/img/docs/partners-api.svg "Limited Release")(Limited Release)](https://developer.ebay.com/api-docs/static/versioning.html#limited) This method is only available to select developers approved by business units.

  
This method adds a coupon to an eBay guest checkout session and applies it to all the eligible items in the order.  
  
The **checkoutSessionId** is passed in as a URI parameter and is required. The redemption code of the coupon is in the payload and is also required.  
  
For a list of supported sites and other restrictions, see [API Restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide.
**Parameters:**
- **checkoutSessionId** (string) *required*
  - This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace.  
  
This value is returned by the [initiateGuestCheckoutSession](/api-docs/buy/order/resources/guest_checkout_session/methods/initiateGuestCheckoutSession) method.  
  
**Note:** When using this ID, the X-EBAY-C-MARKETPLACE-ID value and developer App ID must be the same as that used when this guest checkout session was created. See [Checkout session restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide for details.
- **X-EBAY-C-MARKETPLACE-ID** (string) *required*
  - This header identifies the eBay marketplace where the order will occur.  
  
**Note:** For this method, this value must match the **X-EBAY-C-MARKETPLACE-ID** used when the associated checkout session was created.  
See [HTTP request headers](</api-docs/static/rest-request-components.html#marketpl >) for the marketplace ID values.
- **Content-Type** (string) *required*
  - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**.  
  
For more information, refer to [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP).
- **X-EBAY-C-ENDUSERCTX** (string)
  - This header is used to specify the **deviceId** for the device/user attempting to make the call.  
  
It contains an alphanumeric string that allows a payment gateway to track an API call attempt and confirm that it is a verified payment attempt by a device/user.

### getGuestCheckoutSession

#### GET /guest_checkout_session/{checkoutSessionId}
**Description:** **Note:** The Order V2 API supports guest checkout payment flows. If you need to support member checkout payment flows, please use the [v1 version](/api-docs/buy/order_v1/resources/methods) of the Order V2 API.  

**Important!** [![Limited Release](/cms/img/docs/partners-api.svg "Limited Release")(Limited Release)](https://developer.ebay.com/api-docs/static/versioning.html#limited) This method is only available to select developers approved by business units.

  
This method returns the details of the specified guest checkout session. The **checkoutSessionId** is passed in as a URI parameter and is required. This method has no request payload.  
  
For a list of supported sites and other restrictions, see [API Restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide.
**Parameters:**
- **checkoutSessionId** (string) *required*
  - This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace.  
  
This value is returned by the [initiateGuestCheckoutSession](/api-docs/buy/order/resources/guest_checkout_session/methods/initiateGuestCheckoutSession) method.  
  
**Note:** When using this ID, the X-EBAY-C-MARKETPLACE-ID value and developer App ID must be the same as that used when this guest checkout session was created. See [Checkout session restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide for details.
- **X-EBAY-C-MARKETPLACE-ID** (string) *required*
  - This header identifies the eBay marketplace where the order will occur.  
  
**Note:** For this method, this value must match the **X-EBAY-C-MARKETPLACE-ID** used when the associated checkout session was created.  
See [HTTP request headers](</api-docs/static/rest-request-components.html#marketpl >) for the marketplace ID values.
- **X-EBAY-C-ENDUSERCTX** (string)
  - This header is used to specify the **deviceId** for the device/user attempting to make the call.  
  
It contains an alphanumeric string that allows a payment gateway to track an API call attempt and confirm that it is a verified payment attempt by a device/user.

### initiateGuestCheckoutSession

#### POST /guest_checkout_session/initiate
**Description:** **Note:** The Order V2 API supports guest checkout payment flows. If you need to support member checkout payment flows, please use the [v1 version](/api-docs/buy/order_v1/resources/methods) of the Order V2 API.  

**Important!** [![Limited Release](/cms/img/docs/partners-api.svg "Limited Release")(Limited Release)](https://developer.ebay.com/api-docs/static/versioning.html#limited) This method is only available to select developers approved by business units.

  
This method creates an eBay guest checkout session, which is the first step in performing a checkout. The method returns a **checkoutSessionId** that you use as a URI parameter in subsequent guest checkout methods.  
  
**Note:** This method also returns the **X-EBAY-SECURITY-SIGNATURE** response header, which is a token that is used to launch the Checkout with eBay widget. The Checkout with eBay widget allows eBay guests to pay for items without leaving your site. For details about the Checkout with eBay widget, see [Integrating the Checkout with eBay button](/api-docs/buy/static/api-order.html#Integrat).  
Also see [Negative Testing Using Stubs](/api-docs/buy/static/ref-buy-negative-testing.html) for information on how to emulate error conditions for this method using stubs.  
  
**TIP:** To test the entire checkout flow, you might need a "test" credit card. You can generate a credit card number from [http://www.getcreditcardnumbers.com](http://www.getcreditcardnumbers.com).  
For a list of supported sites and other restrictions, see [API Restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide.
**Parameters:**
- **X-EBAY-C-ENDUSERCTX** (string)
  - This header is used to specify the **deviceId** for the device/user attempting to make the call.  
  
It contains an alphanumeric string that allows a payment gateway to track an API call attempt and confirm that it is a verified payment attempt by a device/user.
- **X-EBAY-C-MARKETPLACE-ID** (string) *required*
  - This header identifies the eBay marketplace where the order will occur.  
  
See [HTTP request headers](</api-docs/static/rest-request-components.html#marketpl >) for the marketplace ID values.
- **Content-Type** (string) *required*
  - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**.  
  
For more information, refer to [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP).

### removeGuestCoupon

#### POST /guest_checkout_session/{checkoutSessionId}/remove_coupon
**Description:** **Note:** The Order V2 API supports guest checkout payment flows. If you need to support member checkout payment flows, please use the [v1 version](/api-docs/buy/order_v1/resources/methods) of the Order V2 API.  

**Important!** [![Limited Release](/cms/img/docs/partners-api.svg "Limited Release")(Limited Release)](https://developer.ebay.com/api-docs/static/versioning.html#limited) This method is only available to select developers approved by business units.

  
This method removes a coupon from an eBay guest checkout session. The **checkoutSessionId** is passed in as a URI parameter and is required. The redemption code of the coupon is specified in the payload and is also required.  
  
For a list of supported sites and other restrictions, see [API Restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide.
**Parameters:**
- **checkoutSessionId** (string) *required*
  - This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace.  
  
This value is returned by the [initiateGuestCheckoutSession](/api-docs/buy/order/resources/guest_checkout_session/methods/initiateGuestCheckoutSession) method.  
  
**Note:** When using this ID, the X-EBAY-C-MARKETPLACE-ID value and developer App ID must be the same as that used when this guest checkout session was created. See [Checkout session restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide for details.
- **X-EBAY-C-MARKETPLACE-ID** (string) *required*
  - This header identifies the eBay marketplace where the order will occur.  
  
**Note:** For this method, this value must match the **X-EBAY-C-MARKETPLACE-ID** used when the associated checkout session was created.  
See [HTTP request headers](</api-docs/static/rest-request-components.html#marketpl >) for the marketplace ID values.
- **Content-Type** (string) *required*
  - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**.  
  
For more information, refer to [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP).
- **X-EBAY-C-ENDUSERCTX** (string)
  - This header is used to specify the **deviceId** for the device/user attempting to make the call.  
  
It contains an alphanumeric string that allows a payment gateway to track an API call attempt and confirm that it is a verified payment attempt by a device/user.

### updateGuestQuantity

#### POST /guest_checkout_session/{checkoutSessionId}/update_quantity
**Description:** **Note:** The Order V2 API supports guest checkout payment flows. If you need to support member checkout payment flows, please use the [v1 version](/api-docs/buy/order_v1/resources/methods) of the Order V2 API.  

**Important!** [![Limited Release](/cms/img/docs/partners-api.svg "Limited Release")(Limited Release)](https://developer.ebay.com/api-docs/static/versioning.html#limited) This method is only available to select developers approved by business units.

  
This method changes the quantity of the specified line item in an eBay guest checkout session.  
  
For a list of supported sites and other restrictions, see [API Restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide.
**Parameters:**
- **checkoutSessionId** (string) *required*
  - This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace.  
  
This value is returned by the [initiateGuestCheckoutSession](/api-docs/buy/order/resources/guest_checkout_session/methods/initiateGuestCheckoutSession) method.  
  
**Note:** When using this ID, the X-EBAY-C-MARKETPLACE-ID value and developer App ID must be the same as that used when this guest checkout session was created. See [Checkout session restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide for details.
- **X-EBAY-C-MARKETPLACE-ID** (string) *required*
  - This header identifies the eBay marketplace where the order will occur.  
  
**Note:** For this method, this value must match the **X-EBAY-C-MARKETPLACE-ID** used when the associated checkout session was created.  
See [HTTP request headers](</api-docs/static/rest-request-components.html#marketpl >) for the marketplace ID values.
- **Content-Type** (string) *required*
  - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**.  
  
For more information, refer to [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP).
- **X-EBAY-C-ENDUSERCTX** (string)
  - This header is used to specify the **deviceId** for the device/user attempting to make the call.  
  
It contains an alphanumeric string that allows a payment gateway to track an API call attempt and confirm that it is a verified payment attempt by a device/user.

### updateGuestShippingAddress

#### POST /guest_checkout_session/{checkoutSessionId}/update_shipping_address
**Description:** **Note:** The Order V2 API supports guest checkout payment flows. If you need to support member checkout payment flows, please use the [v1 version](/api-docs/buy/order_v1/resources/methods) of the Order V2 API.  

**Important!** [![Limited Release](/cms/img/docs/partners-api.svg "Limited Release")(Limited Release)](https://developer.ebay.com/api-docs/static/versioning.html#limited) This method is only available to select developers approved by business units.

  
This method changes the shipping address for the order in an eBay guest checkout session. All the line items in an order must be shipped to the same address, but the shipping method can be specific to the line item.  
  
**Note:** If the address submitted cannot be validated, a warning message will be returned. This does not prevent the method from executing, but you may want to verify the address.  
For a list of supported sites and other restrictions, see [API Restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide.
**Parameters:**
- **checkoutSessionId** (string) *required*
  - This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace.  
  
This value is returned by the [initiateGuestCheckoutSession](/api-docs/buy/order/resources/guest_checkout_session/methods/initiateGuestCheckoutSession) method.  
  
**Note:** When using this ID, the X-EBAY-C-MARKETPLACE-ID value and developer App ID must be the same as that used when this guest checkout session was created. See [Checkout session restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide for details.
- **X-EBAY-C-MARKETPLACE-ID** (string) *required*
  - This header identifies the eBay marketplace where the order will occur.  
  
**Note:** For this method, this value must match the **X-EBAY-C-MARKETPLACE-ID** used when the associated checkout session was created.  
See [HTTP request headers](</api-docs/static/rest-request-components.html#marketpl >) for the marketplace ID values.
- **Content-Type** (string) *required*
  - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**.  
  
For more information, refer to [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP).
- **X-EBAY-C-ENDUSERCTX** (string)
  - This header is used to specify the **deviceId** for the device/user attempting to make the call.  
  
It contains an alphanumeric string that allows a payment gateway to track an API call attempt and confirm that it is a verified payment attempt by a device/user.

### updateGuestShippingOption

#### POST /guest_checkout_session/{checkoutSessionId}/update_shipping_option
**Description:** **Note:** The Order V2 API supports guest checkout payment flows. If you need to support member checkout payment flows, please use the [v1 version](/api-docs/buy/order_v1/resources/methods) of the Order V2 API.  

**Important!** [![Limited Release](/cms/img/docs/partners-api.svg "Limited Release")(Limited Release)](https://developer.ebay.com/api-docs/static/versioning.html#limited) This method is only available to select developers approved by business units.

  
This method changes the shipping method for the specified line item in an eBay guest checkout session. The shipping option can be set for each line item. This gives the shopper the ability choose the cost of shipping for each line item.  
  
For a list of supported sites and other restrictions, see [API Restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide.
**Parameters:**
- **checkoutSessionId** (string) *required*
  - This path parameter specifies the unique eBay-assigned session identifier for a specific eBay marketplace.  
  
This value is returned by the [initiateGuestCheckoutSession](/api-docs/buy/order/resources/guest_checkout_session/methods/initiateGuestCheckoutSession) method.  
  
**Note:** When using this ID, the X-EBAY-C-MARKETPLACE-ID value and developer App ID must be the same as that used when this guest checkout session was created. See [Checkout session restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide for details.
- **X-EBAY-C-MARKETPLACE-ID** (string) *required*
  - This header identifies the eBay marketplace where the order will occur.  
  
**Note:** For this method, this value must match the **X-EBAY-C-MARKETPLACE-ID** used when the associated checkout session was created.  
See [HTTP request headers](</api-docs/static/rest-request-components.html#marketpl >) for the marketplace ID values.
- **Content-Type** (string) *required*
  - This header indicates the format of the request body provided by the client. Its value should be set to **application/json**.  
  
For more information, refer to [HTTP request headers](/api-docs/static/rest-request-components.html#HTTP).
- **X-EBAY-C-ENDUSERCTX** (string)
  - This header is used to specify the **deviceId** for the device/user attempting to make the call.  
  
It contains an alphanumeric string that allows a payment gateway to track an API call attempt and confirm that it is a verified payment attempt by a device/user.

### getGuestPurchaseOrder

#### GET /guest_purchase_order/{purchaseOrderId}
**Description:** **Note:** The Order V2 API supports guest checkout payment flows. If you need to support member checkout payment flows, please use the [v1 version](/api-docs/buy/order_v1/resources/methods) of the Order V2 API.  

**Important!** [![Limited Release](/cms/img/docs/partners-api.svg "Limited Release")(Limited Release)](https://developer.ebay.com/api-docs/static/versioning.html#limited) This method is only available to select developers approved by business units.

  
This method retrieves the details about a specific guest purchase order. It returns the line items, including purchase order status, dates created and modified, item quantity and listing data, payment and shipping information, and prices, taxes, discounts and credits.  
  
The **purchaseOrderId** is passed in as a URI parameter and is required.  
  
**Note:** The **purchaseOrderId** value is returned in the call-back URL that is sent through the new eBay pay widget. For more information about eBay managed payments and the new Order V2 API payment flow, see [Order V2 API](/api-docs/buy/static/api-order.html) in the Buying Integration Guide.  
You can use this method to not only get the details of a purchase order, but to check the value of the [purchaseOrderPaymentStatus](#response.purchaseOrderPaymentStatus) field to determine if the order has been paid for. If the order has been paid for, this field will return `PAID`.  
  
For a list of supported sites and other restrictions, see [API Restrictions](/api-docs/buy/static/ref-marketplace-supported.html) in the Buy Integration Guide.
**Parameters:**
- **purchaseOrderId** (string) *required*
  - This path parameter specifies the unique identifier of a purchase order made by a guest buyer, for which details are to be retrieved.  
  
**Note:** This value is returned in the response URL that is sent through the new eBay pay widget. For more information about eBay managed payments and the new Order V2 API payment flow, see [Order V2 API](/api-docs/buy/static/api-order.html) in the Buying Integration Guide.
- **X-EBAY-C-MARKETPLACE-ID** (string)
  - This header identifies the eBay marketplace where the order will occur.  
  
**Note:** For this method, this value must match the **X-EBAY-C-MARKETPLACE-ID** used when the associated checkout session was created.  
See [HTTP request headers](</api-docs/static/rest-request-components.html#marketpl >) for the marketplace ID values.
- **X-EBAY-C-ENDUSERCTX** (string)
  - This header is used to specify the **deviceId** for the device/user attempting to make the call.  
  
It contains an alphanumeric string that allows a payment gateway to track an API call attempt and confirm that it is a verified payment attempt by a device/user.

## Error Codes

The following error codes may be returned by this API:

### REQUEST Errors

#### 15001 - API_ORDER
**Description:** Missing field: {fieldName}. The indicated field is required for this request. Add the field and resubmit the call.

#### 15002 - API_ORDER
**Description:** Invalid field: {fieldName}. The indicated field contains an invalid value. Correct the value and resubmit the call.

#### 15003 - API_ORDER
**Description:** The checkout session requested does not exist.

#### 15025 - API_ORDER
**Description:** The App is not authorized to access this resource.

#### 15029 - API_ORDER
**Description:** The X-EBAY-C-MARKETPLACE-ID value {fieldValue} is invalid for this checkout session because it is different from the X-EBAY-C-MARKETPLACE-ID header value used to create the session. For all calls in this checkout session, you must use X-EBAY-C-MARKETPLACE-ID {supportedValues}.

#### 15032 - API_ORDER
**Description:** After using the 'initiateGuestPayment' call, you cannot make changes to the cart. If you need to change the cart, you must start over using the 'initiateGuestCheckoutSession' call.

#### 16002 - API_ORDER
**Description:** The coupon does not exist. The coupon was ignored and no discount was applied to this order.

#### 16003 - API_ORDER
**Description:** The coupon has expired. No discount was applied to this order.

#### 16004 - API_ORDER
**Description:** The coupon has not been activated. The coupon was ignored and no discount was applied to this order.

#### 16006 - API_ORDER
**Description:** The coupon code is invalid. The coupon was ignored and no discount was applied to this order.

#### 16022 - API_ORDER
**Description:** The coupon code is invalid. The coupon was ignored and no discount was applied to this order.

#### 16024 - API_ORDER
**Description:** The coupon provided could not be applied. You may proceed with this session or provide another coupon.

#### 15048 - API_ORDER
**Description:** The value of {fieldName} is too long. For more information, see the documentation for this call.

#### 17002 - API_ORDER
**Description:** Invalid character(s) found in the shipping address. Please check name and shipping address fields, remove invalid character(s) and resubmit the call.

#### 15033 - API_ORDER
**Description:** The payment cannot be processed because the payment information is invalid. You will need to create a new checkout session and submit corrected payment information.

#### 16025 - API_ORDER
**Description:** The coupon was not applied to this cart.

### BUSINESS Errors

#### 15019 - API_ORDER
**Description:** To place an order, you must have at least one line item. Use the initiateCheckoutSession call to add line items (maximum of {maxLineItems}) and create a new checkout session.

#### 15021 - API_ORDER
**Description:** This checkout session cannot be updated because the order has already been placed.

#### 15027 - API_ORDER
**Description:** The value {fieldValue} is not supported for the {fieldName}. The supported values are: {supportedValues}.

#### 16000 - API_ORDER
**Description:** The coupon is not valid for any of the items in the order. The coupon was ignored and no discount was applied to this order.

#### 16001 - API_ORDER
**Description:** You cannot apply multiple coupons to the same order. No discount was applied to this order.

#### 16005 - API_ORDER
**Description:** The coupon requires the buyer to spend a specific monetary amount. This threshold has not been met. The coupon was ignored and no discount was applied to this order.

#### 16007 - API_ORDER
**Description:** This coupon has already been used. The coupon was ignored and no discount was applied to this order.

#### 16008 - API_ORDER
**Description:** This coupon is no longer valid. The coupon was ignored and no discount was applied to this order.

#### 16009 - API_ORDER
**Description:** The coupon requires the buyer to spend a specific monetary amount. This threshold has not been met. The coupon was ignored and no discount was applied to this order.

#### 16010 - API_ORDER
**Description:** The coupon is not valid for the currency being used by the items. The coupon was ignored and no discount was applied to this order.

#### 16012 - API_ORDER
**Description:** The coupon is not valid for the {fieldName}. The coupon was ignored and no discount was applied to this order.

#### 16013 - API_ORDER
**Description:** The coupon is not valid for any of the item categories in the order. The coupon was ignored and no discount was applied to this order.

#### 16014 - API_ORDER
**Description:** The coupon is not valid for the selected payment method. The coupon was ignored and no discount was applied to this order.

#### 16015 - API_ORDER
**Description:** The coupon is not valid for the selected shipping option. The coupon was ignored and no discount was applied to this order.

#### 16016 - API_ORDER
**Description:** The coupon is valid only for items that are shipped domestically. The coupon was ignored and no discount was applied to this order.

#### 16017 - API_ORDER
**Description:** The coupon is valid only for items that are shipped internationally. The coupon was ignored and no discount was applied to this order.

#### 16018 - API_ORDER
**Description:** The buyer is not eligible for this coupon. The coupon was ignored and no discount was applied to this order.

#### 16019 - API_ORDER
**Description:** The coupon is not valid for guest eBay checkouts. The coupon was ignored and no discount was applied to this order.

#### 16023 - API_ORDER
**Description:** You cannot apply multiple coupons to the same order. The coupon was ignored and no discount was applied to this order.

#### 15011 - API_ORDER
**Description:** You have exceeded the maximum number of {maxLineItems} line items. Correct the request and resubmit the call.

#### 15012 - API_ORDER
**Description:** There is a limit on the quantity of this item that can be purchased. Reduce the quantity and resubmit the call.

#### 15013 - API_ORDER
**Description:** The item is either out of stock, or the desired quantity exceeds the quantity available. If out of stock, please wait for seller to restock. If desired quantity exceeds available quantity, please reduce the quantity value and try again.

#### 15014 - API_ORDER
**Description:** The quantity submitted for this item is invalid. Correct the quantity value and resubmit the call.

#### 15015 - API_ORDER
**Description:** There is a problem with the credit card and it cannot be used to purchase items. Use the updatePaymentInfo call to change the payment information.

#### 15017 - API_ORDER
**Description:** The payment for the order line items in your cart could not be processed due to issues with one or more sellers.

#### 15018 - API_ORDER
**Description:** The item is not available for purchase. This can be for several reasons including the listing has ended. Remove the item and resubmit the call.

#### 15026 - API_ORDER
**Description:** The item is not shippable to the specified shipping address.

#### 15028 - API_ORDER
**Description:** The item {itemId} is not available for purchase because it cannot be shipped to {country}.

#### 15031 - API_ORDER
**Description:** The item is not purchasable because the buyer has been blocked by the seller.

#### 15044 - API_ORDER
**Description:** At least one of the items in the cart cannot be purchased using this API. The purchase can be done on eBay, through the eBay app or eBay website.

#### 15045 - API_ORDER
**Description:** The item cannot be purchased because the seller is away and is not processing orders. If you are trying to purchase more than one item, you need to create a new checkout session to purchase the other items.

#### 15047 - API_ORDER
**Description:** In compliance with applicable economic sanctions and trade restrictions, eBay is unavailable in your location. If you believe you are receiving this notice in error, please contact eBay's Customer Service.

#### 15053 - API_ORDER
**Description:** Your desired item(s) are not available for purchase at this time. The unavailability of an item could be for any of several reasons, including the item being out of stock. Add available item(s) and resubmit the call.

#### 20002 - API_ORDER
**Description:** This item {itemId} is currently unavailable to buy from the seller.

### APPLICATION Errors

#### 15000 - API_ORDER
**Description:** There was a problem with an eBay internal system or process. Contact eBay developer support for assistance.

#### 16020 - API_ORDER
**Description:** Your application is not eligible for this coupon. The coupon was ignored and no discount was applied to this order.

#### 16001 - API_ORDER
**Description:** There was a problem with an eBay internal system or process. Contact eBay developer support for assistance.

## Rate Limits

See [API Call Limits](https://developer.ebay.com/develop/get-started/api-call-limits) on the eBay Developer Program.

## Resources

### Documentation

- [eBay Developer Program](https://developer.ebay.com/)
- [API Documentation](https://developer.ebay.com/develop/api/)
- [SDKs and Widgets](https://developer.ebay.com/develop/sdks-and-widgets)
- [Developer Community Forum](https://community.ebay.com/t5/Developer-Groups/ct-p/developergroup)

### Tools

- [API Explorer](https://developer.ebay.com/my/api_test_tool)
- [GraphQL Explorer](https://developer.ebay.com/my/graphql_explorer)

### Support

- [Developer Support](https://developer.ebay.com/support/)
- [API Status](https://developer.ebay.com/support/api-status)
- [Release Notes](https://developer.ebay.com/develop/api/release_notes/)

---
*Generated on 2026-08-10T16:08:07.176Z*