New Inventory and Shipping Endpoints Now Available

[openapi-support[bot]]

New Inventory and Shipping Endpoints Now Available

We're excited to announce two new Etsy Open API endpoints for retrieving Inventory and Shipping data from Listings.

New Endpoints

The following endpoints are now available:

• getListingsShippingByListingIds
• getListingsInventoryByListingIds

These endpoints return the same Inventory and Shipping payloads currently available through the Listings API.

Upcoming Change

These endpoints replace retrieving Inventory and Shipping data through the following query parameters on the Listings endpoints:

• ?includes=Inventory
• ?includes=Shipping

on:

• getListing
• getListingsByListingIds

The Inventory and Shipping payloads themselves are not changing. Only the method used to retrieve them is changing.

Beginning July 29, 2026, requests using ?includes=Inventory or ?includes=Shipping on the affected Listings endpoints will return a 400 Bad Request response.

If your application currently relies on these ?includes parameters, we recommend updating your integration to use the new dedicated endpoints as soon as possible.

Response Format

The new endpoints return the same Inventory and Shipping response payloads currently available through the ?includes associations, so migrating should only require changing which endpoint your application calls.

Learn More

For endpoint documentation and request/response examples, see the API Reference:

• getListingsShippingByListingIds
• getListingsInventoryByListingIds

For any questions, please reach out to developer@etsy.com.

[alexh-swdev]

Is getListingsByShop also affected?

/Edit: I don't see your mentioned endpoints marked as deprecated in the API reference?

[dobromir-peev]

Hi, Is there any other endpoint which can provide shipping information like this endpoint https://developers.etsy.com/documentation/reference#operation/getListing which provides with includes=Shipping. I need for public listings to get shipping information.

[developer-ecomzenith]

try this endpoint
https://developer.etsy.com/documentation/reference/#operation/getListingsShippingByListingIds

[dobromir-peev]

Hi, @developer-ecomzenith,
This endpoint doesn't return shipping information about listings that aren't owned. I need to get the shipping profile for every listing, whether it's owned or not. Currently, this endpoint https://developer.etsy.com/documentation/reference/#operation/getListingsShippingByListingIds returns null for shipping_profile if the listing is not owned. So can I get it in any other way?