Okapi Okapi

eBay API POST /post-order/v2/return/{id}/mark_as_shipped endpoint removal

Stopped workingSubscribe to eBay APIShare

On January 20, 2026, the endpoint POST /post-order/v2/return/{id}/mark_as_shipped was decommissioned and removed from the documentation. Calls made to this endpoint fail. Any integration relying on this specific call to mark return shipments is affected.


Calls it hits

  • POST /post-order/v2/return/{id}/mark_as_shipped

What to use instead of these calls

eBay names no replacement for this Post-Order call. You must decide whether to handle the step directly on eBay or drop the functionality from your code entirely.

eBay removed the call without a replacement: what the code did with it is a product decision.

In eBay API's words

The following deprecated calls were decommissioned and removed from the documentation: - Cancel Return Request - Check Return Eligibility - Check Shipping Label Print Eligibility - Create Return Draft - Delete Return Request Draft File - Get Return Draft - Get Return Request Draft Files - Initiate Return Shipping Label - Mark Return Refund Received - Mark Return Refund Sent - Mark Return Shipped

eBay API, Announcement

Facts

API
eBay API api.ebay.com
Kind
Endpoint removal
Takes effect
January 20, 2026
Calls after that day
Fail
Source
Announcement
Last updated
Verified
, against eBay API's own pages

Questions

When does this change take effect?

Calls to POST /post-order/v2/return/{id}/mark_as_shipped on eBay API stopped working on January 20, 2026.

What happens to calls after January 20, 2026?

They have failed since January 20, 2026.

How do I find the calls this hits in my code?

Okapi reads your repository, finds the calls this change hits and opens a pull request with the fix. It never commits to your branches: every change comes as a pull request you review.


More from eBay API 10

  1. /post-order/v2/return/draft*Endpoint removal Stopped working
  2. GET /post-order/v2/return/{id}/check_label_print_eligibilityEndpoint removal Stopped working
  3. POST /post-order/v2/return/{id}/cancelEndpoint removal Stopped working
  4. POST /post-order/v2/return/{id}/initiate_shipping_labelEndpoint removal Stopped working
  5. POST /post-order/v2/return/{id}/mark_refund_receivedEndpoint removal Stopped working
  6. POST /post-order/v2/return/{id}/mark_refund_sentEndpoint removal Stopped working
  7. POST /post-order/v2/return/{id}/send_shipping_labelEndpoint removal Stopped working
  8. POST /post-order/v2/return/{id}/void_shipping_labelEndpoint removal Stopped working
  9. POST /post-order/v2/return/check_eligibilityEndpoint removal Stopped working
  10. PUT /post-order/v2/return/{id}/update_trackingEndpoint removal Stopped working

You fixed this one by hand.

Okapi opens the pull request with the fix before the next breaking change reaches your code.

Add to GitHub

Get notifications

Subscribe to eBay API

Hear about each breaking change eBay API announces, in your feed reader, calendar or Slack.

1What to follow

Provider
  • eBay API

2Where to get it

/breaking-changes/feed.xml

Paste it into Feedly, Inoreader, NetNewsWire or any reader. New changes show up as they're announced.