Analytics API, Version 2.16

DATE: September 15, 2026

AUTHOR: Dimensions product team

Retraction and expression of concern data now available on publications

Publications in the Dimensions Analytics API now carry information about whether they have been retracted or are subject to an expression of concern, along with the details of the relevant notice. Retraction status and reasons are sourced from Retraction Watch, Crossref and PubMed.

New publication fields

Field	Description
`retracted`	Whether the publication has a retraction notice. Filterable and facetable (= "true" / = "false").
`retraction_details`	Details of the retraction. Returned only for retracted publications. Contains `date` (date of the retraction), `notice_id` (Dimensions publication ID of the retraction notice) and `reasons` (list of reasons for the retraction, as recorded by Retraction Watch).
`expression_of_concern`	Whether the publication is subject to an expression of concern. Filterable and facetable (`= "true"` / `= "false"`).
`expression_of_concern_details`	Details of the expression of concern. Returned only where one exists. Contains `notice_id` (Dimensions publication ID of the notice) and `reasons` (list of reasons, as recorded by Retraction Watch).

Example

search publications
  where research_orgs.id = "grid.4991.5"
  and retracted = "true"
  return publications[id + doi + title + retracted + retraction_details]

Documentation

The API documentation now includes a section explaining the difference between the Analytics API and the CRIS API — how they relate, where they differ in supported features, and which endpoint each uses. A matching FAQ entry has been added. These release notes apply to both APIs; entries covering faceting and expert identification can be disregarded for the CRIS API.

Fixes

Fixed an error ('generator' object has no attribute 'keys') returned by queries using citations_per_year with a single-year range.
Fixed an error (descriptor 'lower' for 'str' objects doesn't apply to a 'int' object) affecting grant queries that combined an organization filter with a year range on private instances.