/
Migration Guide: Inventory API is shutting down

Migration Guide: Inventory API is shutting down

Important change coming Jun 30, 2026

How to check if I have access to an EAN?

Access to sell

Everyone can sell it unless it is restricted to specific retailers. Look for SalesRestriction > SalesRestrictionType = 04

Examples: 04 = restricted to mentioned SalesOutlets, 09 = only libraries, 13 = only streaming-companies

Access to download (for streaming-companies)

To be able to download for streaming, you HAVE TO see your own sales outlet code mentioned as a SalesOutlet under SalesRestriction or type 20. Note also the optional start-date / end-date.

See sales restrictions types https://ns.editeur.org/onix/en/71

Role based, do you as an integrator have access to this book? Must be true in order for you to sell the title.

Where do I find each element

Looking at the records returned by Inventory API, here is where each element is found in Onix v3. See also our general Onix-documentation: ONIX3

Element <name>

Where to find it in Onix v3

Element <name>

Where to find it in Onix v3

title

DescriptiveDetail > TitleDetail > TitleText

author

name

DescriptiveDetail > Contributor > PersonNameInverted

id

ProductIdentifier > IDValue
(look for ProductIDType = 36)

updated

datestamp from ProductIdentifier
(look for ProductIDType = 36)

inv:isbn

ProductIdentifier > IDValue
(look for ProductIDType = 15)

inv:publisher

PublishingDetail > Publisher > PublisherIdentifier > IDValue

inv:format

  1. Audio or ebook?

DescriptiveDetail > ProductForm

Example: AJ = audio, ED = ebook

See https://ns.editeur.org/onix/en/150

  1. What kind of format?

DescriptiveDetail > ProductFormDetail

Example: A103 = Mp3, E101 = Epub, E107 = PDF

See https://ns.editeur.org/onix/en/175

  1. What version of the format?

DescriptiveDetail > ProductFormFeatureValue > ProductFormFeatureValue

Example: 101A = EPUB 2.0.1, 101B = EPUB 3.0

See https://ns.editeur.org/onix/en/220

inv:drm

DescriptiveDetail > EpubTechnicalProtection

Example: 00 = NODRM, 02 = SDRM, 06 = LCP

See https://ns.editeur.org/onix/en/144

inv:version

Not supported anymore. Use updated to detect a new version.

inv:firstpublished

PublishingDetail > PublishingDate > Date

(look for PublishingDateRole = 01 and dateformat = 00)

inv:deleted

See NotificationType = 05 (deleted) ONIX3

inv:published

ProductSupply > MarketPublishingDetail > MarketPublishingStatus

04 = Active/published

Note: If 17 (withdrawn from sale) you are not allowed to offer it in your service.

inv:access

See section: “How to check if I have access to an EAN?“

inv:excerpt

Ebook-excerpts not present in Onix yet. TBA 2026 Q2.