Release Notes and Deprecations

Versions History

This page contains version history information for the version 2 of the Dimensions Analytics API.


Older release notes are available on the legacy API Version 1 documentation.

Verson 2.1.0 — 2022, April, Week of 11th

  1. Deprecated field cited_by_ids in Patents. Use referece_ids to obtain citing patents instead.

  2. Deprecated field repository_id in Datasets, use repository auxiliary entity and the associated field in Datasets.

  3. New field funding_cny in Grants.

  4. New field isbn in Publications.

  5. Total number of records returned when using Unnesting multi-value entity fields is capped at 10000 records, as a performance and stability improvement.

Verson 2.0.0 — 2021, October, Week of 18th

This release brings about many improvements to the overall stability and performance of the API, but most importantly, it removes all previously deprecated fields. By doing so, it gives us a more solid platform on which to continue innovating by adding new features to the API and the Dimensions Search Language. See also the how to upgrade from V1 to V2 page.

New features:

  1. The return <source> syntax is now optional (see the search source page)

  2. New search field acknowledgements in publications

  3. Triple quotes syntax for full-text search

Deprecations History

This section lists API V2 fields and search fields that have been deprecated and should not be used (for older deprecations, see also the legacy V1 API deprecations page).


This fields will be supported in versions 2.1.x and removed in the next major release. To ensure full compatibility with the upcoming major release, it is recommend to stop using deprecated fields as soon as possible.

Deprecated Fields



Deprecation Note



Use reference_ids field to filter patents citing this patent (see also: Patents Links section).



Deprecated in favor of: repository

Partially Deprecated Fields

On the following fields only certain features are deprecated (e.g. filtering or faceting).

Deprecated Search Indexes

Deprecated Functions