Skip to main content
Guides
Release Notes
Request Headers
Notification Topics
Response Status and Error Codes

Inventory Mapping API

Release VersionRelease DateDescription of Release
1.0.02025-08-11
The initial version of the Inventory Mapping API
Show more

Charity API

Release VersionRelease DateDescription of Release
1.2.12023-01-16

The getCharityOrgByLegacyId method has been deprecated and removed.

1.2.02020-08-14
Added postal code and country to the Address container of the Charity API.
1.1.02020-05-15
Added a new getCharityOrgByLegacyId resource method.
1.0.02020-04-20
The initial version of the Charity API.
Show more

Catalog API

Release VersionRelease DateDescription of Release
1.5.22024-08-27

Added support for the Spanish and French marketplaces

1.5.22025-11-13

Added a new field, compatibilityCount, to the getProduct response

1.5.12024-06-18

Added support for the Italian marketplace

1.5.02020-05-18

Two product metadata methods decommissioned

1.4.02020-04-01

Three change request methods decommissioned

1.3.12019-07-11

Three change request methods deprecated

1.3.02018-07-31

New fields returned in product metadata methods

1.2.02018-05-24

Two new calls were added to the Catalog API

1.1.02018-04-15

Three new calls were added to the Catalog API

1.0.02018-02-15

The initial version of the Catalog API

Show more

Identity API

Release VersionRelease DateDescription of Release
1.1.02019-10-24

Moved the status field to its own scope

1.0.02019-06-24
The initial version of the Identity API
Show more

Negotiation API

Release VersionRelease DateDescription of Release
1.1.22025-10-29

Removed supported for 2 day offerDuration for US and UK marketplaces

1.1.12025-01-16

Updates the default offer duration time on the US and UK marketplaces to 4 days

1.1.02019-10-11

Added support for the Canadian marketplace (EBAY_CA).

1.0.02019-09-25

The initial version of the Negotiation API

Show more

Leads API

Release VersionRelease DateDescription of Release
1.0.02025-12-15

Initial release of Leads API

Show more

Finances API

Release VersionRelease DateDescription of Release
1.19.02026-03-16
Added the ability to return sets of earnings insights through the order_earnings resource
1.18.02026-01-27
Added ability to retrieve filtered billing activities through the billing_activity resource.
1.17.32025-05-23
New 5-year constraint and 36-month date range constraint added for all transactions and seller payouts.
1.17.22024-04-08
A new enumeration value has been added to FeeTypeEnum.
1.17.12024-03-12
A new purchase transaction type is now supported for the getTransactions and getTransactionSummary methods.
1.17.02023-11-15

The following changes are included in the release.

  • Added new field donations in type OrderLineItem.
  • Added new enum value CHARITY_DONATION in FeeTypeEnum.
  • Added new types Tax and TaxTypeEnum and a new field taxes in type Transaction.
1.16.02023-08-28
Added support for split payouts for sellers in mainland China.
1.15.02022-11-10
Support has been added for the withholding of income tax at the State and Province level.
1.14.12022-10-19
EU and UK Payments regulations now require Digital Signatures to be included in HTTP payloads for all Finances API methods.
1.14.02022-10-17
This release adds support for eBay Seller Capital loan repayments and the reporting of taxes collected by eBay at the account level.
Show more

Message API

Release VersionRelease DateDescription of Release
1.0.02025-11-03

Initial release of version 1.0.0

Show more

Fulfillment API

Release VersionRelease DateDescription of Release
1.19.152022-09-19

Added support for eBay International Shipping.

1.19.142022-06-16

Added and updated error codes for the uploadEvidenceFile method.

1.19.132022-06-16

Effective July 1, 2022, eBay is required to collect and remit sales tax in Canada; the following changes have been incorporated in this release:

  • Added support to collect and remit (C&R) Canada sales tax
  • Sales tax is now being collected for Digitally Delivered Goods (DDG)
1.19.122022-05-31

Two error codes were added and three error codes were updated for the issueRefund method.

1.19.112022-05-05

Added new Schema to support eBay's Vault program.

1.19.102021-10-18

Changed the limit maximum value to 200 for getOrders method.

1.19.92021-08-18

Added two enumeration values (APPEAL_DENIED and APPEAL_GRANTED) for the ActivityEnum type.

1.19.82021-07-26

Added a new enumeration value (DISPUTE_REVERSED) for the ActivityEnum type.

1.19.72021-06-21

Updated description of Amount for the getOrder and getOrders methods; added VAT support to be collected in EU countries starting on July 1, 2021.

1.19.62021-06-08

Added new Schema to support the return of fulfillment program information.

1.19.52021-06-01

Added new Schema to support the return of VAT identifiers.

1.19.42021-05-10

Added new error code to the issueRefund method for seller-initiated refunds.

1.19.32021-01-15

Added a new enumeration value (DISPUTE_REOPENED) for the ActivityEnum type.

1.19.22020-11-09

Updated the getOrder and getOrders methods to return a cumulative total of fees accrued that are deducted from seller payouts.

1.19.12020-10-21

Added a new enumeration value for the PostSaleAuthenticationProgram type.

1.19.02020-09-28

Added a tax address container (taxAddress) that consists of address information that can be used by sellers for tax purposes and affects the getOrder and getOrders methods.

1.18.02020-09-14

Added new schema to getPaymentDispute method to provide details on monetary transactions that occur after payment disputes are resolved. As part of this project, the getPaymentDispute method was also updated to show currency conversion values for cross-border trade orders.

1.17.02020-09-01

Updated api type names, added new BOPIS seller/merchant evidence type (PROOF_OF_PICKUP) for buyer to pick up items directly from the store, and corrections to documentation.

1.16.02020-08-24

Added support for the Authenticity Guarantee service program to the getOrder and getOrders methods. The Authenticity Guarantee service program informs the seller of the authentication status of an order as it passes through the item authentication process.

1.15.02020-07-09

Updated getOrder and getOrders methods to return selling fees that are deducted from seller payouts. Also, added a new PaymentMethodTypeEnum enumeration value.

1.14.02020-06-19

Added support for providing optional breakdown of taxes and fees to getOrder and getOrders methods.

1.13.02020-05-05

Five new payment method enums added to handle eBay managed payments and offline payment methods.

1.12.02020-03-31

Five new payment dispute methods for sellers opted in to eBay managed payments.

1.11.12020-01-17

New error code for the issueRefund method.

1.11.02019-10-30

Four new payment dispute methods for sellers opted in to eBay managed payments.

1.10.12019-10-24

Logic change for eBay 'Collect and Remit' taxes and two new error codes for the issueRefund method.

1.10.02019-08-08

getOrder and getOrders now return refundId values created with issueRefund method.

1.9.02019-06-24

New issueRefund method for sellers opted in to eBay managed payments.

1.8.02019-02-11

getOrder and getOrders now support In-Store Pickup orders.

1.7.02019-01-24

New field added to support Selling Manager order reference number

1.6.02018-10-09

New field to support items sold through ad campaign

1.5.02018-07-12

New types and fields to support AU import tax

1.4.02018-05-30

New fields to support legacy orders and email

1.3.02017-10-11

New field to support the Global Shipping Program; availability of OpenAPI specification

1.2.02017-06-12

New fields to support line item delivery timing

1.1.02017-01-25
Minor update
1.0.02017-10-19

Initial release of Version 1.0.0

Show more

Feed API

Release VersionRelease DateDescription of Release
1.3.12022-10-27

This API release aligns inventory_task reference documentation with existing filter criteria functionality and adds an error to the uploadFile method.

1.3.02021-04-26

This API release contains the following updates:

  • Seller Hub and LMS feed types are supported
  • New inventory_task resource
  • Updated FeedStatusEnum type with new enumeration value
1.2.02020-11-13

This API release contains two updates:

  • New Schedule API capabilities
  • Upload summary returned for upload feeds
1.1.02020-08-05

Release of customer_service_metric_task

1.0.12020-07-09

This release of the Sell Feed API includes changes to the documentation and other updates

1.0.02020-05-20

This is the initial release of the Sell Feed API

Show more

Metadata API

Release VersionRelease DateDescription of Release
1.13.22026-06-22
Expanded support for condition grading to salvage categories.
1.13.12026-05-14
Expanded support for condition grading to coin categories.
1.13.02026-03-06
A new method was added to the marketplace resource: getMinimumListingPricePolicies.
1.12.12026-03-05
Added the reservePriceAllowed field to the response of getCategoryPolicies.
1.12.02025-10-30
Added shipping support through the new shipping:marketplace resource, including five methods: getExcludeShippingLocations, getHandlingTimes, getShippingCarriers, getShippingLocations, and getShippingServices.
1.11.12025-07-17
The valueCategory boolean was added to the getCategoryPolicies response to indicate if the returned category is a value category.
1.11.02025-05-21
The getCurrencies method was added to the marketplace resource; Metadata support for Global Trade Item Numbers (GTINs) was added and compatibility for motors was enhanced through fields added to the get_category_policies and get_motors_listing_policies resources
1.10.02025-03-17
Six methods were added to the marketplace resource: getCategoryPolicies, getClassifiedAdPolicies, getListingTypePolicies, getMotorsListingPolicies, getShippingPolicies, and getSiteVisibilityPolicies
1.9.02024-12-18
A new resource, compatibility, has been added, with five new methods to support parts compatibility features
1.8.02024-07-09
Two methods were added to the shipping:marketplace resource: getProductSafetyLabels and getRegulatoryPolicies
1.7.12023-08-29
In getExtendedProducerResponsibilityPolicies the Extended Producer Responsibility fields are now supported on all marketplaces
1.7.02023-06-26
Expanded response payload for getItemConditionPolicies to support condition grading related information
1.6.12023-06-22
Extended Producer Responsibility IDs are no longer set at the listing level
1.6.02023-01-09
New Schema added to support hazardous material labels related information and repair score index
1.5.02021-12-13
One new method was added to the marketplace resource: getExtendedProducerResponsibilityPolicies
1.4.32021-11-30
The getProductAdoptionPolicies method was removed from the API
1.4.22021-09-01
A usage field was added under the itemConditions container to indicate item conditions that are only available for use by eligible sellers
1.4.12021-06-22
Expanded marketplace support for the marketplace resource
1.4.02021-03-24
Enhanced the getItemConditionPolicies method to return the Certified Refurbished item condition for sellers who are eligible to list with that item condition
1.3.02018-10-15
Expanded response payload for getReturnPolicies
1.2.02018-05-15
One new method added to the marketplace resource: getProductAdoptionPolicies
1.1.02017-06-06
Five new methods added to the marketplace resource
1.0.02016-10-19
Initial release of Version 1
Show more

Notification

Release VersionRelease DateDescription of Release
1.6.32025-09-10

Added notification topic: Listing Preview Creation Task Status

1.6.22025-09-03

Added notification topic: Buyer Requested Purchase Quote

1.6.12024-09-12

Enabled sandbox support

1.6.02024-08-05

Added notification topics: Seller Customer Service Metric Rating and Seller Standards Profile Metrics

1.5.12023-12-14

Added new error codes to createSubscriptionFilter method

1.5.02023-06-07

Added one new notification topic: Priority Listing Revision

1.4.02023-03-14

Added three new methods: createSubscriptionFilter, getSubscriptionFilter, and deleteSubscriptionFilter

1.3.02022-11-01Short details on the release (e.g., Added new API endpoints for product search).
1.2.02021-09-15

Enabled the authorization code grant flow for user-based subscriptions in the subscription resource methods

1.1.02021-06-30

Added four new resources

1.0.02021-03-22

Initial release of Version 1.0.0

Show more

Analytics API

Release VersionRelease DateDescription of Release
1.3.22024-02-14
Updated date_range filter of the getTrafficReport method to include support for additional time zones.
1.3.12023-12-04
New metric TOTAL_IMPRESSION_TOTAL added to getTrafficReport method.
1.3.02021-10-04
New sorting error codes added to getTrafficReport method.
1.2.02019-11-05
The new customer_service_metric resource introduces the new method getCustomerServiceMetric.
1.1.02018-10-18
Documentation update release.
1.0.02016-10-19
Initial release of Version 1.
Show more

Taxonomy API

Release VersionRelease DateDescription of Release
1.1.12025-05-07
Adds a new aspectConstraint field, aspectAdvancedDataType, to the fetchItemAspects and getItemAspectsForCategory responses.
1.1.02024-08-26
Added a new method, getExpiredCategories, that retrieves mappings of expired leaf categories to corresponding active leaf categories.
1.0.12023-04-04
A backslash (\) may now be inserted immediately prior to an embedded comma within a filter value when calling getCompatibilityPropertyValues. This will prevent the comma from being interpreted as a delimiter between successive property name/value pairs.
1.0.02020-10-15
The initial version of the GA version of Taxonomy API
Show more

Media API (REST)

Release VersionRelease DateDescription of Release
1.5.12026-06-16

Added EEK_PRODUCT_INFORMATION_SHEET and EEK_ENERGY_LABEL to DocumentTypeEnum.

1.5.0-beta2026-05-05

Added support for return shipping labels.

1.4.3-beta2026-05-04

Added new DocumentTypeEnum values: GENERAL_CERTIFICATE_OF_CONFORMITY and CHILDRENS_PRODUCT_CERTIFICATE

1.4.2-beta2026-03-26

Added support to access the maximum dimension version of the uploaded image.

1.4.1-beta2026-02-23

Added a new DocumentTypeEnum value: SAFETY_TEST_LAB_REPORTS

1.4.0-beta2025-04-17

Added support for images.

1.3.1-beta2025-04-10

Added a new languageEnum value: PORTUGUESE

1.3.0-beta2025-02-03

Added the createDocumentFromUrl method to the document resource.

1.2.0-beta2024-07-16

Added support for Documents.

1.1.1-beta2024-04-08

Reduced video retention time to 30 days.

1.1.0-beta2021-10-06

Added video moderation functionality.

1.0.0-beta2021-04-29

Initial release of the Media API.

Show more

Translation API

Release VersionRelease DateDescription of Release
1.1.6-beta2023-02-27

The following translations have been added in this release:

  • French text may be translated into English, German, Italian, and Spanish
  • Italian text may be translated into English, German, French, and Spanish
  • Spanish text may be translated into English, German, French, and Italian
  • Chinese (Mandarin) text may be translated into English
1.1.5-beta2022-10-03

The following changes have been made in this release:

  • The maximum number of characters for ITEM_DESCRIPTION is reduced to 20,000, excluding markup/tags
  • German text may be translated into Polish
  • Polish text may be translated into German
  • Updated error message for Error Code 110007
  • Added new Error Code 110008
Short details on the release (e.g., Added new API endpoints for product search).
1.1.4-beta2020-11-10
English text may now be translated into either Portuguese or Russian, and German text can be translated into English
1.1.3-beta2020-07-08
English and German text may now be translated into either French, Italian, or Spanish
1.1.2-beta2020-06-08
Added support for English-to-Japanese translations
1.1.1-beta2020-06-08
  • Updated translation context support
  • Updated text field string length
1.1.0-beta2020-01-14
Added item description for English-to-Chinese translations
1.0.0-beta2019-11-08
Initial API release
Show more

VeRO API

Release VersionRelease DateDescription of Release
1.0.02025-03-26
Initial release of Version 1.0.0
Show more

Inventory API

Release VersionRelease DateDescription of Release
1.18.62026-06-22
Added support for condition grading for salvage categories.
1.18.52026-05-14
Added support for condition grading for coin categories.
1.18.42025-07-15

New error and warning added for new P&A Returns Policy.

1.18.32025-06-27

This release adds 57 new error codes for createOrReplaceInventoryItem.

1.18.22025-01-22

Added two new ConditionEnum values: PRE_OWNED_EXCELLENT and PRE_OWNED_FAIR.

1.18.12025-01-16

Added a new field, contactUrl, to Manufacturer and ResponsiblePerson types.

1.18.02024-10-22

Added three new location mapping methods to the listing resource, as well as a new fulfillment center location type to support this feature.

1.17.62024-08-01

This release adds support for GPSR information.

1.17.52024-05-29

New requirement when adding EPA approved products.

1.17.42024-02-27

This release adds support for irregular shipping.

1.17.32024-02-05

This release adds support for required Economic Operator information.

1.17.22023-10-23

This release includes the following changes:

  • When listings are on hold due to policy violation then new boolean listingOnHold field is returned in getOffer/getOffers method. See the type Listing Details.
  • An official date January 22, 2024 is added to the note about revising single trading card listings with conditionDescriptors data. See the method creatorReplaceInventoryItem.
1.17.12023-08-29

Made changes to indicate that all DSA-related fields will become available on all eBay marketplaces, and is no longer restricted to just a couple of marketplaces.

1.17.02023-06-26

Added support for condition grading for select trading card categories.

Show more

Account API v2

Release VersionRelease DateDescription of Release
2.2.02026-02-26
Added eight methods through the combined_shipping_rules resource and two methods through the user_preferences resource.
2.1.02023-08-28
Added eight new methods, getPayoutSettings and updatePayoutPercentage, to support split payout functionality for sellers in Mainland China.
2.0.02022-03-03
Initial release of Version 2.
Show more

eDelivery International Shipping

Release VersionRelease DateDescription of Release
1.1.02025-09-18
Added support for bundles.
1.0.02025-02-25
Initial release of Version 1.0.0
Show more

Recommendation API

Release VersionRelease DateDescription of Release
1.1.02020-08-25
Added support for a new ITEM enum value in the bidPercentages response field
1.0.02019-03-27
Initial release of Version 1.0.0
Show more

Developer Analytics API

Release VersionRelease DateDescription of Release
1.0.1-beta2025-04-02
Added a new response field, count, to the getRateLimits and getUserRateLimits methods.
1.0.0-beta2018-08-20
Initial release of Version 1, beta.0.0
Show more

Client Registration API

Release VersionRelease DateDescription of Release
1.0.02022-10-19
This is the initial release of the Client Registration API
Show more

Key Management API

Release VersionRelease DateDescription of Release
1.0.02022-10-19
This is the initial release of the Key Management API
Show more

Stores API

Release VersionRelease DateDescription of Release
1.0.02024-02-22

Initial API release

Show more

Feedback API

Release VersionRelease DateDescription of Release
1.0.02025-10-15

Initial release of the Feedback API.

Show more

Account API v1

Release VersionRelease DateDescription of Release
1.9.32025-10-28

Added the new bulkCreateOrReplaceSalesTax method to the sales_tax resource.

1.9.22024-03-18

Removed cashOnDeliveryFee container from Fulfillment policies.

1.9.12022-10-11

Added a new AdvertisingProgramEnum value to support Offsite Ads.

1.9.02022-12-10

Added fields to support domestic or international promotional shipping discount profile ID

1.8.02022-12-10

Added the new advertising_eligibility resource, which includes the getAdvertisingEligibility method.

1.7.02021-12-15

Added the new custom_policy resource with four new methods to create and manage Custom Policies

1.6.32021-06-21

Added support for multi-rate tables in the Spain (EBAY_ES) and France (EBAY_FR) marketplaces for the getRateTables method.

1.6.22021-04-20

Added support for multi-rate tables in the Germany (EBAY_DE) and United Kingdom (EBAY_GB) marketplaces for the getRateTables method

1.6.12021-03-10

Added a new programTypeEnum value to support Partner Motors Program sellers

1.6.02020-06-10

Added the kyc resource and the getKYC method to support eBay managed payments sellers

Show more

Marketing API

Release VersionRelease DateDescription of Release
1.23.22026-06-04
Added new error codes to support specific campaign-management scenarios for the createCampaign, cloneCampaign, pauseCampaign, updateCampaignIdentification, and updateAdRateStrategy methods.
1.23.12026-04-27
Promoted Listings: Promoted Listings with priority campaign strategy is now open to the public and is no longer restricted to approved users only.
1.23.02026-03-31
Promoted Listings: Decommissioned two methods from the campaign resource: setupQuickCampaign and launchCampaign.
1.22.42026-01-27
Promoted Listings:  Add a new annotation key value and new metric key values to Promoted Listings reports.
1.22.32025-08-21
Promoted Listings: Added new annotation key values to Promoted Listings reports; expanded support for the sales_type dimension key for transaction reports .
1.22.22025-07-23
A new error message was added to createReportTask method to handle invalid dates in the date range filters.
1.22.12025-06-30
Added new error and warning codes to the UpdateCampaignBudget method to support new daily limit.
1.22.02024-07-16
Priority strategy campaign: Added new suggestMaxCpc method
1.21.22024-04-29
Promoted Listings Standard: Added support for auction listings for PLS campaigns on all marketplaces.
1.21.12024-04-25
Promoted Listings Advanced: Added new campaign_targeting_types filter for getCampaigns and added new error codes for createCampaign and updateBiddingStrategy.
1.21.02024-03-28
Promoted Listings Advanced: Added support for smart targeting PLA campaigns
1.20.02023-12-15
New URI parameters, Response field, HTTP Status Code and Error Codes have been added to getReportMetadata and getReportMetadataForReportType methods and samples have been updated.
1.19.02023-11-09
Promoted Listings Advanced: Dynamic Bidding has been added to Cost per Click (CPC) campaigns.
1.18.02023-10-11
Promoted Listings: Add support for Offsite Ads campaigns, including new fields and a new method.
1.17.22023-09-25
Increased the maximum number of campaignIds for PLS from 25 to 1,000. Increased the data threshold for a report from 200,000 to 500,000.
1.17.12023-09-22
Added new error code 35130 to method createReportTask and added new annotation key target_type for campaign_id that will be supported for COST_PER_CLICK funding model.
1.17.02023-08-17
Added new email_campaign methods to support new features for Store Email Campaigns.
1.16.02023-08-15
Promoted Listings: Added two new methods, setupQuickCampaign and launchCampaign, to support quick setup PLA campaign functionality.
1.15.32023-08-07
Promoted Listings Standard: Standard campaigns can now be applied to auction listings on eBay Germany marketplace.
1.15.22023-08-01
Promoted Listings: Added support for listing format as a criteria for Promoted Listings reporting.
1.15.12023-05-04
Promoted Listings: Added new optional column to transaction report; removed support for multiple funding models from Promoted Listing Reports; added a new error code; removed support for deprecated TRANSACTION_REPORT metricKeys.
1.15.02023-03-15
Promoted Listings: Removed error message, added error messages, updated type description for bidPercentage, and increased days listed amount for DE, FR, IT, and ES
1.14.02022-09-30
Promoted Listings: Added an error message, support for warning response headers, and deprecated capabilities information
1.13.02022-07-13
Promoted Listings: Added support for campaigns that are not getting visibility due to a lower ad rate
1.12.02022-07-11
Promoted Listings: Added a new updateAdRateStrategy method to the campaign resource, as well as new types to support this addition
1.11.02022-07-11
Promoted Listings: Added support for the Promoted Listings Advanced (PLA) program, including new resources and several new methods
1.10.22022-05-11
Promoted Listings: Increased the campaignIds limit for the createReportTask method
1.10.12021-12-01
Promoted Listings: Added support for autoSelectFutureInventory in rules-based Promoted Listings campaigns, and added new error and warning messages to the createCampaign method
1.10.02021-07-15
Promoted Listings: Added support for the Coded Coupon promotion type
1.9.02021-07-12
Promoted Listings: The start and end times for Promoted Listings reports is standardized on UTC with local time zone offset
1.8.02020-08-19
Promoted Listings:
  • Added new error message 35078
  • Updated the description of error message 35077
  • Added a new status to CampaignStatusEnum
1.7.02020-02-28
Promoted Listings: Increased the maximum amount of listings per campaign from 25,000 to 50,000 and added support for Promoted Listings methods to the following eBay marketplaces:
  • Canada (English)
  • Canada (French)
  • France
  • Italy
  • Spain
1.6.02019-09-11
Promoted Listings: The start and end times for Promoted Listings reports is standardized on MST
1.5.02019-04-30
Promotions Manager: Added volume pricing to item_promotion resource and added two new fields to address the increased functionality
1.4.02018-05-11

Promotions Manager: Added the item_price_markdown resource and four associated methods to support markdown promotions and increased the maximum number of items in a promotion from 500 to 2,000

Promoted Listings: The maximum value allowed for bidPercentage was raised from 20% to 100%

1.2.02017-04-26
Added methods to support new reporting features for Promoted Listings.
1.1.02017-03-07

Added a new method that returns the listings associated promotions created with Promotions Manager.

Added a container to support creating threshold promotions using a set of rules.

1.0.02016-10-19
Initial release of Version 1.
Show more