API Specifications - International Image Interoperability Framework™

Current Specifications

API Current Version
Image API 3.0.0
Presentation API 3.0.0
Authentication API 1.0.0
Change Discovery API 1.0.0
Content Search API 1.0.0

Draft Specifications

API Draft Version (Status)
Content State API 0.9.0

Feedback Requested
We welcome feedback on all IIIF Specifications. Please send any feedback to iiif-discuss@googlegroups.com.

Community Translations

API Version Translation
Image API 3.0, 2.1 Japanese
Presentation API 2.1 Japanese
Content Search API 1.0 Japanese
Authentication API 1.0 Japanese

Translation Note
Please note that the IIIF community does not guarantee the accuracy of any translation. They are linked to for information purposes only, and any discrepancies with the specifications are unintentional. The English versions of the specifications linked above are the definitive versions.

Community Cookbook

The Cookbook gathers together examples of how to create IIIF Presentation API assets, in order to:

  • Provide many more examples than the specification alone can do, for reference and learning;
  • Encourage publishers to adopt common patterns in modeling classes of complex objects;
  • Enable client software developers to support these patterns, for consistency of user experience (when desirable); and
  • Demonstrate the applicability of IIIF to a broad range of use cases.

The Cookbook webpages are under constant development and the list of recipes include links to completed recipes and place holders for future recipes. The community welcomes additions to the Cookbook. To get started, review the Cookbook process and say hello on the Cookbook Slack channel.


Older Versions

Current IIIF specifications should be used for all new work. Old versions are retained for reference and are listed below. Technical resources and reference implementations of older versions are NOT guaranteed to be maintained across new major versions.

Old API Version Notes
Authentication API 0.9.4 Published 2016-10-05
Change Discovery API 0.9.2 Published 2021-04-28
Image API 2.1 Published 2016-05-12, updated 2017-06-09
Image API 2.0 Published 2014-09-11
Image API 1.1 Published 2013-09-17
Image API 1.0 Published 2012-08-10
Presentation API 2.1 Published 2016-05-12, updated 2017-06-09
Presentation API 2.0 Published 2014-08-12
Metadata API 1.0 “Metadata API” was replaced with the Presentation API, published 2013-09-16
Metadata API 0.9 Draft of the “Metadata API”, published 2013-06-11
Search API 0.9 Draft published 2016-04-11


IIIF also has a series of Implementation Notes which are not subject to the same process as formal APIs but may be useful to implementers.


IIIF Specifications are created and published following the IIIF Editorial Process.