About this endpoint
What it does
Calculates book spine and cover size values from the provided book dimensions and paper thickness. The request body includes trim size, page count, and thickness inputs; the success response schema is currently an object with no defined properties.
Request Body
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| trimWidthIn | Number | Yes | Trim width in inches. |
| trimHeightIn | Number | Yes | Trim height in inches. |
| pages | Integer | Yes | Number of pages. Minimum: -9007199254740991, maximum: 9007199254740991. |
| thicknessIn | Number | Yes | Paper thickness in inches per page. Example given in schema: 0.002252 for KDP white paper. |
| dpi | Number | No | Dots per inch. |
| bleedIn | Number | No | Bleed in inches. |
| platform | ENUM | No | Allowed values: kdp, ingramspark, lulu. |
| spineAllowanceIn | Number | No | Spine allowance in inches. |
Response
Returns a JSON object with a single result object holding the spine width, the full wrap-cover size in inches and pixels, the position of each cover panel, and a plain-text summary.
| Field | Type | Description |
|---|---|---|
result.spineIn | number | Spine width in inches: pages × thicknessIn plus spineAllowanceIn. |
result.coverWidthIn | number | Full cover width in inches: back cover, spine and front cover, plus bleed on both sides. |
result.coverHeightIn | number | Full cover height in inches, including bleed top and bottom. |
result.pixels.width | number | Full cover width in pixels at the chosen dpi. |
result.pixels.height | number | Full cover height in pixels at the chosen dpi. |
result.pixels.dpi | number | The resolution used. Defaults to 300. |
result.panels.back | object | The back cover panel. |
result.panels.spine | object | The spine panel. |
result.panels.front | object | The front cover panel. |
result.panels.<panel>.x | number | Distance in inches from the left edge of the full cover, including bleed, to the panel's left edge. |
result.panels.<panel>.y | number | Distance in inches from the top edge of the full cover, including bleed, to the panel's top edge. |
result.panels.<panel>.w | number | Panel width in inches. |
result.panels.<panel>.h | number | Panel height in inches. |
result.warnings[] | array of strings | Messages about the book, such as a page count outside the platform's limits or a very narrow spine. Empty when nothing looks wrong. |
result.platform | string | The platform used for the label and page-limit check: kdp, ingramspark or lulu. |
result.platformNote | string | A reminder that the formula is the same for every platform and that you should confirm bleed and thickness with your printer's own cover template. |
result.summary | string | A multi-line plain-text summary with the trim, spine width, cover size in inches and millimetres, and pixel size. |



