Skip to main content

Changelog

Changes to the public API contract, newest first.

What appears here​

This log covers changes an integration can observe: new endpoints, new or changed request parameters, additions to response payloads, and content or behaviour that was withdrawn. Dates are the date the change reached production.

Internal work — dependency updates, infrastructure, build and deployment changes, performance tuning and test coverage — is deliberately omitted. If you need to correlate a specific change with a support conversation, quote the x-amzn-requestid header from the response along with the date.

There is one published OpenAPI document, /openapi.json, and it always describes the API as currently deployed; its info.version identifies the revision. There are no per-version spec URLs to pin to, so re-fetch it rather than caching a copy indefinitely.

19 June 2026​

  • The uncut creative collection was withdrawn. partOf metadata flags no longer carry creativeCollectionUncut.

19 May 2026​

  • Search gained category filtering. Combined with the category entries in the single-item response's subjects array, this supports finding similar content — see Metadata Guidance.

21 April 2026​

  • Search gained smart search capability.

13 March 2026​

  • Added the order history endpoint, GET /orders, with its own orders scope and long-polling support when dateFrom is supplied.

3 September 2025​

  • Search, single-item and bulk-item responses now expose 170px thumbnail renditions.

2 June 2025​

  • Added the token endpoint, POST /token, for exchanging API credentials for an access token.

27 January 2025​

  • Release status (model released and property released) is now returned on item and download responses.

24 January 2025​

  • Search gained video filters, including duration, frame rate and resolution.

22 January 2025​

  • The feed endpoint now reflects contributor visibility and supports multi-select release filtering.

14 January 2025​

  • Added the zoom 450 rendition.

6 January 2025​

  • Search gained a showcontributor filter. A customer-level contributor-hiding setting can be overridden per request.

1 November 2024​

  • CORS support added, so the API can be called directly from a browser.

14 August 2024​

  • Orientation and viewpoint filters now accept multiple values.

3 June 2024​

  • Search responses now include the rightsinfo field.

12 April 2024​

  • Added the feed endpoint for change notifications covering created, modified and removed content.

27 March 2024​

  • Search responses now include profile.

7 December 2023​

  • Video renditions updated.

21 November 2023​

31 October 2023​

  • Added the bulk items endpoint, GET /item?ids=…, retrieving metadata for up to 500 items in one call.

1 August 2023​

  • Item responses carry additional identifiers for creative collection and novel use.

5 July 2023​

  • The feed endpoint gained customer filters.

27 June 2023​

  • The feed endpoint gained long polling, holding a request open until changes occur.

31 January 2023​

  • Item responses now return the licence type.
  • Search gained a filter for exclusive content.

9 January 2023​

  • Search gained the hidecontributor parameter.

28 September 2022​

  • Search gained a multiple-collections type filter.

26 September 2022​

  • Breaking: the firstcreated and contentcreated mappings were swapped. contentcreated is when the content itself was created; firstcreated is when it first entered the platform.

16 September 2022​

  • Production renditions added to the item response.

26 August 2022​

  • Search gained an oldest-date-taken filter.

14 August 2022​

  • Search gained collection filtering.

5 August 2022​

  • Territory restrictions applied to search and item responses, so results reflect the territories your subscription is cleared for.
  • Requests for content not cleared in your territory now return 403 rather than 502.

22 June 2022​

  • Library membership data added to item and search responses — the partOf metadata flags.

7 June 2022​

  • Search gained a safe-search filter.