This doc page has moved! You should be automatically redirected to the new location. If you are not redirected automatically, follow this link to the new page.

You are here: Commerce/Taxonomy API > Release Notes

Taxonomy API release notes

Just getting started with the Taxonomy API? See the following documents for details on using this API:

The API release history

The following table lists the releases for the Taxonomy API:


Release Date

Summary of Release

Version 1_beta.0.0

2017-05-03 Initial release of Version 1_beta.0.0

Version 1_beta.0.0

This is the initial release of the Taxonomy API, Version 1_beta.0.0. For a list of the new calls, see the Taxonomy API Reference.


See the API Site Status for announcements regarding recently resolved or current system wide issues. Visit the Developer Support page for support options and information on filing bugs.

Availability of OpenAPI Specification

This release of the Taxonomy API includes Beta version downloadable JSON and YAML formats of the API contract that comply with version 2.0 of the OpenAPI Specification. The OpenAPI Specification is a widely adopted standard for describing RESTful APIs. The eBay API specification files can facilitate your development process through the ability to generate client code in numerous languages, using the Swagger-Codegen tools, as well as the ability to easily view and test the API via the Swagger UI projects. Development of the OpenAPI Specification is overseen by the Open API Initiative, an open source collaborative project of the Linux Foundation.

Note: If you want to use the Swagger editing tool for viewing and testing, we advise that you use the version of the editor that is compatible with 2.0 OpenAPI specifications:

Read the eBay API documentation for comprehensive API details, including allowed values, constraints, method-specific error messages, and implementation details.

File download  Download Taxonomy API JSON specification (beta)

File download  Download Taxonomy API YAML specification (beta)