Example: Get a book

Fetch full book details by public id — metadata, files, format-specific attributes, and distribution state.

API reference: Get a book. Use the staging host and a bookPublicId returned from Create a new book or from List books.

Replace YOUR_API_KEY. The UUID below matches the demo id used across the OpenAPI examples (b2c3d4e5-f6a7-8901-bcde-f12345678901).

See also

List books — discover ids.
Example: Ebook upload — create this book and attach files end-to-end.

GET by public id

curl -sS "https://api.sandbox.dev.publishdrive.com/v2/distribution/books/b2c3d4e5-f6a7-8901-bcde-f12345678901" \
  -H "apikey: YOUR_API_KEY"

Expect 200 with a JSON:API-style data object: id, type: book, and attributes (format, ebookDetails / audioDetails / podDetails, files, chapters, etc.).

Example: List books

Paginate and filter your catalog with the List books endpoint — page, perPage, format, language, and sort.

Example: Get a book by external id

Resolve a stable partner-side identifier (`externalId`) to the same book payload as GET by public id.

On this page

GET by public id

API: Get a book