This doc page has moved! You should be automatically redirected to the resources page for the eBay Fulfillment API. If you are not redirected automatically, follow this link to the Fulfillment API.

eBay Fulfillment APIVersion 1.2.0

Get Orders

GET /order

Use this call to search for and retrieve one or more orders based on their creation date, last modification date, or fulfillment status using the filter parameter. You can alternatively specify a list of orders using the orderIds parameter.

The returned Order objects contain information you can use to create and process fulfillments, including:



Important: In this call, the cancelStatus.cancelRequests array is returned but is always empty. Use the getOrder call instead, which returns this array fully populated with information about any cancellation requests.

Input

See also Samples.

Resource URI (production)

GET https://api.ebay.com/sell/fulfillment/v1/order?
  filter=FilterField&
  limit=string&
  offset=string&
  orderIds=string

URI parameters

Parameter Type Required? Meaning
filter string Optional One or more comma-separated criteria for narrowing down the collection of orders returned by this call. These criteria correspond to specific fields in the response payload. Multiple filter criteria combine to further restrict the results.

Note: Currently, filter returns data from only the last 90 days. If the orderIds parameter is included in the request, the filter parameter will be ignored. The available criteria are as follows:

creationdate
The time period during which qualifying orders were created (the orders.creationDate field). In the URI, this is expressed as a starting timestamp, with or without an ending timestamp (in brackets). The timestamps are in ISO 8601 format, which uses the 24-hour Universal Coordinated Time (UTC) clock. For example:
  • creationdate:[2016-02-21T08:25:43.511Z..] identifies orders created on or after the given timestamp.
  • creationdate:[2016-02-21T08:25:43.511Z..2016-04-21T08:25:43.511Z] identifies orders created between the given timestamps, inclusive.
lastmodifieddate
The time period during which qualifying orders were last modified (the orders.modifiedDate field). In the URI, this is expressed as a starting timestamp, with or without an ending timestamp (in brackets). The timestamps are in ISO 8601 format, which uses the 24-hour Universal Coordinated Time (UTC) clock. For example:
  • lastmodifieddate:[2016-05-15T08:25:43.511Z..] identifies orders modified on or after the given timestamp.
  • lastmodifieddate:[2016-05-15T08:25:43.511Z..2016-05-31T08:25:43.511Z] identifies orders modified between the given timestamps, inclusive.
Note: If creationdate and lastmodifieddate are both included, only creationdate is used.
orderfulfillmentstatus
The degree to which qualifying orders have been shipped (the orders.orderFulfillmentStatus field). In the URI, this is expressed as one of the following value combinations:
  • orderfulfillmentstatus:{NOT_STARTED|IN_PROGRESS} specifies orders for which no shipping fulfillments have been started, plus orders for which at least one shipping fulfillment has been started but not completed.
  • orderfulfillmentstatus:{FULFILLED|IN_PROGRESS} specifies orders for which all shipping fulfillments have been completed, plus orders for which at least one shipping fulfillment has been started but not completed.
Note: The values NOT_STARTED, IN_PROGRESS, and FULFILLED can be used in various combinations, but only the combinations shown here are currently supported.
Here is an example of a getOrders call using all of these filters:

GET https://api.ebay.com/sell/v1/order?
filter=creationdate:%5B2016-03-21T08:25:43.511Z..2016-04-21T08:25:43.511Z%5D,
lastmodifieddate:%5B2016-05-15T08:25:43.511Z..%5D,
orderfulfillmentstatus:%7BNOT_STARTED%7CIN_PROGRESS%7D


Note: This call requires that certain special characters in the URI query string be percent-encoded:
     [ = %5B        ] = %5D        { = %7B        | = %7C        } = %7D
This query filter example uses these codes.


Applicable values are from FilterField.
limit string Optional The number of orders to return in the current result set. Use this parameter in conjunction with the offset parameter to control the pagination of the output.

For example, if offset is set to 10 and limit is set to 10, the call retrieves orders 11 thru 20 from the resulting collection of orders.

Note: This feature employs a zero-based list, where the first item in the list has an offset of 0. If the orderIds parameter is included in the request, this parameter will be ignored. Maximum: 1000
Default: 50
offset string Optional The first order to return based on its position in the collection of orders. Use this parameter in conjunction with the limit parameter to control the pagination of the output.

For example, if offset is set to 10 and limit is set to 10, the call retrieves orders 11 thru 20 from the resulting collection of orders.

Note: This feature employs a zero-based list, where the first item in the list has an offset of 0. If the orderIds parameter is included in the request, this parameter will be ignored. Default: 0 (zero)
orderIds string Optional A comma-separated list of the unique identifiers of the orders to retrieve (maximum 50). These values were originally generated by eBay as a result of the buyer's checkout process; for example, 170009092860-9849164007!140000000544476. These values are also returned in the orders.orderId field by invoking this call with filter parameters.

Note: If the orderIds parameter is included in the request, all other query parameters will be ignored.


HTTP request headers

All requests made to eBay REST operations require you to provide the authorization HTTP header for authentication.
See HTTP request headers for details.



OAuth request scope

This request requires a user access token with the following scope:

https://api.ebay.com/oauth/api_scope/sell.fulfillment

https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly

See Getting Access Tokens for more information.



Payload model

This call has no request payload.


Output

See also Samples.

HTTP status codes

This call can return one of the following HTTP status codes. See the HTTP Status Code Registry for a complete overview of HTTP status codes.

Status Meaning
200 Success
400 Bad Request
500 Internal Server Error

Payload model

Note: For information about the error fields and how to work with them, see Error Handling.

The following lists all fields that could be included in the response.

{ /* OrderSearchPagedCollection */
"href": string,
"limit": integer,
"next": string,
"offset": integer,
"orders": [
    { /* Order */
    "buyer":
        { /* Buyer */
        "username": string
        },
    "buyerCheckoutNotes": string,
    "cancelStatus":
        { /* CancelStatus */
        "cancelledDate": string,
        "cancelRequests": [
            { /* CancelRequest */
            "cancelCompletedDate": string,
            "cancelInitiator": string,
            "cancelReason": string,
            "cancelRequestedDate": string,
            "cancelRequestId": string,
            "cancelRequestState": string
            }
            /* More CancelRequest nodes here */
          ],
        "cancelState": string
        },
    "creationDate": string,
    "fulfillmentHrefs": [
        string
        /* More string nodes here */
      ],
    "fulfillmentStartInstructions": [
        { /* FulfillmentStartInstruction */
        "ebaySupportedFulfillment": boolean,
        "finalDestinationAddress":
            { /* Address */
            "addressLine1": string,
            "addressLine2": string,
            "city": string,
            "countryCode": string,
            "county": string,
            "postalCode": string,
            "stateOrProvince": string
            },
        "fulfillmentInstructionsType": string,
        "maxEstimatedDeliveryDate": string,
        "minEstimatedDeliveryDate": string,
        "shippingStep":
            { /* ShippingStep */
            "shippingCarrierCode": string,
            "shippingServiceCode": string,
            "shipTo":
                { /* Contact */
                "companyName": string,
                "contactAddress":
                    { /* Address */
                    "addressLine1": string,
                    "addressLine2": string,
                    "city": string,
                    "countryCode": string,
                    "county": string,
                    "postalCode": string,
                    "stateOrProvince": string
                    },
                "fullName": string,
                "primaryPhone":
                    { /* PhoneNumber */
                    "phoneNumber": string
                    }
                }
            }
        }
        /* More FulfillmentStartInstruction nodes here */
      ],
    "lastModifiedDate": string,
    "lineItems": [
        { /* LineItem */
        "appliedPromotions": [
            { /* AppliedPromotion */
            "description": string,
            "discountAmount":
                { /* Amount */
                "convertedFromCurrency": string,
                "convertedFromValue": string,
                "currency": string,
                "value": string
                },
            "promotionId": string
            }
            /* More AppliedPromotion nodes here */
          ],
        "deliveryCost":
            { /* DeliveryCost */
            "importCharges":
                { /* Amount */
                "convertedFromCurrency": string,
                "convertedFromValue": string,
                "currency": string,
                "value": string
                },
            "shippingCost":
                { /* Amount */
                "convertedFromCurrency": string,
                "convertedFromValue": string,
                "currency": string,
                "value": string
                },
            "shippingIntermediationFee":
                { /* Amount */
                "convertedFromCurrency": string,
                "convertedFromValue": string,
                "currency": string,
                "value": string
                }
            },
        "discountedLineItemCost":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": string,
            "currency": string,
            "value": string
            },
        "giftDetails":
            { /* GiftDetails */
            "message": string,
            "recipientEmail": string,
            "senderName": string
            },
        "legacyItemId": string,
        "legacyVariationId": string,
        "lineItemCost":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": string,
            "currency": string,
            "value": string
            },
        "lineItemFulfillmentInstructions":
            { /* LineItemFulfillmentInstructions */
            "guaranteedDelivery": boolean,
            "maxEstimatedDeliveryDate": string,
            "minEstimatedDeliveryDate": string,
            "shipByDate": string
            },
        "lineItemFulfillmentStatus": string,
        "lineItemId": string,
        "listingMarketplaceId": string,
        "properties":
            { /* LineItemProperties */
            "buyerProtection": boolean,
            "fromBestOffer": boolean
            },
        "purchaseMarketplaceId": string,
        "quantity": integer,
        "sku": string,
        "soldFormat": string,
        "taxes": [
            { /* Tax */
            "amount":
                { /* Amount */
                "convertedFromCurrency": string,
                "convertedFromValue": string,
                "currency": string,
                "value": string
                }
            }
            /* More Tax nodes here */
          ],
        "title": string,
        "total":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": string,
            "currency": string,
            "value": string
            }
        }
        /* More LineItem nodes here */
      ],
    "orderFulfillmentStatus": string,
    "orderId": string,
    "orderPaymentStatus": string,
    "paymentSummary":
        { /* PaymentSummary */
        "payments": [
            { /* Payment */
            "amount":
                { /* Amount */
                "convertedFromCurrency": string,
                "convertedFromValue": string,
                "currency": string,
                "value": string
                },
            "paymentDate": string,
            "paymentHolds": [
                { /* PaymentHold */
                "expectedReleaseDate": string,
                "holdAmount":
                    { /* Amount */
                    "convertedFromCurrency": string,
                    "convertedFromValue": string,
                    "currency": string,
                    "value": string
                    },
                "holdReason": string,
                "holdState": string,
                "releaseDate": string,
                "sellerActionsToRelease": [
                    { /* SellerActionsToRelease */
                    "sellerActionToRelease": string
                    }
                    /* More SellerActionsToRelease nodes here */
                  ]
                }
                /* More PaymentHold nodes here */
              ],
            "paymentMethod": string,
            "paymentReferenceId": string,
            "paymentStatus": string
            }
            /* More Payment nodes here */
          ],
        "refunds": [
            { /* OrderRefund */
            "amount":
                { /* Amount */
                "convertedFromCurrency": string,
                "convertedFromValue": string,
                "currency": string,
                "value": string
                },
            "refundDate": string,
            "refundReferenceId": string,
            "refundStatus": string
            }
            /* More OrderRefund nodes here */
          ],
        "totalDueSeller":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": string,
            "currency": string,
            "value": string
            }
        },
    "pricingSummary":
        { /* PricingSummary */
        "adjustment":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": string,
            "currency": string,
            "value": string
            },
        "deliveryCost":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": string,
            "currency": string,
            "value": string
            },
        "deliveryDiscount":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": string,
            "currency": string,
            "value": string
            },
        "fee":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": string,
            "currency": string,
            "value": string
            },
        "priceDiscountSubtotal":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": string,
            "currency": string,
            "value": string
            },
        "priceSubtotal":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": string,
            "currency": string,
            "value": string
            },
        "tax":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": string,
            "currency": string,
            "value": string
            },
        "total":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": string,
            "currency": string,
            "value": string
            }
        },
    "sellerId": string
    }
    /* More Order nodes here */
  ],
"prev": string,
"total": integer,
"warnings": [
    { /* ErrorDetailV3 */
    "category": string,
    "domain": string,
    "errorId": integer,
    "inputRefIds": [
        string
        /* More string nodes here */
      ],
    "longMessage": string,
    "message": string,
    "outputRefIds": [
        string
        /* More string nodes here */
      ],
    "parameters": [
        { /* ErrorParameterV3 */
        "name": string,
        "value": string
        }
        /* More ErrorParameterV3 nodes here */
      ],
    "subdomain": string
    }
    /* More ErrorDetailV3 nodes here */
  ]
}

Response field descriptions



Output Container/Field Type Occurrence Meaning
href string Conditionally The URI of the getOrders call request that produced this result set.
limit integer Always The maximum number of orders returned in the current result set.

Note: If this is the last or only result set in the collection, it may contain fewer orders. To determine the number of result sets in the collection, divide this into the value of total and round up to the next integer.Default: 50
next string Conditionally The getOrders call URI for the next result set. For example, the following URI returns records 41 thru 50 from the collection of orders:

path/order?limit=10&offset=40
offset integer Always The distance (number of records) from the first order in the collection to the first order in this result set. In the request, you can use the offset parameter in conjunction with the limit parameter to control the pagination of the output. For example, if offset is set to 30 and limit is set to 10, the call retrieves orders 31 thru 40 from the resulting collection of orders.

Note: This feature employs a zero-based list, where the first item in the list has an offset of 0.Default: 0 (zero)
orders array of Order Always Contains the array of orders in the current result set. The details of each order include information about the buyer, order history, shipping fulfillments, line items, costs, payments, and order fulfillment status.

The orders are sorted by orders.orderId.
orders.buyer Buyer Always Contains information about the buyer who paid the order.
orders.buyer.username string Always The buyer's eBay user name.
orders.buyerCheckoutNotes string Conditionally Comments about the order (if any) provided by the buyer at checkout.
orders.cancelStatus CancelStatus Always Contains information about a request (if any) that has been made to cancel the order.
orders.cancelStatus
  .cancelledDate
string Conditionally The date and time the order was cancelled, if applicable. This timestamp is in ISO 8601 format, which uses the 24-hour Universal Coordinated Time (UTC) clock.

Format: YYYY-MM-DDTHH:MM:SS.SSSZ
Example: 2015-08-04T19:09:02.768Z
orders.cancelStatus
  .cancelRequests
array of CancelRequest Always Contains the details of one or more buyer requests to cancel the order.

For the getOrders call: This array is returned but is always empty.
For the getOrder call: This array is returned fully populated with information about any cancellation requests.
orders.cancelStatus
  .cancelRequests
  .cancelCompletedDate
string Conditionally The date and time that the order cancellation was completed, if applicable. This timestamp is in ISO 8601 format, which uses the 24-hour Universal Coordinated Time (UTC) clock.

Format: YYYY-MM-DDTHH:MM:SS.SSSZ
Example: 2015-08-04T19:09:02.768Z
orders.cancelStatus
  .cancelRequests
  .cancelInitiator
string Always The party who made the initial cancellation request.
orders.cancelStatus
  .cancelRequests.cancelReason
string Always The reason why the cancelInitiator initiated the cancellation request.
orders.cancelStatus
  .cancelRequests
  .cancelRequestedDate
string Always The date and time that the order cancellation was requested. This timestamp is in ISO 8601 format, which uses the 24-hour Universal Coordinated Time (UTC) clock.

Format: YYYY-MM-DDTHH:MM:SS.SSSZ
Example: 2015-08-04T19:09:02.768Z
orders.cancelStatus
  .cancelRequests
  .cancelRequestId
string Always The unique identifier of the order cancellation request.
orders.cancelStatus
  .cancelRequests
  .cancelRequestState
string Always The current stage or condition of the cancellation request.

Applicable values are from CancelRequestStateEnum:

COMPLETED
The buyer's cancellation request has been accepted and the order has been cancelled.
REJECTED
The buyer's request to cancel the order has been rejected.
REQUESTED
The buyer has requested that a particular order be cancelled.

Code so that your app gracefully handles any future changes to this list.
orders.cancelStatus
  .cancelState
string Always The state of the order with regard to cancellation.

Applicable values are from CancelStateEnum:

CANCELED
The order has been cancelled.
IN_PROGRESS
One or more cancellation requests have been made against the order.
NONE_REQUESTED
No cancellation requests have been made against the order.

Code so that your app gracefully handles any future changes to this list.
orders.creationDate string Always The date and time that the order was created. This timestamp is in ISO 8601 format, which uses the 24-hour Universal Coordinated Time (UTC) clock.

Format: YYYY-MM-DDTHH:MM:SS.SSSZ
Example: 2015-08-04T19:09:02.768Z
orders.fulfillmentHrefs array of string Conditionally Contains a list of one or more hypertext references in the form of URLs. Each URL can be used to invoke the Get Shipping Fulfillment call to retrieve the details of each fulfillment, if any, that is associated with this order.
orders
  .fulfillmentStartInstructions
array of FulfillmentStartInstruction Always Contains a list of one or more sets of specifications for fulfilling the order. Each set specifies the type of fulfillment, shipping carrier and service, addressing details, and estimated delivery window. These instructions are derived from the buyer's and seller's eBay account preferences, the listing parameters, and the buyer's checkout selections. The seller can use them as a starting point for packaging, addressing, and shipping the order.
orders
  .fulfillmentStartInstructions
  .ebaySupportedFulfillment
boolean Always A value of true indicates that the value of the fulfillmentInstructionsType field is SHIP_TO, and that the fulfillment will be shipped via eBay's Global Shipping Program.

For more information, see Managing Shipping.
orders
  .fulfillmentStartInstructions
  .finalDestinationAddress
Address Conditionally Contains the final destination address of the shipment.

This address is returned only for Global Shipping Program shipments. Sellers should not ship directly to this address; instead they should ship this package to their international shipping provider's domestic warehouse. The international shipping provider is responsible for delivery to the final destination address.

For more information, see Addressing a Global Shipping Program Shipment.
orders
  .fulfillmentStartInstructions
  .finalDestinationAddress
  .addressLine1
string Always The first line of the street address.
orders
  .fulfillmentStartInstructions
  .finalDestinationAddress
  .addressLine2
string Conditionally The second line of the street address. This field can be used for additional address information, such as a suite or apartment number.
orders
  .fulfillmentStartInstructions
  .finalDestinationAddress.city
string Conditionally The city of the address.
orders
  .fulfillmentStartInstructions
  .finalDestinationAddress
  .countryCode
string Always The country of the address, represented as two-letter ISO 3166-1 alpha-2 country code. For example, US represents the United States, and DE represents Germany.

Applicable values are from CountryCodeEnum:See countryCode.
Code so that your app gracefully handles any future changes to this list.
orders
  .fulfillmentStartInstructions
  .finalDestinationAddress
  .county
string Conditionally The county (not the country) in which the address is located. Counties typically, but not always, contain multiple cities or towns.
orders
  .fulfillmentStartInstructions
  .finalDestinationAddress
  .postalCode
string Conditionally The postal code (if any) of the address.
orders
  .fulfillmentStartInstructions
  .finalDestinationAddress
  .stateOrProvince
string Conditionally The state or province within the country in which the address resides.
orders
  .fulfillmentStartInstructions
  .fulfillmentInstructionsType
string Always The method of fulfillment that will be used to deliver this set of line items to the buyer.

Applicable values are from FulfillmentInstructionsType:

DIGITAL
The seller will make these line items available to the buyer as digital content via email, download, or another means.
PREPARE_FOR_PICKUP
This value is reserved for internal or future use.
SELLER_DEFINED
The seller will determine how to deliver these line items to the buyer.
SHIP_TO
The seller will package and ship these line items to the buyer.

Code so that your app gracefully handles any future changes to this list.
orders
  .fulfillmentStartInstructions
  .maxEstimatedDeliveryDate
string Conditionally NOT returned if the value of the fulfillmentInstructionsType field is DIGITAL or PREPARE_FOR_PICKUP, or if the order has promotional free shipping. This is the estimated latest date that the fulfillment will be completed. This timestamp is in ISO 8601 format, which uses the 24-hour Universal Coordinated Time (UTC) clock.

Format: YYYY-MM-DDTHH:MM:SS.SSSZ
Example: 2015-08-04T19:09:02.768Z
orders
  .fulfillmentStartInstructions
  .minEstimatedDeliveryDate
string Conditionally NOT returned if the value of the fulfillmentInstructionsType field is DIGITAL or PREPARE_FOR_PICKUP, or if the order has promotional free shipping. This is the estimated earliest date that the fulfillment will be completed. This timestamp is in ISO 8601 format, which uses the 24-hour Universal Coordinated Time (UTC) clock.

Format: YYYY-MM-DDTHH:MM:SS.SSSZ
Example: 2015-08-04T19:09:02.768Z
orders
  .fulfillmentStartInstructions
  .shippingStep
ShippingStep Conditionally Returned only if the value of fulfillmentInstructionsType is SHIP_TO. Contains shipping information for this fulfillment, including the carrier, the service, and the shipment destination.
orders
  .fulfillmentStartInstructions
  .shippingStep
  .shippingCarrierCode
string Always The code identifying the shipping carrier for this fulfillment.

Note: The Trading API's ShippingCarrierCodeType enumeration contains the most current list of eBay shipping carrier codes and the countries served by each carrier. See ShippingCarrierCodeType.
orders
  .fulfillmentStartInstructions
  .shippingStep
  .shippingServiceCode
string Always The eBay code identifying the shipping service used for this fulfillment.

Note: To get a complete list of available shipping services, applications should call the Trading API's GeteBayDetails call with a DetailName value of ShippingServiceDetails. To check for the shipping services available for a specific site, specify the site ID in the header. See also ShippingServiceCodeType.
orders
  .fulfillmentStartInstructions
  .shippingStep.shipTo
Contact Always Contains information about the individual or organization to whom the fulfillment package will be shipped.

Note: For a Global Shipping Program shipment, this is the address of the international shipping provider's domestic warehouse. The international shipping provider is responsible for delivery to the final destination address. For more information, see Addressing a Global Shipping Program Shipment.
orders
  .fulfillmentStartInstructions
  .shippingStep.shipTo
  .companyName
string Conditionally The contact's company name.
orders
  .fulfillmentStartInstructions
  .shippingStep.shipTo
  .contactAddress
Address Always Contains the details of the contact's geographical address.
orders
  .fulfillmentStartInstructions
  .shippingStep.shipTo
  .contactAddress.addressLine1
string Always The first line of the street address.
orders
  .fulfillmentStartInstructions
  .shippingStep.shipTo
  .contactAddress.addressLine2
string Conditionally The second line of the street address. This field can be used for additional address information, such as a suite or apartment number.
orders
  .fulfillmentStartInstructions
  .shippingStep.shipTo
  .contactAddress.city
string Conditionally The city of the address.
orders
  .fulfillmentStartInstructions
  .shippingStep.shipTo
  .contactAddress.countryCode
string Always The country of the address, represented as two-letter ISO 3166-1 alpha-2 country code. For example, US represents the United States, and DE represents Germany.

Applicable values are from CountryCodeEnum:See countryCode.
Code so that your app gracefully handles any future changes to this list.
orders
  .fulfillmentStartInstructions
  .shippingStep.shipTo
  .contactAddress.county
string Conditionally The county (not the country) in which the address is located. Counties typically, but not always, contain multiple cities or towns.
orders
  .fulfillmentStartInstructions
  .shippingStep.shipTo
  .contactAddress.postalCode
string Conditionally The postal code (if any) of the address.
orders
  .fulfillmentStartInstructions
  .shippingStep.shipTo
  .contactAddress
  .stateOrProvince
string Conditionally The state or province within the country in which the address resides.
orders
  .fulfillmentStartInstructions
  .shippingStep.shipTo.fullName
string Always The contact's full name.
orders
  .fulfillmentStartInstructions
  .shippingStep.shipTo
  .primaryPhone
PhoneNumber Conditionally Contains the contact's primary telephone number.
orders
  .fulfillmentStartInstructions
  .shippingStep.shipTo
  .primaryPhone.phoneNumber
string Always The telephone number.
orders.lastModifiedDate string Always The date and time that the order was last modified.This timestamp is in ISO 8601 format, which uses the 24-hour Universal Coordinated Time (UTC) clock.

Format: YYYY-MM-DDTHH:MM:SS.SSSZ
Example: 2015-08-04T19:09:02.768Z
orders.lineItems array of LineItem Always Contains the details of one or more line items that comprise the order. A line item consists of one or more units of a specific variation and version of a listed item that has been purchased.
orders.lineItems
  .appliedPromotions
array of AppliedPromotion Conditionally Contains information about one or more sales promotions or discounts applied to the line item.
orders.lineItems
  .appliedPromotions.description
string Always A description of the applied promotion.
orders.lineItems
  .appliedPromotions
  .discountAmount
Amount Always The monetary amount of the discount for the promotion.
orders.lineItems
  .appliedPromotions
  .discountAmount
  .convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.lineItems
  .appliedPromotions
  .discountAmount
  .convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.lineItems
  .appliedPromotions
  .discountAmount.currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.lineItems
  .appliedPromotions
  .discountAmount.value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.lineItems
  .appliedPromotions.promotionId
string Always An eBay-generated identifier for the promotion. This is the value generated by the Marketing API's Create Item Promotion call and returned as the resource identifier of the location code that accompanies the HTTP 201 status code. It is also returned by the Trading API's SetPromotionalSale call and in the PromotionalSaleID field.
orders.lineItems.deliveryCost DeliveryCost Always Contains a breakdown of all costs associated with the fulfillment of the line item.
orders.lineItems.deliveryCost
  .importCharges
Amount Conditionally The amount of any import charges applied to international shipping of the line item.
orders.lineItems.deliveryCost
  .importCharges
  .convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.lineItems.deliveryCost
  .importCharges
  .convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.lineItems.deliveryCost
  .importCharges.currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.lineItems.deliveryCost
  .importCharges.value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.lineItems.deliveryCost
  .shippingCost
Amount Conditionally The total cost of shipping all units of the line item.
orders.lineItems.deliveryCost
  .shippingCost
  .convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.lineItems.deliveryCost
  .shippingCost
  .convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.lineItems.deliveryCost
  .shippingCost.currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.lineItems.deliveryCost
  .shippingCost.value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.lineItems.deliveryCost
  .shippingIntermediationFee
Amount Conditionally The amount of any fee charged by a provider of shipping intermediation for the line item.
orders.lineItems.deliveryCost
  .shippingIntermediationFee
  .convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.lineItems.deliveryCost
  .shippingIntermediationFee
  .convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.lineItems.deliveryCost
  .shippingIntermediationFee
  .currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.lineItems.deliveryCost
  .shippingIntermediationFee
  .value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.lineItems
  .discountedLineItemCost
Amount Conditionally The cost of the line item after applying any discounts.
orders.lineItems
  .discountedLineItemCost
  .convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.lineItems
  .discountedLineItemCost
  .convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.lineItems
  .discountedLineItemCost
  .currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.lineItems
  .discountedLineItemCost.value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.lineItems.giftDetails GiftDetails Conditionally Contains gift information about the line item. This container is returned only if the line item was purchased as a gift.
orders.lineItems.giftDetails
  .message
string Always A gift message from the buyer to the gift recipient.
orders.lineItems.giftDetails
  .recipientEmail
string Always The email address of the gift recipient.
orders.lineItems.giftDetails
  .senderName
string Always The name of the buyer to provide to the gift recipient.
orders.lineItems.legacyItemId string Always The eBay-generated legacy listing item ID of the line item. This partially identifies the line item, but does not include the variation, version, or unit quantity.
orders.lineItems
  .legacyVariationId
string Conditionally An eBay-generated string that uniquely identifies the combination of item variations that apply to this line item.
orders.lineItems.lineItemCost Amount Always The selling price of the line item before applying any discounts. The value of this field is calculated by multiplying the single unit price by the value of the quantity field.
orders.lineItems.lineItemCost
  .convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.lineItems.lineItemCost
  .convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.lineItems.lineItemCost
  .currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.lineItems.lineItemCost
  .value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.lineItems
  .lineItemFulfillmentInstructions
LineItemFulfillmentInstructions Always Contains the specifications for processing the fulfillment of the line item, including the handling and delivery timing in support of eBay Guaranteed Delivery. These fields provide guidance for eBay Guaranteed Delivery as well as for non-guaranteed delivery.
orders.lineItems
  .lineItemFulfillmentInstructions
  .guaranteedDelivery
boolean Always A value of true indicates that the seller offered this line item with eBay Guaranteed Delivery, and the buyer purchased the line item with the Guaranteed Delivery option. Guaranteed Delivery is presented to the buyer for a given item listing based on the following criteria:
  • The item is of a type, size, weight, and location defined by the seller as eligible for eBay Guaranteed Delivery in a shipping rate table.
  • The seller is offering the item with eBay Guaranteed Delivery.
  • The buyer is located in a destination region that can be shipped to within the delivery window of at least one shipping service category (e.g. One-day, Expedited, Standard, or Economy) for which eBay Guaranteed Delivery is offered by the seller for the item.
Sellers who opt into handling time Guaranteed Delivery must complete handling for the line item before the time indicated by the shipByDate field. Sellers who opt into door-to-door Guaranteed Delivery must also ensure that the line item is delivered before the time specified by the maxEstimatedDeliveryDate field.
orders.lineItems
  .lineItemFulfillmentInstructions
  .maxEstimatedDeliveryDate
string Always The estimated latest date and time that the buyer can expect to receive the line item. If the value of guaranteedDelivery is true, failure to deliver by this time will be counted in eBay Top Rated Seller calculations for sellers who opted into door-to-door Guaranteed Delivery.

Note: This timestamp is in ISO 8601 format, which uses the 24-hour Universal Coordinated Time (UTC) clock.

Format: YYYY-MM-DDTHH:MM:SS.SSSZ
Example: 2015-08-04T19:09:02.768Z
orders.lineItems
  .lineItemFulfillmentInstructions
  .minEstimatedDeliveryDate
string Always The estimated earliest date and time that the buyer can expect to receive the line item.

Note: This timestamp is in ISO 8601 format, which uses the 24-hour Universal Coordinated Time (UTC) clock.

Format: YYYY-MM-DDTHH:MM:SS.SSSZ
Example: 2015-08-04T19:09:02.768Z
orders.lineItems
  .lineItemFulfillmentInstructions
  .shipByDate
string Always The latest date and time by which this line item must be shipped. If the value of guaranteedDelivery is true, failure to ship by this time will be counted in eBay Top Rated Seller calculations for sellers who opted into handling time Guaranteed Delivery.

Note: This timestamp is in ISO 8601 format, which uses the 24-hour Universal Coordinated Time (UTC) clock.

Format: YYYY-MM-DDTHH:MM:SS.SSSZ
Example: 2015-08-04T19:09:02.768Z
orders.lineItems
  .lineItemFulfillmentStatus
string Always The degree to which fulfillment of the line item is complete.

Applicable values are from LineItemFulfillmentStatusEnum:

FULFILLED
The line item has been processed, packaged, and shipped.

Note: A line item is considered fulfilled as soon as any one unit or component of the line item is assigned to a fulfillment.
NOT_STARTED
The seller has not yet begun packaging the line item.

Code so that your app gracefully handles any future changes to this list.
orders.lineItems.lineItemId string Always The globally unique eBay-generated identifier of the line item.

Note: A single line item can consist of multiple units of a purchased item, and one unit can consist of multiple parts or components. Although these components might be provided by the manufacturer in separate packaging, the seller cannot distribute them among multiple shipping packages. Thus, each line item ID will appear in exactly one fulfillment.
orders.lineItems
  .listingMarketplaceId
string Always The eBay marketplace where the line item was listed.

Applicable values are from MarketplaceIdEnum:See listingMarketplaceId.
Code so that your app gracefully handles any future changes to this list.
orders.lineItems.properties LineItemProperties Always Contains information about the eBay programs, if any, under which the line item was listed.
orders.lineItems.properties
  .buyerProtection
boolean Always A value of true indicates that the line item is covered by eBay's Buyer Protection program.
orders.lineItems.properties
  .fromBestOffer
boolean Always Note: This field is always returned, but its value is not currently reliable (always false). It will become significant in a future release.
orders.lineItems
  .purchaseMarketplaceId
string Always The eBay marketplace where the line item was purchased.

Applicable values are from MarketplaceIdEnum:See purchaseMarketplaceId.
Code so that your app gracefully handles any future changes to this list.
orders.lineItems.quantity integer Always The number of units of the line item in the order. These are represented as a group by a single lineItemId.
orders.lineItems.sku string Conditionally Stock Keeping Unit. This is the seller's inventory reference identifier, which typically applies to a specific variation and version of the item.
orders.lineItems.soldFormat string Always The eBay listing type of the line item.

Applicable values are from SoldFormatEnum:

AUCTION
Chinese auction listing, a single-quantity online auction format. Buyers engage in competitive bidding, although Buy It Now may be offered as long as no bids have been placed. Online auctions are listed on eBay.com, and they are also listed in the seller's eBay Store if the seller is a Store owner.
FIXED_PRICE
A basic fixed-price listing format. Bids do not occur. The quantity of items is one or more. Fixed-price listings are listed on eBay.com, and they are listed in the seller's eBay Store if the seller is a Store owner. Stores' fixed price items are treated as basic fixed-price items.
OTHER
Some other (unidentified) listing format.
SECOND_CHANCE_OFFER
Second chance offer made to a non-winning bidder on an ended listing. A seller can make an offer to a non-winning bidder when either the winning bidder has failed to pay for an item or the seller has a duplicate of the item. A seller can create a Second Chance Offer immediately after a listing ends and up to 60 days after the end of the listing.

Code so that your app gracefully handles any future changes to this list.
orders.lineItems.taxes array of Tax Conditionally Contains a list of taxes applied to the line item, if any.
orders.lineItems.taxes.amount Amount Always The monetary amount of the tax.
orders.lineItems.taxes.amount
  .convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.lineItems.taxes.amount
  .convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.lineItems.taxes.amount
  .currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.lineItems.taxes.amount
  .value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.lineItems.title string Always The seller's listing title for the line item.
orders.lineItems.total Amount Always The net monetary amount of promotions, delivery costs, fees, combined unit prices, refunds, and taxes that apply to the line item.
orders.lineItems.total
  .convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.lineItems.total
  .convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.lineItems.total
  .currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.lineItems.total.value string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.orderFulfillmentStatus string Always The degree to which fulfillment of the order is complete.

Applicable values are from OrderFulfillmentStatus:

FULFILLED
The entire order has been shipped.

Note: When any quantity of a line item is assigned to a fulfillment, that line item is marked as FULFILLED, even if the total quantity of the line item has not yet shipped.
IN_PROGRESS
Applies only to orders with more than one line item. Indicates the seller has begun packaging and shipping line items from the order, but not all line items have been shipped.
NOT_STARTED
The seller has not yet begun packaging any line items from the order.

Code so that your app gracefully handles any future changes to this list.
orders.orderId string Always The unique identifier of the order. This value was originally generated by eBay as a result of the buyer's checkout process; for example, 170009092860-9849164007!140000000544476.

Note: The value of this field is not formatted the same way as the value of the Trading API's OrderId field. Do not attempt to use this field's value in the Trading API.
orders.orderPaymentStatus string Always The current status of all monetary exchanges (payment by buyer and refund to buyer) for the order.

Applicable values are from OrderPaymentStatusEnum:See orderPaymentStatus.
Code so that your app gracefully handles any future changes to this list.
orders.paymentSummary PaymentSummary Always Contains information about the various monetary exchanges for the order.
orders.paymentSummary.payments array of Payment Conditionally Contains a list of payments made for the order, if any.
orders.paymentSummary.payments
  .amount
Amount Always The monetary amount of the order.
orders.paymentSummary.payments
  .amount.convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.paymentSummary.payments
  .amount.convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.paymentSummary.payments
  .amount.currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.paymentSummary.payments
  .amount.value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.paymentSummary.payments
  .paymentDate
string Always The date and time that the payment was received by the seller. This timestamp is in ISO 8601 format, which uses the 24-hour Universal Coordinated Time (UTC) clock.

Format: YYYY-MM-DDTHH:MM:SS.SSSZ
Example: 2015-08-04T19:09:02.768Z
orders.paymentSummary.payments
  .paymentHolds
array of PaymentHold Conditionally Contains information about a hold (if any) placed on some or all of the payment, including the reason why the payment for the order is being held, the expected release date of the funds into the seller's account, the current state of the hold, and if the payment has been released, the actual release date. This container is returned only if a hold exists.
orders.paymentSummary.payments
  .paymentHolds
  .expectedReleaseDate
string Always The date and time that the payment being held is expected to be released to the seller. This timestamp is in ISO 8601 format, which uses the 24-hour Universal Coordinated Time (UTC) clock.

Format: YYYY-MM-DDTHH:MM:SS.SSSZ
Example: 2015-08-04T19:09:02.768Z
orders.paymentSummary.payments
  .paymentHolds.holdAmount
Amount Always The monetary amount of the payment being held.
orders.paymentSummary.payments
  .paymentHolds.holdAmount
  .convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.paymentSummary.payments
  .paymentHolds.holdAmount
  .convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.paymentSummary.payments
  .paymentHolds.holdAmount
  .currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.paymentSummary.payments
  .paymentHolds.holdAmount.value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.paymentSummary.payments
  .paymentHolds.holdReason
string Always The reason that the payment is being held.
orders.paymentSummary.payments
  .paymentHolds.holdState
string Always The current stage or condition of the hold.

Applicable values:
  • HELD
  • HELD_PENDING
  • NOT_HELD
  • RELEASE_CONFIRMED
  • RELEASE_FAILED
  • RELEASE_PENDING
  • RELEASED
orders.paymentSummary.payments
  .paymentHolds.releaseDate
string Conditionally The date and time that the payment being held was actually released to the seller. This timestamp is in ISO 8601 format, which uses the 24-hour Universal Coordinated Time (UTC) clock.

Format: YYYY-MM-DDTHH:MM:SS.SSSZ
Example: 2015-08-04T19:09:02.768Z
orders.paymentSummary.payments
  .paymentHolds
  .sellerActionsToRelease
array of SellerActionsToRelease Always A list of actions the seller can take to release the hold on the payment.
orders.paymentSummary.payments
  .paymentHolds
  .sellerActionsToRelease
  .sellerActionToRelease
string Always An action the seller can take to release the hold.
orders.paymentSummary.payments
  .paymentMethod
string Always The method by which the payment was made.

Applicable values are from PaymentMethodTypeEnum:See paymentMethod.
Code so that your app gracefully handles any future changes to this list.
orders.paymentSummary.payments
  .paymentReferenceId
string Conditionally Returned only if the value of paymentMethod is PAYPAL. This field contains the PayPal-generated transaction identifier.
orders.paymentSummary.payments
  .paymentStatus
string Always The degree of completion of the payment.

Applicable values are from PaymentStatusEnum:

FAILED
The payment has failed.
NOT_APPLICABLE
This value is reserved for internal or future use.
PAID
The payment is complete.
PENDING
The payment is in progress.

Code so that your app gracefully handles any future changes to this list.
orders.paymentSummary.refunds array of OrderRefund Conditionally Contains a list of refunds issued for the order, if any. This does not include line item level refunds.
orders.paymentSummary.refunds
  .amount
Amount Always The monetary amount of the refund.
orders.paymentSummary.refunds
  .amount.convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.paymentSummary.refunds
  .amount.convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.paymentSummary.refunds
  .amount.currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.paymentSummary.refunds
  .amount.value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.paymentSummary.refunds
  .refundDate
string Always The date and time that the refund was issued. This timestamp is in ISO 8601 format, which uses the 24-hour Universal Coordinated Time (UTC) clock.

Format: YYYY-MM-DDTHH:MM:SS.SSSZ
Example: 2015-08-04T19:09:02.768Z
orders.paymentSummary.refunds
  .refundReferenceId
string Always The eBay-generated identifier for the refund
orders.paymentSummary.refunds
  .refundStatus
string Always The degree of completion of a refund being made to the buyer.

Applicable values are from RefundStatusEnum:

FAILED
The refund process has been completed but was not successful.
PENDING
The refund has been initiated but not yet completed.
REFUNDED
The refund has been successfully completed.

Code so that your app gracefully handles any future changes to this list.
orders.paymentSummary
  .totalDueSeller
Amount Always The net monetary amount currently due to the seller for the order. This value changes as charges, payments, and refunds are applied.
orders.paymentSummary
  .totalDueSeller
  .convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.paymentSummary
  .totalDueSeller
  .convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.paymentSummary
  .totalDueSeller.currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.paymentSummary
  .totalDueSeller.value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.pricingSummary PricingSummary Always Contains a summary of costs and charges for the order, including price, adjustment, taxes, and shipping.
orders.pricingSummary
  .adjustment
Amount Conditionally The total amount of any adjustments that were applied to the order. This amount does not include shipping, discounts, fixed fees, or taxes.
orders.pricingSummary
  .adjustment
  .convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.pricingSummary
  .adjustment.convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.pricingSummary
  .adjustment.currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.pricingSummary
  .adjustment.value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.pricingSummary
  .deliveryCost
Amount Always The total cost of delivering the order to the buyer, before any discount.
orders.pricingSummary
  .deliveryCost
  .convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.pricingSummary
  .deliveryCost
  .convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.pricingSummary
  .deliveryCost.currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.pricingSummary
  .deliveryCost.value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.pricingSummary
  .deliveryDiscount
Amount Conditionally The total amount of delivery discounts (including shipping discounts) that apply to the order. This should be a negative real number. This value excludes buyer incentives.
orders.pricingSummary
  .deliveryDiscount
  .convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.pricingSummary
  .deliveryDiscount
  .convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.pricingSummary
  .deliveryDiscount.currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.pricingSummary
  .deliveryDiscount.value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.pricingSummary.fee Amount Conditionally The total amount of any fixed fees applied to the order, such as a recycling fee or a restocking fee.
orders.pricingSummary.fee
  .convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.pricingSummary.fee
  .convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.pricingSummary.fee
  .currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.pricingSummary.fee
  .value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.pricingSummary
  .priceDiscountSubtotal
Amount Conditionally The total amount of all item price discounts (including promotions) that apply to the order and reduce its cost to the buyer. This should be a negative real number. This value excludes buyer incentives.
orders.pricingSummary
  .priceDiscountSubtotal
  .convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.pricingSummary
  .priceDiscountSubtotal
  .convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.pricingSummary
  .priceDiscountSubtotal
  .currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.pricingSummary
  .priceDiscountSubtotal.value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.pricingSummary
  .priceSubtotal
Amount Always The total of the listed prices of all units of all line items in the order, before any discount.
orders.pricingSummary
  .priceSubtotal
  .convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.pricingSummary
  .priceSubtotal
  .convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.pricingSummary
  .priceSubtotal.currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.pricingSummary
  .priceSubtotal.value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.pricingSummary.tax Amount Always The net amount of tax charged as a percentage of the order subtotal. Divide this value by the value of the subtotal field to confirm the approximate tax percentage applied.
orders.pricingSummary.tax
  .convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.pricingSummary.tax
  .convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.pricingSummary.tax
  .currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.pricingSummary.tax
  .value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.pricingSummary.total Amount Always The total cost of the order, including all discounts, adjustments, fees, taxes, and delivery costs.
orders.pricingSummary.total
  .convertedFromCurrency
string Conditionally A three-letter ISO 4217 code that indicates the currency of the amount in the convertedFromValue field. This value is required or returned only if currency conversion/localization is required, and represents the pre-conversion currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
orders.pricingSummary.total
  .convertedFromValue
string Conditionally The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is required or returned only if currency conversion/localization is required. The value field contains the converted amount of this value, in the currency specified by the currency field.
orders.pricingSummary.total
  .currency
string Always A three-letter ISO 4217 code that indicates the currency of the amount in the value field. If currency conversion/localization is required, this is the post-conversion currency of the amount in the value field.

Default: The currency of the authenticated user's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
orders.pricingSummary.total
  .value
string Always The monetary amount, in the currency specified by the currency field. If currency conversion/localization is required, this value is the converted amount, and the convertedFromValue field contains the amount in the original currency.
orders.sellerId string Always The eBay ID of the seller who sold the order.
prev string Conditionally The getOrders call URI for the previous result set. For example, the following URI returns orders 21 thru 30 from the collection of orders:

path/order?limit=10&offset=20

Note: This feature employs a zero-based list, where the first order in the list has an offset of 0.
total integer Always The total number of orders in the collection.

Note: If no orders are found, this field is returned with a value of 0.
warnings array of ErrorDetailV3 Conditionally Contains warnings related to this call request. This is usually empty.
warnings.category string Conditionally The context or source of this error or warning.
warnings.domain string Conditionally The name of the domain containing the service or application. For example, sell is a domain.
warnings.errorId integer Conditionally A positive integer that uniquely identifies the specific error condition that occurred. Your application can use these values as error code identifiers in your customized error-handling algorithms.
warnings.inputRefIds array of string Conditionally A list of one or more specific request elements (if any) associated with the error or warning. The format of these strings depends on the request payload format. For JSON, use JSONPath notation.
warnings.longMessage string Conditionally An expanded version of the message field.

Maximum length: 200 characters
warnings.message string Conditionally A message about the error or warning which is device agnostic and readable by end users and application developers. It explains what the error or warning is, and how to fix it (in a general sense). If applicable, the value is localized to the end user's requested locale.

Maximum length: 50 characters
warnings.outputRefIds array of string Conditionally A list of one or more specific response elements (if any) associated with the error or warning. The format of these strings depends on the request payload format. For JSON, use JSONPath notation.
warnings.parameters array of ErrorParameterV3 Conditionally Contains a list of name/value pairs that provide additional information concerning this error or warning. Each item in the list is an input parameter that contributed to the error or warning condition.
warnings.parameters.name string Conditionally The name of the parameter.
warnings.parameters.value string Conditionally The value of the parameter.
warnings.subdomain string Conditionally The name of the domain's subsystem or subdivision. For example, fulfillment is a subdomain in the sell domain.



Error Codes

Code Domain Category Nature Meaning
30500 API_FULFILLMENT APPLICATION ERROR System error
30700 API_FULFILLMENT REQUEST ERROR Invalid filter name: {fieldname}
30800 API_FULFILLMENT REQUEST ERROR Invalid filter value {fieldvalue} for filter {fieldname}
30810 API_FULFILLMENT REQUEST ERROR Invalid date format
30820 API_FULFILLMENT REQUEST ERROR Start date is missing
30830 API_FULFILLMENT REQUEST ERROR Start date must be within 90 days of end date and current date.
30840 API_FULFILLMENT REQUEST ERROR Start date should be before end date
30850 API_FULFILLMENT REQUEST ERROR Start and end dates can't be in the future
30900 API_FULFILLMENT REQUEST ERROR Exceeded maximum number of order IDs (the current limit is 50)
31000 API_FULFILLMENT REQUEST ERROR Invalid offset: {offsetvalue}
31100 API_FULFILLMENT REQUEST ERROR Invalid limit: {limitvalue}



Samples

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

Sample: Search for Your Orders

Filter all orders by creation date.

Description

This sample retrieves all of a seller's orders created after the specified date.

Input

Use the filter=creationdate parameter to filter by creation date range. You can optionally include limit and offset parameters to paginate the returned collection.

URL format. See also the non-wrapped version of this URL.

GET https://api.ebay.com/sell/fulfillment/v1/order?
   filter=creationdate:%5B2016-09-29T15:05:43.026Z..%5D&
   limit=50&
   offset=0

Output

A successful call returns the OrderSearchPagedCollection container with one or more orders objects.

JSON format.
{
  "href": "http://localhost:8080/sell/fulfillment/v1/order?filter=creationdate:%5B2016-09-29T15:05:43.026Z..%5D&limit=50&offset=0",
  "total": 4,
  "limit": 50,
  "offset": 0,
  "orders": [
    {
      "orderId": "6498414015!260000000562911",
      "creationDate": "2016-09-29T21:50:57.000Z",
      "lastModifiedDate": "2016-09-29T21:53:00.000Z",
      "orderFulfillmentStatus": "NOT_STARTED",
      "orderPaymentStatus": "PENDING",
      "sellerId": "ru_publicapi",
      "buyer": {
        "username": "rus_buyer"
      },
      "buyerCheckoutNotes": "Please show up!",
      "pricingSummary": {
        "priceSubtotal": {
          "value": "99.96",
          "currency": "USD"
        },
        "deliveryCost": {
          "value": "0.0",
          "currency": "USD"
        },
        "tax": {
          "value": "4.5",
          "currency": "USD"
        },
        "total": {
          "value": "94.46",
          "currency": "USD"
        }
      },
      "paymentSummary": {
        "totalDueSeller": {
          "value": "94.46",
          "currency": "USD"
        },
        "refunds": [],
        "payments": [
          {
            "paymentMethod": "PAYPAL",
            "amount": {
              "value": "94.46",
              "currency": "USD"
            },
            "paymentStatus": "PENDING",
            "paymentHolds": [
              {
                "holdReason": "NEW_SELLER",
                "holdAmount": {
                  "value": "94.46",
                  "currency": "USD"
                },
                "holdState": "HELD"
              }
            ]
          }
        ]
      },
      "fulfillmentStartInstructions": [
        {
          "fulfillmentInstructionsType": "SHIP_TO",
          "shippingStep": {
            "shipTo": {
              "fullName": "Dear friend",
              "contactAddress": {
                "addressLine1": "1395 Saratoga Ave Apt 101",
                "city": "San Jose",
                "stateOrProvince": "CA",
                "postalCode": "95129-4453",
                "countryCode": "US"
              },
              "primaryPhone": {
                "phoneNumber": "408 464 2712"
              }
            },
            "shippingServiceCode": "Promotional Shipping (varies)"
          }
        }
      ],
      "fulfillmentHrefs": [],
      "lineItems": [
        {
          "lineItemId": "5575863026",
          "legacyItemId": "350007451113",
          "title": "Hanes T-ShirtMaker Plus Deluxe S00703",
          "lineItemCost": {
            "value": "79.98",
            "currency": "USD"
          },
          "quantity": 2,
          "soldFormat": "FIXED_PRICE",
          "listingMarketplaceId": "EBAY_US",
          "purchaseMarketplaceId": "EBAY_US",
          "lineItemFulfillmentStatus": "NOT_STARTED",
          "total": {
            "value": "83.98",
            "currency": "USD"
          },
          "deliveryCost": {},
          "appliedPromotions": [
            {
              "discountAmount": {
                "value": "0.0",
                "currency": "USD"
              },
              "promotionCode": "5001614705",
              "description": "Free shipping on orders over $50"
            }
          ],
          "taxes": [
            {
              "amount": {
                "value": "4.0",
                "currency": "USD"
              }
            }
          ]
        },
        {
          "lineItemId": "5575864026",
          "legacyItemId": "350007396635",
          "legacyVariationId": "510002164224",
          "title": "Good Quality Shirt",
          "lineItemCost": {
            "value": "19.98",
            "currency": "USD"
          },
          "discountedLineItemCost": {
            "value": "9.98",
            "currency": "USD"
          },
          "quantity": 2,
          "soldFormat": "FIXED_PRICE",
          "listingMarketplaceId": "EBAY_US",
          "purchaseMarketplaceId": "EBAY_US",
          "lineItemFulfillmentStatus": "NOT_STARTED",
          "total": {
            "value": "10.48",
            "currency": "USD"
          },
          "deliveryCost": {},
          "appliedPromotions": [
            {
              "discountAmount": {
                "value": "10.0",
                "currency": "USD"
              },
              "promotionCode": "5001692805",
              "description": "Buy 1, get 1 free"
            },
            {
              "discountAmount": {
                "value": "0.0",
                "currency": "USD"
              },
              "promotionCode": "5001614705",
              "description": "Free shipping on orders over $50"
            }
          ],
          "taxes": [
            {
              "amount": {
                "value": "0.5",
                "currency": "USD"
              }
            }
          ]
        }
      ]
    },
    {
      "orderId": "350007451113-10101916011!6064659011",
      "creationDate": "2016-09-29T21:05:23.000Z",
      "lastModifiedDate": "2016-09-29T21:06:14.000Z",
      "orderFulfillmentStatus": "NOT_STARTED",
      "orderPaymentStatus": "PENDING",
      "sellerId": "ru_publicapi",
      "buyer": {
        "username": "sh_aish20"
      },
      "pricingSummary": {
        "priceSubtotal": {
          "value": "79.98",
          "currency": "USD"
        },
        "deliveryCost": {
          "value": "0.0",
          "currency": "USD"
        },
        "tax": {
          "value": "4.0",
          "currency": "USD"
        },
        "total": {
          "value": "83.98",
          "currency": "USD"
        }
      },
      "paymentSummary": {
        "totalDueSeller": {
          "value": "83.98",
          "currency": "USD"
        },
        "refunds": [],
        "payments": [
          {
            "paymentMethod": "PAYPAL",
            "amount": {
              "value": "83.98",
              "currency": "USD"
            },
            "paymentStatus": "PENDING",
            "paymentHolds": [
              {
                "holdReason": "NEW_SELLER",
                "holdAmount": {
                  "value": "83.98",
                  "currency": "USD"
                },
                "holdState": "NOT_HELD"
              }
            ]
          }
        ]
      },
      "fulfillmentStartInstructions": [
        {
          "fulfillmentInstructionsType": "SHIP_TO",
          "shippingStep": {
            "shipTo": {
              "fullName": "qibus seller",
              "contactAddress": {
                "addressLine1": "2145 Hamilton Avenue",
                "city": "San Jose",
                "stateOrProvince": "CA",
                "postalCode": "95125",
                "countryCode": "US"
              },
              "primaryPhone": {
                "phoneNumber": "408 367 1234"
              }
            },
            "shippingServiceCode": "Promotional Shipping (varies)"
          }
        }
      ],
      "fulfillmentHrefs": [],
      "lineItems": [
        {
          "lineItemId": "6264984011",
          "legacyItemId": "350007451113",
          "title": "Hanes T-ShirtMaker Plus Deluxe S00703",
          "lineItemCost": {
            "value": "79.98",
            "currency": "USD"
          },
          "quantity": 2,
          "soldFormat": "FIXED_PRICE",
          "listingMarketplaceId": "EBAY_US",
          "purchaseMarketplaceId": "EBAY_US",
          "lineItemFulfillmentStatus": "NOT_STARTED",
          "total": {
            "value": "83.98",
            "currency": "USD"
          },
          "deliveryCost": {},
          "appliedPromotions": [
            {
              "discountAmount": {
                "value": "0.0",
                "currency": "USD"
              },
              "promotionCode": "5001614705",
              "description": "Free shipping on orders over $50"
            }
          ],
          "taxes": [
            {
              "amount": {
                "value": "4.0",
                "currency": "USD"
              }
            }
          ]
        }
      ]
    },
    {
      "orderId": "350007451113-10101913011!6064657011",
      "creationDate": "2016-09-29T20:40:49.000Z",
      "lastModifiedDate": "2016-09-29T20:41:13.000Z",
      "orderFulfillmentStatus": "NOT_STARTED",
      "orderPaymentStatus": "PENDING",
      "sellerId": "ru_publicapi",
      "buyer": {
        "username": "sh_aish20"
      },
      "pricingSummary": {
        "priceSubtotal": {
          "value": "79.98",
          "currency": "USD"
        },
        "deliveryCost": {
          "value": "0.0",
          "currency": "USD"
        },
        "tax": {
          "value": "4.0",
          "currency": "USD"
        },
        "total": {
          "value": "83.98",
          "currency": "USD"
        }
      },
      "paymentSummary": {
        "totalDueSeller": {
          "value": "83.98",
          "currency": "USD"
        },
        "refunds": [],
        "payments": [
          {
            "paymentMethod": "PAYPAL",
            "amount": {
              "value": "83.98",
              "currency": "USD"
            },
            "paymentStatus": "PENDING",
            "paymentHolds": [
              {
                "holdReason": "NEW_SELLER",
                "holdAmount": {
                  "value": "83.98",
                  "currency": "USD"
                },
                "holdState": "NOT_HELD"
              }
            ]
          }
        ]
      },
      "fulfillmentStartInstructions": [
        {
          "fulfillmentInstructionsType": "SHIP_TO",
          "shippingStep": {
            "shipTo": {
              "fullName": "qibus seller",
              "contactAddress": {
                "addressLine1": "2145 Hamilton Avenue",
                "city": "San Jose",
                "stateOrProvince": "CA",
                "postalCode": "95125",
                "countryCode": "US"
              },
              "primaryPhone": {
                "phoneNumber": "408 367 1234"
              }
            },
            "shippingServiceCode": "Promotional Shipping (varies)"
          }
        }
      ],
      "fulfillmentHrefs": [],
      "lineItems": [
        {
          "lineItemId": "6264982011",
          "legacyItemId": "350007451113",
          "title": "Hanes T-ShirtMaker Plus Deluxe S00703",
          "lineItemCost": {
            "value": "79.98",
            "currency": "USD"
          },
          "quantity": 2,
          "soldFormat": "FIXED_PRICE",
          "listingMarketplaceId": "EBAY_US",
          "purchaseMarketplaceId": "EBAY_US",
          "lineItemFulfillmentStatus": "NOT_STARTED",
          "total": {
            "value": "83.98",
            "currency": "USD"
          },
          "deliveryCost": {},
          "appliedPromotions": [
            {
              "discountAmount": {
                "value": "0.0",
                "currency": "USD"
              },
              "promotionCode": "5001614705",
              "description": "Free shipping on orders over $50"
            }
          ],
          "taxes": [
            {
              "amount": {
                "value": "4.0",
                "currency": "USD"
              }
            }
          ]
        }
      ]
    },
    {
      "orderId": "350007451113-10101903011!6064656011",
      "creationDate": "2016-09-29T20:17:55.000Z",
      "lastModifiedDate": "2016-09-29T20:17:59.000Z",
      "orderFulfillmentStatus": "NOT_STARTED",
      "orderPaymentStatus": "PENDING",
      "sellerId": "ru_publicapi",
      "buyer": {
        "username": "sh_aish20"
      },
      "pricingSummary": {
        "priceSubtotal": {
          "value": "79.98",
          "currency": "USD"
        },
        "deliveryCost": {
          "value": "0.0",
          "currency": "USD"
        },
        "tax": {
          "value": "4.0",
          "currency": "USD"
        },
        "total": {
          "value": "83.98",
          "currency": "USD"
        }
      },
      "paymentSummary": {
        "totalDueSeller": {
          "value": "83.98",
          "currency": "USD"
        },
        "refunds": [],
        "payments": [
          {
            "paymentMethod": "PAYPAL",
            "amount": {
              "value": "83.98",
              "currency": "USD"
            },
            "paymentStatus": "PENDING",
            "paymentHolds": [
              {
                "holdReason": "NEW_SELLER",
                "holdAmount": {
                  "value": "83.98",
                  "currency": "USD"
                },
                "holdState": "NOT_HELD"
              }
            ]
          }
        ]
      },
      "fulfillmentStartInstructions": [
        {
          "fulfillmentInstructionsType": "SHIP_TO",
          "shippingStep": {
            "shipTo": {
              "fullName": "qibus seller",
              "contactAddress": {
                "addressLine1": "2145 Hamilton Avenue",
                "city": "San Jose",
                "stateOrProvince": "CA",
                "postalCode": "95125",
                "countryCode": "US"
              },
              "primaryPhone": {
                "phoneNumber": "408 367 1234"
              }
            },
            "shippingServiceCode": "Promotional Shipping (varies)"
          }
        }
      ],
      "fulfillmentHrefs": [],
      "lineItems": [
        {
          "lineItemId": "6264981011",
          "legacyItemId": "350007451113",
          "title": "Hanes T-ShirtMaker Plus Deluxe S00703",
          "lineItemCost": {
            "value": "79.98",
            "currency": "USD"
          },
          "quantity": 2,
          "soldFormat": "FIXED_PRICE",
          "listingMarketplaceId": "EBAY_US",
          "purchaseMarketplaceId": "EBAY_US",
          "lineItemFulfillmentStatus": "NOT_STARTED",
          "total": {
            "value": "83.98",
            "currency": "USD"
          },
          "deliveryCost": {},
          "appliedPromotions": [
            {
              "discountAmount": {
                "value": "0.0",
                "currency": "USD"
              },
              "promotionCode": "5001614705",
              "description": "Free shipping on orders over $50"
            }
          ],
          "taxes": [
            {
              "amount": {
                "value": "4.0",
                "currency": "USD"
              }
            }
          ]
        }
      ]
    }
  ]
}



Change History

Change Date Description
1.2.0
2017-06-12
  • lineItemFulfillmentInstructions (added): Contains the specifications for processing the fulfillment of a line item, including the handling window and the delivery window. These fields provide guidance for eBay Guaranteed Delivery as well as for non-guaranteed delivery.
1.1.0
2017-01-25
  • Error (added): New error code: 30850 - Start and end dates can't be in the future.
1.0.0
2016-10-19
  • Call (added): New call.