Call Index

This API Reference describes the elements and attributes for each call in the Post-Order API.

For details on the Post-Order API call flows, please see the Features Guide section Resolving Order Issues.

Call		Summary
CANCELLATION
Approve Cancellation `POST /post-order/v2/cancellation/{cancelId}/approve`	Seller approves a cancellation request	view
Check Cancellation Eligibility `POST /post-order/v2/cancellation/check_eligibility`	Verify if an order is eligible to be cancelled	view
Confirm Cancellation Refund `POST /post-order/v2/cancellation/{cancelId}/confirm`	Note: This call has been deprecated and will be decommissioned on March 2, 2026. Buyer confirms the refund from a cancelled order was received	view
Create Cancellation Request `POST /post-order/v2/cancellation`	Request or perform an order cancellation	view
Get Cancellation `GET /post-order/v2/cancellation/{cancelId}`	Retrieve the details of an order cancellation request	view
Reject Cancellation `POST /post-order/v2/cancellation/{cancelId}/reject`	Seller rejects a cancellation request	view
Search Cancellations `GET /post-order/v2/cancellation/search`	Search for cancellations	view
CASE MANAGEMENT
Appeal Case Decision `POST /post-order/v2/casemanagement/{caseId}/appeal`	Buyer or seller appeals a case decision	view
Close Case `POST /post-order/v2/casemanagement/{caseId}/close`	Note: This call has been deprecated and will be decommissioned on March 2, 2026. Buyer closes a case	view
Get Case `GET /post-order/v2/casemanagement/{caseId}`	Retrieve the details related to a specific case	view
Issue Case Refund `POST /post-order/v2/casemanagement/{caseId}/issue_refund`	Note: This call has been deprecated and will be decommissioned on March 2, 2026. Seller issues a refund for a case	view
Provide Case Shipment Info `POST /post-order/v2/casemanagement/{caseId}/provide_shipment_info`	Note: This call has been deprecated and will be decommissioned on March 2, 2026. Provides shipment tracking information for an item that is involved in case	view
Provides Return Address `POST /post-order/v2/casemanagement/{caseId}/provide_return_address`	Note: This call has been deprecated and will be decommissioned on March 2, 2026. Seller provides a return address to the buyer	view
Search Cases `GET /post-order/v2/casemanagement/search`	This method is used to search for cases using multiple filter types.	view
INQUIRY
Check Inquiry Eligibility `POST /post-order/v2/inquiry/check_eligibility`	Note: This call has been deprecated and will be decommissioned on February 2, 2026. Check if a buyer is eligible to open an inquiry on an order line item	view
Close Inquiry `POST /post-order/v2/inquiry/{inquiryId}/close`	Note: This call has been deprecated and will be decommissioned on March 16, 2026. Close an inquiry for the buyer	view
Confirm Inquiry Refund `POST /post-order/v2/inquiry/{inquiryId}/confirm_refund`	Note: This call has been deprecated and will be decommissioned on March 16, 2026. Buyer confirms the refund was received for an order line item that was part of an INR inquiry	view
Create Inquiry `POST /post-order/v2/inquiry`	Note: This call has been deprecated and will be decommissioned on March 16, 2026. Create an inquiry for the buyer	view
Escalate Inquiry `POST /post-order/v2/inquiry/{inquiryId}/escalate`	Escalate an inquiry to an INR case	view
Get Inquiry `GET /post-order/v2/inquiry/{inquiryId}`	Retrieve the history and details related to a specific inquiry	view
Issue Inquiry Refund `POST /post-order/v2/inquiry/{inquiryId}/issue_refund`	Issue a refund for a line item that is part of an INR inquiry	view
Provide Inquiry Refund Info `POST /post-order/v2/inquiry/{inquiryId}/provide_refund_info`	Note: This call has been deprecated and will be decommissioned on March 16, 2026. Provide refund information about an inquiry to the buyer	view
Provide Inquiry Shipment Info `POST /post-order/v2/inquiry/{inquiryId}/provide_shipment_info`	Provide shipment information for an inquiry	view
Search Inquiries `GET /post-order/v2/inquiry/search`	This method is used to search for inquiries using multiple filter types	view
Send Inquiry Message `POST /post-order/v2/inquiry/{inquiryId}/send_message`	Contact the buyer or seller about an inquiry	view
RETURN
Add Shipping Label Info `POST /post-order/v2/return/{returnId}/add_shipping_label`	Create or update a return shipping label provided by the seller	view
Cancel Return Request `POST /post-order/v2/return/{returnId}/cancel`	Note: This call has been deprecated and will be decommissioned on January 20, 2026. Cancel a return request	view
Check Return Eligibility `POST /post-order/v2/return/check_eligibility`	Note: This call has been deprecated and will be decommissioned on January 20, 2026. Check to see if an item is eligible for a return	view
Check Shipping Label Print Eligibility `GET /post-order/v2/return/{returnId}/check_label_print_eligibility`	Note: This call has been deprecated and will be decommissioned on January 20, 2026. Validate the eligibility of a return shipping label	view
Create Return Draft `POST /post-order/v2/return/draft`	Note: This call has been deprecated and will be decommissioned on January 20, 2026. Create a return request draft	view
Create Return Request `POST /post-order/v2/return`	Request a return for an item	view
Delete Return Request Draft File `DELETE /post-order/v2/return/draft/{draftId}/file/{fileId}`	Note: This call has been deprecated and will be decommissioned on January 20, 2026. Delete a file associated with a return request draft	view
Escalate Return `POST /post-order/v2/return/{returnId}/escalate`	Escalate a return request into a case	view
Get Return `GET /post-order/v2/return/{returnId}`	Retrieve the details of a specific return request	view
Get Return Draft `GET /post-order/v2/return/draft/{draftId}`	Note: This call has been deprecated and will be decommissioned on January 20, 2026. Retrieve a return request draft	view
Get Return Estimate `POST /post-order/v2/return/estimate`	Note: This call has been deprecated and will be decommissioned on February 2, 2026. This method is used on behalf of a buyer to retrieve the estimated refund amount and return shipping costs associated with returning an item.	view
Get Return Files `GET /post-order/v2/return/{returnId}/files`	Retrieve the files associated with a return request	view
Get Return Preferences `GET /post-order/v2/return/preference`	Retrieve seller's return preferences	view
Get Return Request Draft Files `GET /post-order/v2/return/draft/{draftId}/files`	Note: This call has been deprecated and will be decommissioned on January 20, 2026. Retrieve the files associated with a return request draft	view
Get Return Shipping Label `GET /post-order/v2/return/{returnId}/get_shipping_label`	Note: This call has been deprecated and will be decommissioned on February 2, 2026. Retrieve the data for a return shipping label	view
Get Shipment Tracking Info `GET /post-order/v2/return/{returnId}/tracking`	Retrieve shipment tracking activity for a return item	view
Initiate Return Shipping Label `POST /post-order/v2/return/{returnId}/initiate_shipping_label`	Note: This call has been deprecated and will be decommissioned on January 20, 2026. Initiate an eBay return shipping label	view
Issue Return Refund `POST /post-order/v2/return/{returnId}/issue_refund`	Issue a refund for a returned item	view
Mark Return Received `POST /post-order/v2/return/{returnId}/mark_as_received`	Mark a return item or replacemen item as received	view
Mark Return Refund Received `POST /post-order/v2/return/{returnId}/mark_refund_received`	Note: This call has been deprecated and will be decommissioned on January 20, 2026. Mark a refund as received	view
Mark Return Refund Sent `POST /post-order/v2/return/{returnId}/mark_refund_sent`	Note: This call has been deprecated and will be decommissioned on January 20, 2026. Notify the buyer that a refund has been issued	view
Mark Return Shipped `POST /post-order/v2/return/{returnId}/mark_as_shipped`	Note: This call has been deprecated and will be decommissioned on January 20, 2026. Mark a return item as shipped	view
Process Return Request `POST /post-order/v2/return/{returnId}/decide`	Seller or buyer perform an action against a return request	view
Search Returns `GET /post-order/v2/return/search`	Search for return requests based on filter criteria	view
Send Return Message `POST /post-order/v2/return/{returnId}/send_message`	Send a message to order partner regarding a return request	view
Send Return Shipping Label `POST /post-order/v2/return/{returnId}/send_shipping_label`	Note: This call has been deprecated and will be decommissioned on January 20, 2026. Send a shipping label to an email address	view
Set Return Preferences `POST /post-order/v2/return/preference`	Set seller's return preferences	view
Submit Return File `POST /post-order/v2/return/{returnId}/file/submit`	Note: This call has been deprecated and will be decommissioned on February 2, 2026. Activate the files associated with a return request	view
Update Return Draft `PUT /post-order/v2/return/draft/{draftId}`	Note: This call has been deprecated and will be decommissioned on January 20, 2026. Update an existing return request draft	view
Update Shipment Tracking Info `PUT /post-order/v2/return/{returnId}/update_tracking`	Note: This call has been deprecated and will be decommissioned on January 20, 2026. Update shipment tracking information for a return item	view
Upload Return File `POST /post-order/v2/return/{returnId}/file/upload`	Upload the files relating to a return request	view
Upload Return Request Draft File `POST /post-order/v2/return/draft/{draftId}/file/upload`	Note: This call has been deprecated and will be decommissioned on January 20, 2026. Upload the files relating to a return request draft	view
Void Shipping Label `POST /post-order/v2/return/{returnId}/void_shipping_label`	Note: This call has been deprecated and will be decommissioned on January 20, 2026. Void a shipping label	view