Wraps

Calculate KDP wrap dimensions

Print geometry for a KDP wrap: spine width, full canvas in inches and pixels at 300 DPI, safe margins, the barcode zone, and whether the spine is thick enough for text. Free, no credits, no side effects. The MCP calculate_kdp_wrap tool and POST /api/v1/wraps apply the same rules, so a size this refuses cannot be created either.

get/api/v1/wraps/calculate

Request

  • Base URL: https://beyourcover.com
  • URL: https://beyourcover.com/api/v1/wraps/calculate
  • Auth: HTTP bearer

Query parameters

trimWidthnumber required

Trim width in inches, e.g. 6.

trimHeightnumber required

Trim height in inches, e.g. 9.

pageCountinteger required

Interior page count.

paperType'white' | 'cream' | 'premium_color' | 'standard_color' required
bindingType'paperback' | 'hardcover'

Response

Print geometry for the requested book.

spineWidthnumber

Spine width in inches: derived from pageCount and paperType on a KDP wrap, entered by hand on a Barnes & Noble design from the editor.

fullWidthnumber

Full wrap width in inches (back + spine + front + bleed).

fullHeightnumber

Full wrap height in inches (trim height + bleed).

pixelWidthinteger

fullWidth x dpi, rounded.

pixelHeightinteger

fullHeight x dpi, rounded.

dpiinteger

Always 300.

bleednumber

Bleed in inches per edge (0 for hardcover printed case).

safeTextMarginnumber

Minimum inches between text and the trim edge.

minFontSizenumber

Smallest point size the layout engine will emit.

canHaveSpineTextboolean

False when the spine is too thin for lettering (under 79 pages on KDP); spine text is dropped with a warning.

sectionsobject

Panel boundaries in inches from the left edge of the full wrap.

bindingType'paperback' | 'hardcover' | 'dust-jacket'

dust-jacket (with flaps) appears only on Barnes & Noble designs made in the browser editor.

Changes

No recorded changes to this operation across all 1 revision of this API.