Get Return Draft
GET /post-order/v2/return/draft/{draftId}
This method retrieves details of a specific return request draft.
Output Samples Change History |
Input
See also Samples.
Resource URI (production)
GET https://api.ebay.com/post-order/v2/return/draft/{draftId}
URI parameters
Parameter | Type | Required? | Meaning |
---|---|---|---|
draftId | string | Required | The unique eBay-assigned ID of the return request draft. This identifier is included as part of the call URI and identifies the return request draft to retrieve. |
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.
Authorization
This call uses standard authorization tokens. See Making a Call for details.
Payload model
This call has no request payload.
Input Samples Change History |
Output
See also Samples.
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.
Supported response formats: application/json, application/xml
For more information:
- See GetReturnCreationSessionResponse for a description of the response structure
- See the following table for descriptions of each of the data elements returned
- See the Samples for an example of the response format
{ /* GetReturnCreationSessionResponse */ "returnRequest": { /* ReturnRequestType */ "carrier": string, "comments": { /* Text */ "content": string, "language": string, "translatedFromContent": string, "translatedFromLanguage": string }, "itemId": string, "reason": string, "requestType": string, "returnQuantity": integer, "transactionId": string, "type": string } }
Response field descriptions
Output Container/Field | Type | Occurrence | Meaning |
---|---|---|---|
returnRequest | ReturnRequestType | Always | This container provide details about the return request draft, including the order line item (and quantity) that is being returned and the reason for the return. |
returnRequest.carrier | string | Conditionally |
This enumeration value indicates the shipping carrier that will be used to ship the return item. The supported enumeration values representing shipping carriers are defined in the ShippingCarrierEnum type definition. Applicable values: See ShippingCarrierEnum |
returnRequest.comments | Text | Conditionally | This container is used if the buyer wants to add a note or explanation about why the return request was created. |
returnRequest.comments.content | string | Conditionally | This field displays the actual textual content in the language specified in the language field. This field is always used for containers using the Text type. |
returnRequest.comments .language |
string | Conditionally |
This two-letter code indicates the language used to display the content in the content field. The language will default to the language used on the eBay site if a specific language is not specified through the Accept-Language HTTP header. This field is always used for containers using the Text type. The full list of language enumeration values are defined in the LanguageEnum type definition. Applicable values: See LanguageEnum |
returnRequest.comments .translatedFromContent |
string | Conditionally | If language translation/localization is required, this field displays the actual textual content in the language specified in the translatedFromLanguage field. If language translation was not required, this field is not applicable. |
returnRequest.comments .translatedFromLanguage |
string | Conditionally |
If language translation/localization is required, this two-letter code indicates the language used to display the content in the translatedFromContent field. If language translation was not required, this field is not applicable. The full list of language enumeration values are defined in the LanguageEnum type definition. Applicable values: See LanguageEnum |
returnRequest.itemId | string | Conditionally | The unique identifier of the eBay listing where the item was purchased. This field is used in conjunction with the transactionId field to identify a line item within an order. |
returnRequest.reason | string | Conditionally |
This enumerated value indicates the buyer's reason for creating a return request or draft. The supported enumeration values representing valid return reasons are defined in the ReturnReasonEnum type definition. Applicable values: See ReturnReasonEnum |
returnRequest.requestType | string | Conditionally |
This enumeration value indicates if the return request is an actual return request or a return draft.
Applicable values are from RequestTypeEnum: Code so that your app gracefully handles any future changes to this list. |
returnRequest.returnQuantity | integer | Conditionally |
This integer value indicates the quantity of the line item being returned. This number is generally 1 , unless the buyer bought multiple quantity of the item in a multiple-quantity, fixed-price listing. This value defaults to 1 if this field is omitted when a return is created.
|
returnRequest.transactionId | string | Conditionally | The unique identifier for the purchase of a item. This value is created right when the buyer is committed to buying the item, whether that buyer uses a 'Buy it Now' capability, is the winning bidder of an auction, or the buyer's Best Offer is accepted by the seller. This field is used in conjunction with the itemId field to identify a line item within an order. |
returnRequest.type | string | Conditionally |
This enumeration value indicates the buyer's desired outcome. Note: Currently, MONEY_BACK
Applicable values are from ReturnTypeEnum: Note: This value is deprecated. Note: This value is not currently supported. Note: This value is deprecated. Code so that your app gracefully handles any future changes to this list. |
Input Output Change History |
Samples
New to making API calls? Please see Making a Call.
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.
Retrieve a return draft.
Description
A buyer wants to retrieve the basic details of a specific return draft, including the order line item associated with the return draft and the reason given for wanting to return the item.
Input
The draftId value is passed in to the call as a path parameter. There is no request payload.
URL format. See also the non-wrapped version of this URL. GET https://api.ebay.com/post-order/v2/return/draft/5*******0
Output
Use the itemId and transactionId fields identify the order line item in the return draft. According to the reason value, the buyer is returning the item because he/she no longer needs the item, and the buyer is looking for a refund, as opposed to a replacement item.
JSON format.
{
"returnRequest":
{
"itemId": "3**********4",
"transactionId": "8********4",
"returnQuantity": "1",
"reason": "NO_LONGER_NEED_ITEM",
"type": "MONEY_BACK",
"carrier": "USPS",
"comments":
{
"content": "I accidentally purchased the same product twice"
}
}
}
Input Output Samples |
Change History
Change Date | Description |
---|