The Sell Feed API lets sellers upload and download feed files and reports, and create schedules. Both upload and download feed files are processed asynchronously by eBay. The status of all upload and download tasks are tracked with a unique 'task ID'. Each report can be customized with date ranges and other filter criteria.

Technical overview

This API contains the following resources:

  • order_task - Create an order download task with filter criteria related to order and retrieve the status and details of a specific order task or a group of order tasks.
  • inventory_task - Create an inventory upload or download task with filter criteria related to inventory, and retrieve the status and details of a specific inventory task or a group of inventory tasks.
  • schedule - Create a schedule for the feed API resources. A schedule generates reports periodically for a specified feedType. Schedules are based off templates that define the parameters used such as feed type.
  • task - Create an upload or download task without filter criteria and retrieve the status and details of a specific task or a group of tasks. Whether it is a download or upload task depends on the feed_type specified.
  • customer_service_metric_task - Create a customer service metrics download task with filter criteria. This task can also retrieve the status and details of a specific customer service metrics task or group of tasks.

Business use cases

The initial release of this API supports the following use cases.

Download an order report

You can generate and download an order report. For details, see Downloading an order report.

Acknowledge fulfilled orders with an Order Ack upload file

You can acknowledge orders you have received and are processing or fulfilling by uploading an order acknowledgment file. After this file has been processed, only the unacknowledged orders will be returned in the next order report. For details, see Submitting an order acknowledgment file.

Download Customer Service Metrics reports

Through the customer_service_metric_task methods, you can create a report download task and retrieve a list of transactions that affect performance for given evaluation type, service metric type. Other filters can also be specified. You can search the returned list of transactions by applying a data range filter for the request creation date. For details, see Customer Service Metrics Report.

Create, customize, and manage feed tasks

You can use the getTask, getOrderTask, and getInventoryTask methods to retrieve the details of a specific task by specifying the task ID. You can use the getTasks, getOrderTasks, and getInventoryTasks methods to retrieve the details of a group of tasks by specifying the feed_type. You can control the tasks returned by using URI filters, such as date_range or look_back_days.

You can use the getInputFile method to download the input file that is associated with a specific task. Make sure to specify the task_id that was used by the uploadFile method. For details, see Working with Order Feeds.

Create schedules

Through the schedule methods, you can create a schedule, which is a subscription to a specified schedule template. A schedule returns a report for the feed_type specified by the template. When creating the schedule, specify the template with the feed type and any other parameters needed for your schedule. You can also specify a preferred trigger hour, day of the week, or day of the month.

Requirements and restrictions

The following are the requirements and restrictions for the Sell Feed API.

File retention

The number of days that files are retained (and available) depends on the feed type. See the following table for specifics.

File availability

LMS feedType *

Retention (availability in days)

Task request

Task response **

LMS_ORDER_REPORT

Not applicable

30

LMS_ACTIVE_INVENTORY_REPORT

Not applicable

90

All other LMS feedTypes

3

90

* See Available feed types for a complete list of upload and download feed types.

** Includes either the report or the error response for download tasks, or the response payload for upload tasks.

Note: For task requests and responses:

Scope restrictions

The following table lists the Sell Feed API scopes and use cases they support.

Scope

Use Case
https://api.ebay.com/oauth/api_scope/sell.inventory Active Inventory Report
https://api.ebay.com/oauth/api_scope/sell.fulfillment LMS Order Ack and Order Report
https://api.ebay.com/oauth/api_scope/sell.marketing For future use
https://api.ebay.com/oauth/api_scope/commerce.catalog.readonly For future use
https://api.ebay.com/oauth/api_scope/sell.analytics.readonly Customer Service Metrics Report