{
  "openapi": "3.0.3",
  "info": {
    "title": "FreeDailyPro Utility APIs",
    "version": "1.5.1",
    "description": "200+ REST endpoints for PDF, PowerPoint, documents, text, image, audio, video and calculators, behind one X-API-Key header. Generated directly from the real route definitions, so this spec never lists an endpoint that does not exist.\n\nFirst call (under a minute): word-count, slug and case-convert also work with no key, 10 tries per hour per IP.\n\n```\ncurl -X POST https://api.freedailypro.com/v1/text/word-count -H \"Content-Type: application/json\" -d '{\"text\":\"Hello world\"}'\n```\n\nEvery other endpoint needs the key: add -H \"X-API-Key: YOUR_KEY\". File endpoints take multipart/form-data (curl -F \"file=@in.pdf\") and return the processed file. Plans: trial 20,000 calls a month; Premium $24 for 200,000; Ultra $69 for 750,000; Mega $129 for 2,000,000 with priority support. One shared call pool across every endpoint. Requests with a field the endpoint does not take, with a missing or invalid field, or with text over an endpoint's limit are rejected (400 for the shape of the request, 422 for values that cannot be processed) and are never billed. Files and text are processed in memory and nothing you send is stored. The same tools are also an MCP server (200+ tools) at https://api.freedailypro.com/mcp for AI agents.",
    "contact": {
      "name": "FreeDailyPro",
      "url": "https://www.freedailypro.com/developers",
      "email": "support@freedailypro.com"
    },
    "termsOfService": "https://www.freedailypro.com/terms",
    "x-logo": {
      "url": "https://www.freedailypro.com/favicon.ico"
    }
  },
  "servers": [
    {
      "url": "https://api.freedailypro.com",
      "description": "Production"
    }
  ],
  "externalDocs": {
    "description": "Developer hub, plans and MCP setup",
    "url": "https://www.freedailypro.com/developers"
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  },
  "tags": [
    {
      "name": "PDF",
      "description": "Merge, split, rotate, compress, watermark, flatten, repair, fill and redact PDFs."
    },
    {
      "name": "PowerPoint",
      "description": "Build decks from JSON, Markdown or CSV; extract, clean, compress, split, merge and edit .pptx files."
    },
    {
      "name": "Documents",
      "description": "Business documents, bank statement to CSV, and book publishing (ISBN, ONIX, EPUB, print-ready PDF)."
    },
    {
      "name": "Text",
      "description": "Text, developer, security and SEO helpers: word count, slugs, hashes, JWT, regex, diff, meta tags."
    },
    {
      "name": "Image",
      "description": "Resize, crop, flip, rotate and convert images."
    },
    {
      "name": "Audio",
      "description": "Convert, trim, merge, compress, normalize, denoise and re-time audio."
    },
    {
      "name": "Video",
      "description": "Convert, trim, merge, compress, subtitle and thumbnail video, extract audio, make GIFs."
    },
    {
      "name": "Calculators",
      "description": "Loan, tax, retirement, health, unit and planning calculators as clean JSON."
    },
    {
      "name": "Validation",
      "description": "Check IBAN, BIC, US routing number, GTIN/UPC/EAN/ISBN, VIN, email, phone, India GSTIN and PAN values: format, check digits and decoded parts."
    },
    {
      "name": "Currency & VAT",
      "description": "Daily reference exchange rates for about 200 currencies, crypto and metals with the as-of date, EU VAT number validation, plus VAT, GST and sales tax rates and calculations."
    },
    {
      "name": "Payroll & Paycheck",
      "description": "Take-home pay, US federal and state income tax, self-employment tax, UK and India income tax, and pay stubs."
    },
    {
      "name": "Bookkeeping",
      "description": "Bank statement PDF or text to transactions and CSV with a balance check, expense totals and monthly budgets."
    },
    {
      "name": "PDF Forms",
      "description": "Read the fields of a fillable PDF, fill them from JSON with a per-field report and flatten the result."
    },
    {
      "name": "Fitness & Health",
      "description": "BMI, body fat, BMR, TDEE and macros, ideal weight, water intake and pregnancy due date with citations."
    },
    {
      "name": "Video Processing",
      "description": "Convert, trim, merge, compress, subtitle and thumbnail video, extract audio and make GIFs."
    },
    {
      "name": "Image Processing",
      "description": "Convert, resize with fit modes, crop, flip, rotate, compress and watermark images in PNG, JPEG, WebP, AVIF, GIF and TIFF."
    },
    {
      "name": "Audio Processing",
      "description": "Convert, trim, merge, compress, normalize, denoise and re-time audio."
    },
    {
      "name": "Time Zones & Dates",
      "description": "Time zone conversion with daylight saving, timestamps, age, countdowns, work experience and cron descriptions."
    },
    {
      "name": "PowerPoint Automation",
      "description": "Build decks from JSON, Markdown or CSV and extract, clean, compress, merge, edit and check .pptx files."
    },
    {
      "name": "SEO & Web Markup",
      "description": "Meta tags, robots.txt and sitemap, schema.org JSON-LD, keyword density, hashtags and social captions."
    },
    {
      "name": "Security & Developer Utilities",
      "description": "Hashes, UUIDs, JWT decode, passwords, Base64, URL and HTML encoding, regex, JSON, QR and barcodes."
    },
    {
      "name": "Unit Conversion",
      "description": "Convert 14 categories and over 130 units (length, weight, temperature, volume, area, speed, pressure, energy, power, time, data transfer, angle, fuel economy, cooking), plus file size, Roman numerals and recipe scaling."
    },
    {
      "name": "Everyday Math",
      "description": "Percentages, tips and bill splits, discounts and GPA."
    },
    {
      "name": "Mortgage & Loans",
      "description": "Mortgage payment with PMI, refinance break-even, affordability, amortization, APR and interest."
    },
    {
      "name": "Retirement & Debt Planning",
      "description": "Retirement and FIRE projections, debt payoff, 401(k), IRA and HSA limits, RMD, Social Security, 529 and student loans."
    }
  ],
  "paths": {
    "/openapi.json": {
      "get": {
        "summary": "Text: openapi.json",
        "operationId": "OpenapiJson",
        "description": ". No input needed. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "Text: llms.txt",
        "operationId": "LlmsTxt",
        "description": ". No input needed. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/docs": {
      "get": {
        "summary": "Text: docs",
        "operationId": "Docs",
        "description": ". No input needed. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/word-count": {
      "post": {
        "summary": "Count the words, characters, sentences and paragraphs in text and estimate reading time",
        "operationId": "textWordCount",
        "description": "Count the words, characters, sentences and paragraphs in text and estimate reading time. Send JSON with text (required); optional: wordsPerMinute. Returns JSON with words, characters, charactersNoSpaces, sentences, paragraphs, readingTimeMinutes (inside result). Limits: wordsPerMinute: at most 1000, at least 50. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string"
                  },
                  "wordsPerMinute": {
                    "type": "number",
                    "minimum": 50,
                    "maximum": 1000
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "The quick brown fox jumps over the lazy dog. It was a bright, cold day in October.",
                "wordsPerMinute": 200
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "words": {
                          "type": "number",
                          "description": "Words (runs of non-space characters)"
                        },
                        "characters": {
                          "type": "number",
                          "description": "Characters including spaces (UTF-16 units)"
                        },
                        "charactersNoSpaces": {
                          "type": "number",
                          "description": "Characters without whitespace"
                        },
                        "sentences": {
                          "type": "number",
                          "description": "Sentences; abbreviations such as Dr. and e.g., decimals, ellipses and repeated !? do not add sentences"
                        },
                        "paragraphs": {
                          "type": "number",
                          "description": "Paragraphs (blocks separated by a blank line)"
                        },
                        "readingTimeMinutes": {
                          "type": "number",
                          "description": "Reading time in whole minutes at wordsPerMinute (default 200)"
                        }
                      },
                      "required": [
                        "words",
                        "characters",
                        "charactersNoSpaces",
                        "sentences",
                        "paragraphs",
                        "readingTimeMinutes"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Word counter client and server side from freedailypro",
                  "result": {
                    "words": 17,
                    "characters": 82,
                    "charactersNoSpaces": 66,
                    "sentences": 2,
                    "paragraphs": 1,
                    "readingTimeMinutes": 1
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/case-convert": {
      "post": {
        "summary": "Convert text to upper, lower, title, sentence, camel, snake, kebab or other case",
        "operationId": "textCaseConvert",
        "description": "Convert text to upper, lower, title, sentence, camel, snake, kebab or other case. Send JSON with text, case (required). Returns JSON with the answer as a string in result. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string"
                  },
                  "case": {
                    "type": "string",
                    "enum": [
                      "upper",
                      "lower",
                      "title",
                      "sentence",
                      "camel",
                      "pascal",
                      "snake",
                      "kebab",
                      "constant",
                      "alternating",
                      "inverse"
                    ]
                  }
                },
                "required": [
                  "text",
                  "case"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "quarterly revenue report",
                "case": "title"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "case": {
                      "type": "string",
                      "description": "The case that was applied"
                    },
                    "result": {
                      "type": "string",
                      "description": "The converted text"
                    }
                  },
                  "required": [
                    "result",
                    "case"
                  ]
                },
                "example": {
                  "tool": "Case converter client and server side from freedailypro",
                  "case": "title",
                  "result": "Quarterly Revenue Report"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/slug": {
      "post": {
        "summary": "Turn a title into a clean, URL-safe slug",
        "operationId": "textSlug",
        "description": "Turn a title into a clean, URL-safe slug. Send JSON with text (required); optional: lowercase, separator, maxLength, removeStopWords. Returns JSON with the answer as a string in result. Limits: separator: up to 3 characters; maxLength: at most 500. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string"
                  },
                  "lowercase": {
                    "type": "boolean"
                  },
                  "separator": {
                    "type": "string",
                    "maxLength": 3
                  },
                  "maxLength": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 500
                  },
                  "removeStopWords": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "10 Tips for Better PDF Compression (2026 Guide)",
                "maxLength": 50
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "string",
                      "description": "URL-safe slug (letters, digits and the separator only)"
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Slug generator client and server side from freedailypro",
                  "result": "10-tips-for-better-pdf-compression-2026-guide"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/password": {
      "post": {
        "summary": "Generate a random password with the length and character sets you choose",
        "operationId": "textPassword",
        "description": "Send 'length' (4 to 128, default 16) and which types to use ('uppercase', 'lowercase', 'numbers', 'symbols', all on by default). The first version's response fields 'password' and 'strength' are unchanged; 'strength' is the original rule of thumb from length and the number of types on. The same code as the website now draws the password, so every selected type is present and every password that meets your settings is equally likely (the first version could leave a type out). Additive request fields: 'excludeSimilar' (leave out I l 1 O 0 o |), 'symbolSet' (the symbols to use; remove any a site rejects) and 'count' (1 to 10; the first is 'password', and with more than one they are all in 'passwords'). Additive response fields: 'entropyBits' (exact: log2 of the number of passwords your settings allow), 'alphabetSize', 'entropyWorking' (the arithmetic in plain lines, length x log2(alphabet size), then the correction for requiring every type), 'strengthByEntropy' (Weak under 45 bits, Medium from 45, Strong from 70, Very Strong from 100), 'crackTimeAtTenBillionGuessesPerSecond' with 'crackTimeAssumption' (an offline attack on a fast-hashed copy, average case; a slow hash is far slower, a leaked plain-text password makes it meaningless, and it holds only for a password drawn at random like this one) and 'generator'. Where the passwords are made: on the website they are made in the browser with crypto.getRandomValues and are never sent or stored; through this API a password has to be returned in the response, over HTTPS, and the API's usage log records the operation name, not the password. If the password will protect something that matters, make it on the device that will use it. Passphrases (random words) are on the website only. Who calls it: onboarding and IT tools issuing temporary passwords, test-data builders, internal admin panels and MCP agents. Worked example: {\"length\":20,\"uppercase\":true,\"lowercase\":true,\"numbers\":true,\"symbols\":false} returns a 20-character letters-and-digits password with entropyBits 119.04 and strengthByEntropy Very Strong. Integration scenario: an admin panel issues a temporary password for a new hire with excludeSimilar true so it can be read aloud, and forces a change at first sign-in. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Text",
          "Security & Developer Utilities"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "length": {
                    "type": "number",
                    "minimum": 4,
                    "maximum": 128
                  },
                  "uppercase": {
                    "type": "boolean"
                  },
                  "lowercase": {
                    "type": "boolean"
                  },
                  "numbers": {
                    "type": "boolean"
                  },
                  "symbols": {
                    "type": "boolean"
                  },
                  "excludeSimilar": {
                    "description": "Leave out look-alike characters (I l 1 O 0 o |).",
                    "type": "boolean"
                  },
                  "symbolSet": {
                    "description": "The symbols to use when symbols is on (default !@#$%^&*()_+-=[]{}|;:,.<>?). Remove any character a website rejects.",
                    "type": "string",
                    "maxLength": 64
                  },
                  "count": {
                    "description": "How many passwords, 1 to 10. The first is 'password'; with more than one they are all in 'passwords'.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "length": 20,
                "uppercase": true,
                "lowercase": true,
                "numbers": true,
                "symbols": false
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "password": {
                      "type": "string",
                      "description": "The generated password (the first one when count > 1)"
                    },
                    "passwords": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "description": "A generated password"
                      },
                      "description": "All passwords, when count is more than 1"
                    },
                    "strength": {
                      "type": "string",
                      "description": "Strength label"
                    },
                    "entropyBits": {
                      "type": "number",
                      "description": "Estimated entropy in bits"
                    },
                    "alphabetSize": {
                      "type": "number",
                      "description": "Number of distinct characters the generator draws from"
                    },
                    "strengthByEntropy": {
                      "type": "string",
                      "description": "Strength label from the entropy"
                    },
                    "entropyWorking": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "description": "One line of the entropy working"
                      },
                      "description": "How entropyBits was worked out"
                    },
                    "crackTimeAtTenBillionGuessesPerSecond": {
                      "type": "string",
                      "description": "Time to guess by brute force at the stated rate"
                    },
                    "crackTimeAssumption": {
                      "type": "string",
                      "description": "What the crack time assumes"
                    },
                    "generator": {
                      "type": "string",
                      "description": "Which random generator was used"
                    }
                  },
                  "required": [
                    "password",
                    "strength"
                  ]
                },
                "example": {
                  "tool": "Password generator client and server side from freedailypro",
                  "password": "6OYIZX4DACfWCZrSZTKB",
                  "strength": "Strong"
                }
              }
            }
          },
          "400": {
            "description": "No character type selected, a length outside 4 to 128 or shorter than the number of selected types, a count outside 1 to 10, or settings that leave fewer than 2 possible characters; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/lorem": {
      "post": {
        "summary": "Generate lorem ipsum placeholder paragraphs",
        "operationId": "textLorem",
        "description": "Generate lorem ipsum placeholder paragraphs. Send JSON with no required fields; optional: paragraphs, wordsPerParagraph, startWithLorem. Returns JSON with the answer as a string in result. Limits: paragraphs: at most 50, at least 1; wordsPerParagraph: at most 500, at least 5. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "paragraphs": {
                    "type": "number",
                    "minimum": 1,
                    "maximum": 50
                  },
                  "wordsPerParagraph": {
                    "type": "number",
                    "minimum": 5,
                    "maximum": 500
                  },
                  "startWithLorem": {
                    "type": "boolean"
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "paragraphs": 2,
                "wordsPerParagraph": 30,
                "startWithLorem": true
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "string",
                      "description": "The placeholder paragraphs, separated by blank lines"
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Lorem ipsum generator client and server side from freedailypro",
                  "result": "Lorem ipsum dolor sit amet nisi ullamco ipsum tempor incididunt ut quis pariatur aliqua proident veniam id ipsum cillum reprehenderit tempor deserunt consectetur aliquip deserunt ad ea anim sed lorem.\n\nEt mollit pariatur dolor amet consectetur fugiat aliqua cillum anim veniam aliqua enim dolore labo..."
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/reverse": {
      "post": {
        "summary": "Reverse text by characters, words or lines",
        "operationId": "textReverse",
        "description": "Reverse text by characters, words or lines. Send JSON with text (required); optional: mode. Returns JSON with the answer as a string in result. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string"
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "characters",
                      "words",
                      "lines"
                    ]
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "stressed desserts",
                "mode": "characters"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "mode": {
                      "type": "string",
                      "description": "characters, words or lines"
                    },
                    "result": {
                      "type": "string",
                      "description": "The reversed text; mode characters reverses whole emoji and accented letters, not their parts"
                    }
                  },
                  "required": [
                    "result",
                    "mode"
                  ]
                },
                "example": {
                  "tool": "Text reverser client and server side from freedailypro",
                  "mode": "characters",
                  "result": "stressed desserts"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/sort": {
      "post": {
        "summary": "Sort lines or words of text, optionally removing duplicates",
        "operationId": "textSort",
        "description": "Sort lines or words of text, optionally removing duplicates. Send JSON with text (required); optional: order, mode, caseSensitive, unique. Returns JSON with the answer as a string in result. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string"
                  },
                  "order": {
                    "type": "string",
                    "enum": [
                      "asc",
                      "desc"
                    ]
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "lines",
                      "words"
                    ]
                  },
                  "caseSensitive": {
                    "type": "boolean"
                  },
                  "unique": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "pear\napple\nbanana\napple",
                "order": "asc",
                "mode": "lines",
                "unique": true
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "string",
                      "description": "The sorted text, one item per line"
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Text sorter client and server side from freedailypro",
                  "result": "apple\nbanana\npear"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/hash": {
      "post": {
        "summary": "Hash text with MD5, SHA-1, SHA-256, SHA-384 or SHA-512",
        "operationId": "securityHash",
        "description": "Hash text with MD5, SHA-1, SHA-256, SHA-384 or SHA-512. Send JSON with text (required); optional: algorithm. Returns JSON with the answer as a string in result. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text",
          "Security & Developer Utilities"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string"
                  },
                  "algorithm": {
                    "type": "string",
                    "enum": [
                      "md5",
                      "sha1",
                      "sha256",
                      "sha384",
                      "sha512"
                    ]
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "hello world",
                "algorithm": "sha256"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Hash generator client and server side from freedailypro",
                  "algorithm": "sha256",
                  "result": "b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/uuid": {
      "post": {
        "summary": "Generate one or more random version 4 UUIDs",
        "operationId": "securityUuid",
        "description": "Generate one or more random version 4 UUIDs. Send JSON with no required fields; optional: count. Returns JSON: a list. Limits: count: at most 1000, at least 1. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text",
          "Security & Developer Utilities"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "count": {
                    "description": "How many random version 4 UUIDs, a whole number from 1 to 1000 (default 1). A fraction such as 2.5 or a value outside 1-1000 is a 400. count 1 (or omitted) returns 'result' as a single string; 2 or more returns an array of strings.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 1000
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "count": 3
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Uuid generator client and server side from freedailypro",
                  "result": [
                    "d16bc9ea-bbe9-4255-a727-4c2ba81d14a1",
                    "e65b9b37-e1e3-42bf-b3a9-24b382c2ac26",
                    "c4ce58d7-46c7-45b6-8d79-b78b971c2112"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/base64": {
      "post": {
        "summary": "Encode text to Base64 or decode Base64 back to text",
        "operationId": "securityBase64",
        "description": "Encode text to Base64 or decode Base64 back to text. Send JSON with text, action (required). Returns JSON with the answer as a string in result. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text",
          "Security & Developer Utilities"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "For 'encode': any text (encoded as UTF-8). For 'decode': Base64, standard (+ /) or URL-safe (- _), with or without '=' padding; line breaks and spaces are ignored. Text with characters outside the Base64 alphabet, wrong padding, an impossible length, or bytes that are not UTF-8 text is a 400 ({error, code: 'invalid_base64'})."
                  },
                  "action": {
                    "type": "string",
                    "enum": [
                      "encode",
                      "decode"
                    ],
                    "description": "encode: text to Base64. decode: Base64 to text."
                  }
                },
                "required": [
                  "text",
                  "action"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "FreeDailyPro",
                "action": "encode"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Base64 tool client and server side from freedailypro",
                  "action": "encode",
                  "result": "RnJlZURhaWx5UHJv"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/json-format": {
      "post": {
        "summary": "Validate JSON and return it pretty-printed with the indent you choose",
        "operationId": "securityJsonFormat",
        "description": "Validate JSON and return it pretty-printed with the indent you choose. Send JSON with text (required); optional: indent. Returns JSON with valid, formatted, stats. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text",
          "Security & Developer Utilities"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string"
                  },
                  "indent": {
                    "anyOf": [
                      {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 8
                      },
                      {
                        "type": "string",
                        "enum": [
                          "minify"
                        ]
                      }
                    ]
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "{\"name\":\"Ada\",\"skills\":[\"math\",\"code\"],\"active\":true}",
                "indent": 2
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Json formatter client and server side from freedailypro",
                  "valid": true,
                  "formatted": "{\n  \"name\": \"Ada\",\n  \"skills\": [\n    \"math\",\n    \"code\"\n  ],\n  \"active\": true\n}",
                  "stats": {
                    "keys": 3,
                    "depth": 3
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/regex": {
      "post": {
        "summary": "Test a regular expression against text and return the matches and groups",
        "operationId": "securityRegex",
        "description": "Test a regular expression against text and return the matches and groups. Send JSON with pattern, text (required); optional: flags. Returns JSON with valid, matches, matchCount, groups. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text",
          "Security & Developer Utilities"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pattern": {
                    "type": "string",
                    "minLength": 1,
                    "description": "The regular expression (JavaScript syntax), up to 2,000 characters (longer is a 422 Unprocessable Content, not billed). A pattern that does not compile is a 400 with {error, code: 'invalid_regex', valid: false}."
                  },
                  "text": {
                    "type": "string",
                    "description": "The text to search, up to 1,000,000 characters (longer is a 422 Unprocessable Content, not billed). At most 100,000 matches are returned; when the limit is hit the response has truncated: true and matchLimit."
                  },
                  "flags": {
                    "description": "Optional flags, each at most once: g (all matches), i (ignore case), m (multiline), s (dot matches newline), u (unicode), y (sticky). Default 'g'. An unknown or repeated flag is a 400 ({error, code: 'invalid_flags'}); send an empty string for no flags (first match only).",
                    "type": "string"
                  }
                },
                "required": [
                  "pattern",
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "pattern": "(\\d{4})-(\\d{2})-(\\d{2})",
                "text": "Invoice dated 2026-10-30, due 2026-11-29.",
                "flags": "g"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Regex tester client and server side from freedailypro",
                  "valid": true,
                  "matches": [
                    "2026-10-30",
                    "2026-11-29"
                  ],
                  "matchCount": 2,
                  "groups": [
                    [
                      "2026",
                      "10",
                      "30"
                    ],
                    [
                      "2026",
                      "11",
                      "29"
                    ]
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/url": {
      "post": {
        "summary": "URL-encode or decode text",
        "operationId": "securityUrl",
        "description": "URL-encode or decode text. Send JSON with text, action (required); optional: component. Returns JSON with the answer as a string in result. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text",
          "Security & Developer Utilities"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "The text to percent-encode, or the percent-encoded text to decode. Decoding text with a malformed sequence (a lone % or %zz) or bytes that are not UTF-8 is a 400 ({error, code: 'invalid_url_encoding'})."
                  },
                  "action": {
                    "type": "string",
                    "enum": [
                      "encode",
                      "decode"
                    ],
                    "description": "encode: text to percent-encoding. decode: percent-encoding back to text."
                  },
                  "component": {
                    "description": "true (default): treat the text as one URL part (encodeURIComponent / decodeURIComponent), so / ? & = # are encoded. false: treat it as a whole URL (encodeURI / decodeURI), keeping those characters.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "text",
                  "action"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "name=Ana María&city=São Paulo",
                "action": "encode",
                "component": true
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Url encoder client and server side from freedailypro",
                  "action": "encode",
                  "result": "name%3DAna%20Mar%C3%ADa%26city%3DS%C3%A3o%20Paulo"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/timestamp": {
      "post": {
        "summary": "Convert a Unix timestamp or ISO date to Unix seconds, milliseconds, ISO and UTC text",
        "operationId": "securityTimestamp",
        "description": "Convert a Unix timestamp or ISO date to Unix seconds, milliseconds, ISO and UTC text. Send JSON with input (required). Returns JSON with unixSeconds, unixMilliseconds, iso, utc. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text",
          "Time Zones & Dates"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "input": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      }
                    ],
                    "description": "A Unix timestamp (a number or digits; more than 1e12 is read as milliseconds, otherwise seconds) or a date text. ISO 8601 such as 2026-10-30, 2026-10-30T12:00:00Z or 2026-10-30T12:00:00+02:00 is checked part by part: a date that does not exist (2023-02-29, month 13, 25:00) is a 400 ({error, code: 'invalid_timestamp'}) instead of being moved to the next month. Other date formats are read by the JavaScript date parser."
                  }
                },
                "required": [
                  "input"
                ],
                "additionalProperties": false
              },
              "example": {
                "input": "2026-10-30T12:00:00Z"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Timestamp converter client and server side from freedailypro",
                  "unixSeconds": 1793361600,
                  "unixMilliseconds": 1793361600000,
                  "iso": "2026-10-30T12:00:00.000Z",
                  "utc": "Fri, 30 Oct 2026 12:00:00 GMT"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/percentage": {
      "post": {
        "summary": "Calculate a percent of a number, what percent one number is of another, a change, percentage points or basis points, with the working",
        "operationId": "convertersPercentage",
        "description": "Eight percentage operations in one endpoint, each returning the answer in 'result' and the working in 'steps' (an ordered list of { label, formula, inputs, result }). 'a' and 'b' mean different things per operation: percentageOf (a is the part, b the whole: what percent a is of b), whatIsPercentOf (a percent of b), percentChange (change from a to b, measured against the size of a), percentagePoints (a and b are themselves percentages: the change in percentage points, plus 'relativeChangePct'; 10 to 12 is +2 points and +20%), changeByPercent (raise or lower the number a by b percent; 'direction' increase or decrease), originalValue (the value before a was raised or lowered by b percent), percentDifference (symmetric difference of a and b against their average) and solveNumber (the number that a percent of gives b). 'unit' percent (default), permille or bps (basis points; 25 bps of 10,000 is 25) applies to percentageOf, whatIsPercentOf and solveNumber. Who calls it: pricing and discount engines, finance dashboards that report rate changes in points and basis points, invoicing and reporting tools that need the working shown next to a figure, and chatbots or MCP agents that must not do arithmetic themselves. Worked example: POST {\"operation\":\"percentageOf\",\"a\":15,\"b\":240} returns result 6.25 with two steps (15 / 240 = 0.0625, then x 100 = 6.25%). Integration scenario: a loan tool shows 'your rate rose from 6.5% to 6.75%'; call percentagePoints with a 6.5 and b 6.75 to get +0.25 points (25 bps as whatIsPercentOf with unit bps) and a relative change of +3.85%. These are the same functions the FreeDailyPro website calculator runs, so the site and the API always agree. Pure arithmetic: no external data, no tax year, nothing to update. Division by zero (a whole of 0, a starting value of 0, a percent of 0 for solveNumber), a decrease of more than 100%, non-finite numbers, and a unit or direction sent with an operation that does not use it are rejected with a 400 and a plain-words message; the API never returns NaN, Infinity or null. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Everyday Math"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "operation": {
                    "type": "string",
                    "enum": [
                      "percentageOf",
                      "whatIsPercentOf",
                      "percentChange",
                      "percentagePoints",
                      "changeByPercent",
                      "originalValue",
                      "percentDifference",
                      "solveNumber"
                    ],
                    "description": "percentageOf: what percent a is of b. whatIsPercentOf: a percent of b. percentChange: change from a to b. percentagePoints: both a and b are percentages; returns the change in percentage points. changeByPercent: raise or lower the number a by b percent. originalValue: the value before a was raised or lowered by b percent. percentDifference: symmetric difference of a and b. solveNumber: the number that a percent of gives b."
                  },
                  "a": {
                    "type": "number",
                    "description": "First value. What it means depends on the operation (see operation)."
                  },
                  "b": {
                    "type": "number",
                    "description": "Second value. What it means depends on the operation (see operation)."
                  },
                  "unit": {
                    "description": "percent (default), permille (parts per thousand) or bps (basis points). Only for percentageOf, whatIsPercentOf and solveNumber.",
                    "type": "string",
                    "enum": [
                      "percent",
                      "permille",
                      "bps"
                    ]
                  },
                  "direction": {
                    "description": "Only for changeByPercent and originalValue. Default increase.",
                    "type": "string",
                    "enum": [
                      "increase",
                      "decrease"
                    ]
                  }
                },
                "required": [
                  "operation",
                  "a",
                  "b"
                ],
                "additionalProperties": false
              },
              "example": {
                "operation": "percentageOf",
                "a": 15,
                "b": 240
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Percentage calculator client and server side from freedailypro",
                  "operation": "percentageOf",
                  "result": 6.25,
                  "steps": [
                    {
                      "label": "Divide the part by the whole",
                      "formula": "part / whole",
                      "inputs": {
                        "part": "15",
                        "whole": "240"
                      },
                      "result": "0.0625"
                    },
                    {
                      "label": "Multiply by 100",
                      "formula": "ratio x 100",
                      "inputs": {
                        "ratio": "0.0625"
                      },
                      "result": "6.25%"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "A missing or non-numeric a or b, an unknown operation, unit or direction, a unit or direction sent to an operation that does not use it, or input with no answer (division by zero, a decrease over 100%); the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/tip": {
      "post": {
        "summary": "Calculate the tip, total and per-person amount, compare percentages, split unevenly, apply service presets or work out the tip left",
        "operationId": "convertersTip",
        "description": "Send 'bill' and 'tipPercent' (and 'people' to split evenly) for the tip, the total and the per-person amount, with a 'steps' array that shows the working. Optional fields: 'tax' (added to the total; 'tipOnPreTax' true, the default with extras, works the tip on the bill before tax, false works it on bill plus tax); 'comparePercents' (up to 10 percentages; default 10, 15, 18, 20, 25) returns 'comparison' with the tip, total and per-person amount at each; 'service' (restaurant, delivery, bar, salon, taxi, housekeeping) returns the usual range and a one-line norm and supplies the suggested percentage when tipPercent is not sent (housekeeping suggests a flat amount per night); 'currency' (a three-letter code such as JPY) returns 'customs' for that currency's main country (expected, optional, included or not customary); 'items' (one amount per person) returns 'uneven': each person pays their own amount plus a pro-rata share of tax and tip, shares add up to the total exactly; 'paid' (the total that was paid) returns 'impliedTip' and 'impliedTipPercent'. Who calls it: restaurant and delivery apps, bill-splitting and expense apps, travel guides that show local tipping customs next to a calculator, point-of-sale prompts, and chatbots or MCP agents. Worked examples: {\"bill\":50,\"tipPercent\":18} returns a comparison with 15% at tip 7.5, total 57.5 and 25% at tip 12.5, total 62.5; {\"bill\":90,\"tipPercent\":20,\"items\":[20,30,40]} returns uneven shares 24, 36 and 48 (total 108); {\"bill\":50,\"paid\":60} returns impliedTipPercent 20. Integration scenario: a bill-splitting app lets each friend enter what they ordered and calls the endpoint once with 'items' and the tax; every person's exact amount comes back and the amounts add up to the cent. Service ranges are common US etiquette guidance (consumer etiquette guides such as the Emily Post Institute) and country notes are general customs; both are conventions, not rules, and they are held in one table file shared with the FreeDailyPro website calculator, reviewed by FreeDailyPro when customs change. The arithmetic is in cents so shares always add up. Requests with no answer (no tipPercent, service or paid; a paid amount below the bill plus tax; items whose count differs from people; a bill of 0 in reverse mode) are rejected with a 400 and a plain-words message. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Everyday Math"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "bill": {
                    "type": "number",
                    "minimum": 0,
                    "description": "The bill before tip (and before tax when 'tax' is sent separately)."
                  },
                  "tipPercent": {
                    "description": "Tip percentage. Required unless 'service' or 'paid' is sent.",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "people": {
                    "description": "Number of people splitting the bill. Default 1 (or the length of 'items').",
                    "type": "number",
                    "minimum": 1,
                    "maximum": 100
                  },
                  "tax": {
                    "description": "Tax amount. Added to the total; the tip is on the pre-tax bill unless tipOnPreTax is false.",
                    "type": "number",
                    "minimum": 0
                  },
                  "tipOnPreTax": {
                    "description": "Whether the tip is worked out on the bill before tax (true, the default when extras are used) or on bill plus tax (false).",
                    "type": "boolean"
                  },
                  "comparePercents": {
                    "description": "Percentages to compare at once. Default 10, 15, 18, 20 and 25. Returns 'comparison' with the tip, total and per-person amount at each.",
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "number",
                      "minimum": 0,
                      "maximum": 100
                    }
                  },
                  "items": {
                    "description": "Uneven split: each person's own amount, one per person. Each pays their own amount plus a pro-rata share of tax and tip; shares add up exactly.",
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "number",
                      "minimum": 0
                    }
                  },
                  "paid": {
                    "description": "Reverse mode: the total that was paid. Returns impliedTip and impliedTipPercent for the bill (and tax).",
                    "type": "number",
                    "minimum": 0
                  },
                  "service": {
                    "description": "A service preset: returns its usual range and note, and uses its suggested percentage (or flat amount for housekeeping) when tipPercent is not sent.",
                    "type": "string",
                    "enum": [
                      "restaurant",
                      "delivery",
                      "bar",
                      "salon",
                      "taxi",
                      "housekeeping"
                    ]
                  },
                  "currency": {
                    "description": "A three-letter currency code, for example JPY. Returns 'customs': whether tipping is customary in that currency's main country.",
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 3
                  }
                },
                "required": [
                  "bill"
                ],
                "additionalProperties": false
              },
              "example": {
                "bill": 86.5,
                "tipPercent": 18,
                "people": 3
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Tip calculator client and server side from freedailypro",
                  "result": {
                    "tipAmount": 15.57,
                    "total": 102.07,
                    "perPerson": 34.02333333333333,
                    "steps": [
                      {
                        "label": "Amount the tip is based on",
                        "formula": "bill (before tax)",
                        "inputs": {
                          "bill": "86.50",
                          "tax": "0.00"
                        },
                        "result": "86.50"
                      },
                      {
                        "label": "Tip",
                        "formula": "base x tip % / 100",
                        "inputs": {
                          "base": "86.50",
                          "tip %": "18%"
                        },
                        "result": "15.57"
                      },
                      {
                        "label": "Total",
                        "formula": "bill + tax + tip",
                        "inputs": {
                          "bill": "86.50",
                          "tax": "0.00",
                          "tip": "15.57"
                        },
                        "result": "102.07"
                      },
                      {
                        "label": "Per person",
                        "formula": "total / people, shared out in cents so the shares add up exactly",
                        "inputs": {
                          "total": "102.07",
                          "people": 3
                        },
                        "result": "34.03 or 34.02"
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing tipPercent (with no service or paid), a value out of range, items whose length differs from people, a paid amount below the bill plus tax, a bill of 0 in reverse mode, or an unknown service; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/bmi": {
      "post": {
        "summary": "Calculate BMI, category, BMI Prime, Ponderal Index, WHO class, waist-to-height ratio and target weight in metric or imperial units",
        "operationId": "convertersBmi",
        "description": "Send 'weight' and 'height' (metric kg and cm by default, or 'unit': imperial for pounds and inches). Returns 'bmi' (one decimal) and 'category' as before, plus 'bmiPrime' (BMI / 25), 'ponderalIndex' (kg per m3), 'whoClass' and 'whoRange' (the eight-class WHO adult table), 'healthyWeightRange' (BMI 18.5 to 24.9 at this height) and a 'steps' array that shows the working. Optional 'waist' (same units as height) adds 'waistToHeightRatio', its band and a note. Optional 'targetBmi' (10 to 60) or 'targetBmiPrime' adds 'target': the weight that gives that BMI at this height and the change from now (negative means lose). Who calls it: health, fitness and nutrition apps, telehealth intake forms, wellness and insurance onboarding flows, workplace wellbeing dashboards, and chatbots or MCP agents. Worked examples: {\"weight\":72.57,\"height\":177.8} returns bmi 23, bmiPrime 0.92, ponderalIndex 12.9 and whoClass 'Normal range'; {\"weight\":90,\"height\":180,\"targetBmi\":24.9} returns target.targetWeightKg 80.7 and changeKg -9.3; {\"weight\":70,\"height\":170,\"waist\":85} returns waistToHeightRatio 0.5. Integration scenario: an onboarding form collects height, weight and waist and shows the person their BMI class, their ratio and the weight range for their height in one call, with the working behind each figure. Sources: WHO adult BMI classification (WHO Technical Report Series 894, 2000); BMI Prime and Ponderal Index are the standard definitions (BMI / 25 and kg / m3); the waist-to-height bands (0.4 and 0.5 and 0.6) are the common 0.5 guideline. These are the same functions the FreeDailyPro website calculator runs. BMI is a screening number, not a diagnosis, and it does not apply to children and teenagers: this endpoint gives adult figures only and does not provide child or teen percentiles. Weight outside 2 to 700 kg, height outside 50 to 272 cm (inches 20 to 107), a waist outside 10 to 300 cm, a target BMI outside 10 to 60, or both targetBmi and targetBmiPrime are rejected with a 400 and a plain-words message. Nothing to update: the class table is fixed by WHO. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Fitness & Health"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "weight": {
                    "type": "number",
                    "description": "Weight in kg (metric) or pounds (imperial). Metric 2 to 700 kg, imperial 4 to 1500 lb.",
                    "minimum": 0
                  },
                  "height": {
                    "type": "number",
                    "description": "Height in cm (metric) or inches (imperial). Metric 50 to 272 cm, imperial 20 to 107 in.",
                    "minimum": 0
                  },
                  "unit": {
                    "description": "metric (kg and cm, the default) or imperial (lb and inches).",
                    "type": "string",
                    "enum": [
                      "metric",
                      "imperial"
                    ]
                  },
                  "waist": {
                    "description": "Optional waist in cm (metric) or inches (imperial). Adds the waist-to-height ratio and its band.",
                    "type": "number",
                    "minimum": 0
                  },
                  "targetBmi": {
                    "description": "Optional target BMI (10 to 60). Adds the weight that gives it at this height and the change from now.",
                    "type": "number",
                    "minimum": 0
                  },
                  "targetBmiPrime": {
                    "description": "Optional target BMI Prime (target BMI / 25). Send this or targetBmi, not both.",
                    "type": "number",
                    "minimum": 0
                  }
                },
                "required": [
                  "weight",
                  "height"
                ],
                "additionalProperties": false
              },
              "example": {
                "weight": 70,
                "height": 175,
                "unit": "metric"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Bmi calculator client and server side from freedailypro",
                  "result": {
                    "bmi": 22.9,
                    "category": "Normal",
                    "bmiPrime": 0.91,
                    "ponderalIndex": 13.1,
                    "whoClass": "Normal range",
                    "whoRange": "18.5 to 24.99",
                    "healthyWeightRange": {
                      "lowKg": 56.7,
                      "highKg": 76.3
                    },
                    "steps": [
                      {
                        "label": "Height in metres",
                        "formula": "height in cm / 100",
                        "inputs": {
                          "cm": 175
                        },
                        "result": 1.75
                      },
                      {
                        "label": "BMI",
                        "formula": "weight in kg / (height in m)^2",
                        "inputs": {
                          "weight": "70.0 kg",
                          "height": "1.75 m"
                        },
                        "result": "22.9"
                      },
                      {
                        "label": "BMI Prime",
                        "formula": "BMI / 25",
                        "inputs": {
                          "BMI": "22.9"
                        },
                        "result": "0.91"
                      },
                      {
                        "label": "Ponderal Index",
                        "formula": "weight in kg / (height in m)^3",
                        "inputs": {
                          "weight": "70.0 kg",
                          "height": "1.75 m"
                        },
                        "result": "13.1 kg/m3"
                      },
                      {
                        "label": "WHO class",
                        "formula": "the WHO adult BMI table row that contains the BMI",
                        "inputs": {
                          "BMI": "22.9"
                        },
                        "result": "Normal range (18.5 to 24.99)"
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "A missing or non-positive weight or height, a value outside the measurable range, a target BMI outside 10 to 60, or both targetBmi and targetBmiPrime; the body says which field"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/length": {
      "post": {
        "summary": "Convert a length between metres, kilometres, inches, feet, yards and miles",
        "operationId": "convertersLength",
        "description": "Convert a length between metres, kilometres, inches, feet, yards and miles. Send JSON with value, from, to (required). Returns JSON with the answer as a number in result. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Unit Conversion"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "value": {
                    "type": "number"
                  },
                  "from": {
                    "type": "string",
                    "enum": [
                      "m",
                      "cm",
                      "mm",
                      "km",
                      "in",
                      "ft",
                      "yd",
                      "mi"
                    ]
                  },
                  "to": {
                    "type": "string",
                    "enum": [
                      "m",
                      "cm",
                      "mm",
                      "km",
                      "in",
                      "ft",
                      "yd",
                      "mi"
                    ]
                  }
                },
                "required": [
                  "value",
                  "from",
                  "to"
                ],
                "additionalProperties": false
              },
              "example": {
                "value": 5,
                "from": "mi",
                "to": "km"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Unit converter (length) client and server side from freedailypro",
                  "result": 8.04672
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/weight": {
      "post": {
        "summary": "Convert a weight between kilograms, grams, pounds and ounces",
        "operationId": "convertersWeight",
        "description": "Convert a weight between kilograms, grams, pounds and ounces. Send JSON with value, from, to (required). Returns JSON with the answer as a number in result. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Unit Conversion"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "value": {
                    "type": "number"
                  },
                  "from": {
                    "type": "string",
                    "enum": [
                      "kg",
                      "g",
                      "mg",
                      "lb",
                      "oz"
                    ]
                  },
                  "to": {
                    "type": "string",
                    "enum": [
                      "kg",
                      "g",
                      "mg",
                      "lb",
                      "oz"
                    ]
                  }
                },
                "required": [
                  "value",
                  "from",
                  "to"
                ],
                "additionalProperties": false
              },
              "example": {
                "value": 150,
                "from": "lb",
                "to": "kg"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Unit converter (weight) client and server side from freedailypro",
                  "result": 68.0388555
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/temperature": {
      "post": {
        "summary": "Convert a temperature between Celsius, Fahrenheit and Kelvin",
        "operationId": "convertersTemperature",
        "description": "Convert a temperature between Celsius, Fahrenheit and Kelvin. Send JSON with value, from, to (required). Returns JSON with the answer as a number in result. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Unit Conversion"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "value": {
                    "type": "number"
                  },
                  "from": {
                    "type": "string",
                    "enum": [
                      "C",
                      "F",
                      "K"
                    ]
                  },
                  "to": {
                    "type": "string",
                    "enum": [
                      "C",
                      "F",
                      "K"
                    ]
                  }
                },
                "required": [
                  "value",
                  "from",
                  "to"
                ],
                "additionalProperties": false
              },
              "example": {
                "value": 72,
                "from": "F",
                "to": "C"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Unit converter (temperature) client and server side from freedailypro",
                  "result": 22.22222222222222
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/loan": {
      "post": {
        "summary": "Calculate a loan payment, with payment frequency, compounding, solve for amount, term or rate, fees and APR, deferred and zero-coupon loans",
        "operationId": "convertersLoan",
        "description": "Without any of the extra fields it is the plain monthly loan: send principal, annualRatePercent and years and get monthlyPayment, totalPayment, totalInterest, an optional schedulePreview (previewMonths up to 12) and dates (firstPaymentDate), plus a 'steps' array that shows the working. The extra fields are all optional. 'paymentFrequency' monthly (default), biweekly (every 14 days, 26 a year) or weekly (52 a year) returns the level payment for that frequency ('payment', 'numberOfPayments', 'totalInterest'; biweekly payments are re-calculated for 26 periods, they are not half of the monthly payment). 'compounding' payment (default, the standard EMI), annual, monthly, daily or continuous sets how interest compounds; the rate per payment is (1 + r/m)^(m/f) - 1. 'solveFor' amount, term or rate works backwards from a target 'payment' and the other two of principal, annualRatePercent and years (term comes back in years, rate in percent). 'fee' (an upfront fee taken out of the loan) adds 'moneyReceived' and 'apr', the annual rate at which the payments are worth exactly the money received (the actuarial method of Regulation Z, 12 CFR 1026 Appendix J; a lender's own quoted APR can differ when other charges or an odd first period apply). 'loanType' deferred returns 'dueAtMaturity' and 'interest' for a loan paid in one lump sum at the end; zeroCoupon returns the 'presentValue' (price today) of a face value paid at maturity (send the face value as principal and the yield as annualRatePercent). Who calls it: loan and mortgage comparison sites, personal-finance apps, lender and broker widgets, accounting and budgeting tools that need a payment or an APR with the working shown, and chatbots or MCP agents. Worked examples: {\"principal\":100000,\"annualRatePercent\":5,\"years\":30,\"paymentFrequency\":\"biweekly\"} returns payment 247.64 over 780 payments with 93162.51 total interest (the monthly loan is 536.82 and 93255.78); {\"principal\":10000,\"annualRatePercent\":10,\"years\":3,\"fee\":300} returns payment 322.67, moneyReceived 9700 and apr 12.1064; {\"solveFor\":\"rate\",\"payment\":536.82,\"principal\":100000,\"years\":30} returns value 5 with unit percent; {\"loanType\":\"deferred\",\"principal\":100000,\"annualRatePercent\":6,\"years\":10} returns dueAtMaturity 179084.77. Integration scenario: a comparison page shows two offers, each with a quoted rate and an origination fee; call the endpoint once per offer with the fee to show the true APR and the payment side by side. These are the same functions the FreeDailyPro website calculator runs. Pure arithmetic: no external data or tax year, nothing to update. Requests with no answer (a payment that does not cover the interest, a fee as large as the loan, a payment sent without solveFor, a field that does not apply to the loan type, compounding 'payment' for a deferred loan, an impossible date) are rejected with a 400 and a plain-words message; the API never returns NaN or Infinity. Stateless: the request is processed in memory and nothing is stored. Merged service: the same calculation is offered inside /v1/converters/loan-interest (send kind \"loan\"), which does more; this path keeps working and returns the same response as before.",
        "tags": [
          "Calculators",
          "Mortgage & Loans"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "principal": {
                    "description": "Loan amount. Required except when solveFor is 'amount'. For loanType 'zeroCoupon' it is the face value paid at maturity.",
                    "type": "number",
                    "minimum": 0
                  },
                  "annualRatePercent": {
                    "description": "Annual interest rate in percent. Required except when solveFor is 'rate'. For 'zeroCoupon' it is the yield.",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "years": {
                    "description": "Term in years. Required except when solveFor is 'term'.",
                    "type": "number",
                    "maximum": 50,
                    "minimum": 0
                  },
                  "previewMonths": {
                    "description": "Number of schedule rows to return, 0 to 12 (payments, whatever the frequency).",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 12
                  },
                  "firstPaymentDate": {
                    "description": "Optional date the first payment is due, as YYYY-MM-DD. Adds a date to every schedulePreview row and returns firstPaymentDate, lastPaymentDate and payoffDate. It only labels the schedule; amounts never change. A payment on the 29th to 31st lands on the last day of shorter months.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  "paymentFrequency": {
                    "description": "How often payments are made: monthly (12 a year, the default), biweekly (every 14 days, 26 a year) or weekly (52 a year).",
                    "type": "string",
                    "enum": [
                      "monthly",
                      "biweekly",
                      "weekly"
                    ]
                  },
                  "compounding": {
                    "description": "How interest compounds. 'payment' (the default) compounds on every payment, which gives the standard EMI for monthly payments. 'annual', 'monthly', 'daily' and 'continuous' use the effective rate per payment period. Deferred loans and zero-coupon bonds need annual, monthly, daily or continuous (default annual).",
                    "type": "string",
                    "enum": [
                      "payment",
                      "annual",
                      "monthly",
                      "daily",
                      "continuous"
                    ]
                  },
                  "loanType": {
                    "description": "amortized (default): level payments. deferred: nothing is paid until maturity, when principal and compounded interest are due. zeroCoupon: the price today of a bond that pays principal (the face value) at maturity at the given yield.",
                    "type": "string",
                    "enum": [
                      "amortized",
                      "deferred",
                      "zeroCoupon"
                    ]
                  },
                  "fee": {
                    "description": "Upfront fee taken out of the loan (amortized loans). Adds apr and moneyReceived to the result.",
                    "type": "number",
                    "minimum": 0
                  },
                  "solveFor": {
                    "description": "What to solve for (amortized loans). payment (default) works out the payment from amount, rate and term. amount, term or rate are solved from a target 'payment' and the other two inputs.",
                    "type": "string",
                    "enum": [
                      "payment",
                      "amount",
                      "term",
                      "rate"
                    ]
                  },
                  "payment": {
                    "description": "Target payment per period. Only with solveFor amount, term or rate.",
                    "type": "number",
                    "minimum": 0
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "principal": 250000,
                "annualRatePercent": 6.5,
                "years": 30,
                "previewMonths": 3,
                "firstPaymentDate": "2026-12-01"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Loan calculator client and server side from freedailypro",
                  "result": {
                    "monthlyPayment": 1580.17,
                    "totalPayment": 568861.22,
                    "totalInterest": 318861.22,
                    "schedulePreview": [
                      {
                        "month": 1,
                        "principal": 226,
                        "interest": 1354.17,
                        "balance": 249774,
                        "date": "2026-12-01"
                      },
                      {
                        "month": 2,
                        "principal": 227.23,
                        "interest": 1352.94,
                        "balance": 249546.77,
                        "date": "2027-01-01"
                      },
                      {
                        "month": 3,
                        "principal": 228.46,
                        "interest": 1351.71,
                        "balance": 249318.31,
                        "date": "2027-02-01"
                      }
                    ],
                    "firstPaymentDate": "2026-12-01",
                    "lastPaymentDate": "2056-11-01",
                    "payoffDate": "2056-11",
                    "steps": [
                      {
                        "label": "Rate per payment",
                        "formula": "annual rate / payments per year",
                        "inputs": {
                          "annual rate": "6.5%",
                          "payments per year": 12,
                          "compounding": "same as the payments"
                        },
                        "result": 0.00541667
                      },
                      {
                        "label": "Number of payments",
                        "formula": "years x payments per year",
                        "inputs": {
                          "years": 30,
                          "payments per year": 12
                        },
                        "result": 360
                      },
                      {
                        "label": "Payment",
                        "formula": "amount x i / (1 - (1 + i) ^ -n)",
                        "inputs": {
                          "amount": "250000.00",
                          "i": 0.00541667,
                          "n": 360
                        },
                        "result": "1580.17"
                      },
                      {
                        "label": "Total interest",
                        "formula": "add up the interest part of every payment",
                        "inputs": {
                          "payments": 360
                        },
                        "result": "318861.22"
                      },
                      {
                        "label": "Total paid",
                        "formula": "amount + total interest",
                        "inputs": {
                          "amount": "250000.00",
                          "total interest": "318861.22"
                        },
                        "result": "568861.22"
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "A missing required field for the chosen request, a value out of range, a field that does not apply (for example fee on a deferred loan, or payment without solveFor), a payment that never pays the loan off, a fee not smaller than the loan, or a bad firstPaymentDate; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/compound-interest": {
      "post": {
        "summary": "Calculate the future value and interest earned with compound interest",
        "operationId": "convertersCompoundInterest",
        "description": "Calculate the future value and interest earned with compound interest. Send JSON with principal, annualRatePercent, years (required); optional: frequency, startDate. Returns JSON with principal, futureValue, totalInterest, startDate, maturityDate (inside result). Limits: annualRatePercent: at most 100; years: at most 100. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored. Merged service: the same calculation is offered inside /v1/converters/loan-interest (send kind \"compound-interest\" (it adds monthly contributions, inflation and a yearly table)), which does more; this path keeps working and returns the same response as before.",
        "tags": [
          "Calculators",
          "Mortgage & Loans"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "principal": {
                    "type": "number",
                    "minimum": 0
                  },
                  "annualRatePercent": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "years": {
                    "type": "number",
                    "maximum": 100,
                    "minimum": 0
                  },
                  "frequency": {
                    "type": "string",
                    "enum": [
                      "annually",
                      "semiannually",
                      "quarterly",
                      "monthly",
                      "daily"
                    ]
                  },
                  "startDate": {
                    "description": "Optional start date, as YYYY-MM-DD. Adds startDate and maturityDate (the date the future value is reached). It only labels the timeline; the amounts do not change.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  }
                },
                "required": [
                  "principal",
                  "annualRatePercent",
                  "years"
                ],
                "additionalProperties": false
              },
              "example": {
                "principal": 10000,
                "annualRatePercent": 6,
                "years": 20,
                "frequency": "monthly",
                "startDate": "2026-11-01"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Compound interest calculator client and server side from freedailypro",
                  "result": {
                    "principal": 10000,
                    "futureValue": 33102.04,
                    "totalInterest": 23102.04,
                    "startDate": "2026-11-01",
                    "maturityDate": "2046-11-01"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/discount": {
      "post": {
        "summary": "Calculate the sale price and savings from a discount percentage or a sale price",
        "operationId": "convertersDiscount",
        "description": "Three ways in. (1) 'originalPrice' + 'discountPercent': the first version, unchanged (discountAmount, finalPrice, savingsPercent). (2) 'originalPrice' + 'salePrice': the discount percentage as before, plus 'amountOff' (the same saving as a fixed amount) and a plain-words 'note'. (3) NEW: 'originalPrice' + 'discounts', 1 to 5 entries of { type: percent or amount, value } applied one after the other IN THE ORDER SENT, each on the price left by the one before: 100 with 20% then 15 off is 65, but 15 off then 20% is 68. Optional 'taxPercent' is added on the discounted price. Returns 'discounts' (each with priceBefore, amountOff, priceAfter), 'finalPrice', 'totalSaved', 'effectivePercent', 'tax' and 'totalWithTax' when tax is sent, and a 'steps' array that shows the working. A discount that would take the price below 0 (for example 120 off a price of 100) is rejected; exactly 0 is allowed. Who calls it: shopping and coupon-stacking tools, price-comparison sites, checkout and promo-engine previews, small-retailer price tools, and chatbots or MCP agents. Worked examples: {\"originalPrice\":100,\"discounts\":[{\"type\":\"percent\",\"value\":20},{\"type\":\"amount\",\"value\":15}]} returns finalPrice 65, totalSaved 35 and effectivePercent 35; the same discounts in the other order with taxPercent 8 returns finalPrice 68, tax 5.44, totalWithTax 73.44; {\"originalPrice\":100,\"salePrice\":75} returns discountPercent 25 and amountOff 25. Integration scenario: a deals site shows a shopper the price after a store sale and a coupon code in the order the retailer applies them, with the working under it. Pure arithmetic on the numbers sent; the order is the caller's choice because retailers differ (check the retailer's terms), nothing to update. Estimate only. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Everyday Math"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "originalPrice": {
                    "type": "number",
                    "minimum": 0
                  },
                  "discountPercent": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "salePrice": {
                    "type": "number",
                    "minimum": 0
                  },
                  "discounts": {
                    "description": "Several discounts, each a percentage or a fixed amount, applied one after the other in the order sent (each on the price left by the one before). Use instead of discountPercent. The price may not go below 0.",
                    "minItems": 1,
                    "maxItems": 5,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "percent",
                            "amount"
                          ],
                          "description": "percent: value is a percentage off. amount: value is a fixed amount off, in the currency of originalPrice."
                        },
                        "value": {
                          "type": "number",
                          "minimum": 0
                        }
                      },
                      "required": [
                        "type",
                        "value"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "taxPercent": {
                    "description": "With discounts: tax added on the discounted price.",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  }
                },
                "required": [
                  "originalPrice"
                ],
                "additionalProperties": false
              },
              "example": {
                "originalPrice": 120,
                "discountPercent": 25
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Discount calculator client and server side from freedailypro",
                  "result": {
                    "discountAmount": 30,
                    "finalPrice": 90,
                    "savingsPercent": 25
                  }
                }
              }
            }
          },
          "400": {
            "description": "A missing originalPrice, a percentage outside 0 to 100, a negative amount, discounts sent together with discountPercent or salePrice, taxPercent without discounts, or a discount that takes the price below 0; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/simple-interest": {
      "post": {
        "summary": "Calculate simple interest and the total amount owed or earned",
        "operationId": "convertersSimpleInterest",
        "description": "Calculate simple interest and the total amount owed or earned. Send JSON with principal, annualRatePercent, years (required); optional: startDate. Returns JSON with principal, interest, totalAmount, startDate, maturityDate (inside result). Limits: annualRatePercent: at most 100; years: at most 100. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored. Merged service: the same calculation is offered inside /v1/converters/loan-interest (send kind \"simple-interest\"), which does more; this path keeps working and returns the same response as before.",
        "tags": [
          "Calculators",
          "Mortgage & Loans"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "principal": {
                    "type": "number",
                    "minimum": 0
                  },
                  "annualRatePercent": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "years": {
                    "type": "number",
                    "maximum": 100,
                    "minimum": 0
                  },
                  "startDate": {
                    "description": "Optional start date, as YYYY-MM-DD. Adds startDate and maturityDate (the date the total amount is reached). It only labels the timeline; the amounts do not change.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  }
                },
                "required": [
                  "principal",
                  "annualRatePercent",
                  "years"
                ],
                "additionalProperties": false
              },
              "example": {
                "principal": 10000,
                "annualRatePercent": 5,
                "years": 3,
                "startDate": "2026-11-01"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Simple interest calculator client and server side from freedailypro",
                  "result": {
                    "principal": 10000,
                    "interest": 1500,
                    "totalAmount": 11500,
                    "startDate": "2026-11-01",
                    "maturityDate": "2029-11-01"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/sales-tax": {
      "post": {
        "summary": "Calculate sales tax on an amount, adding or extracting tax, with US state base-rate lookup",
        "operationId": "convertersSalesTax",
        "description": "Adds sales tax to an amount ('mode' add, the default) or extracts it from a tax-inclusive amount (extract). Send 'taxPercent' to use your own rate, or 'state' (two-letter code such as TX, or the full name; 50 states and DC) to use that state's BASE sales tax rate. Only the state base rate is applied: city, county and special-district sales taxes are NOT included, because the right local rate depends on the exact address. The response also returns the state's average combined (state plus local) rate for reference, clearly labelled and never applied; for an exact local rate send taxPercent. 'taxPercent' wins if both are sent. Where the data comes from: Tax Foundation state sales tax tables (1 July 2026), a secondary source, so dataStatus is 'estimate'. Update process: one table file shared with the FreeDailyPro website, reviewed by FreeDailyPro each January and July. Exemptions (groceries, clothing, services) are not modelled. Estimate, not tax advice. Rate vintage: the response includes 'ratesAsOfDate' (the table's own date, 2026-07-01), 'ratesCheckedOn' (2026-10-30, when all 51 rows were compared with the Tax Foundation midyear 2026 table), 'ratesAgeDays', 'ratesStale' (true once the table is more than 200 days old, with a warning added to notes) and 'steps' (the working). Who calls it: checkout and quoting tools, invoicing and expense apps, shopping assistants and chatbots or MCP agents. Worked example: {\"amount\":100,\"state\":\"Louisiana\"} applies the 5% state base rate (tax 5, total 105) and returns averageCombinedRatePct 10.13 for reference; send taxPercent 10.13 to use the average combined rate instead. More options: 'zip' (a US ZIP code) finds the state; the rate is filled in only where it is exact: 0% for Delaware, New Hampshire and Oregon, or the state rate where the Tax Foundation midyear 2026 table shows no local add-on. For any other state a ZIP can cross city, county and district lines, so no rate is guessed: the call returns 400 with a message saying so unless you also send taxPercent or state (the response's 'zip' object then carries the message, source and the state's official lookup page where one was verified). 'items' (several items with price, qty and taxable true or false, plus shipping, shippingTaxable and discountPct) returns a 'cart' with taxable and exempt subtotals, tax, total, steps and lines; amount is then not needed. Items work with mode add only. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Currency & VAT"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "amount": {
                    "description": "Amount to tax (or the tax-inclusive amount in extract mode). Required unless items is sent.",
                    "type": "number",
                    "minimum": 0
                  },
                  "zip": {
                    "description": "US ZIP code (5 digits or ZIP+4). Used to find the STATE. The rate is filled in only where it is exact: 0% for DE, NH and OR, or the state rate for states with no local add-on in the Tax Foundation midyear 2026 table. For any other state no rate is guessed (a ZIP can cross city, county and district lines): the response's zip.message says so, and you send taxPercent or state. Response adds 'zip' with the state, status, message, source and the state's official lookup page where one was verified.",
                    "type": "string"
                  },
                  "items": {
                    "description": "Several items (mode add only). Response adds 'cart' with taxable and exempt subtotals, tax, total, steps and lines.",
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "price": {
                          "type": "number",
                          "minimum": 0
                        },
                        "qty": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 9007199254740991
                        },
                        "taxable": {
                          "description": "Default true. false marks the item exempt.",
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "price"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "shipping": {
                    "description": "With items: shipping charged.",
                    "type": "number",
                    "minimum": 0
                  },
                  "shippingTaxable": {
                    "description": "With items: true adds shipping to the taxable amount. Default false (rules differ by state, so you choose).",
                    "type": "boolean"
                  },
                  "discountPct": {
                    "description": "With items: percentage discount on every line.",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "taxPercent": {
                    "description": "Tax rate in percent. Required unless state or an exact zip is sent. Takes priority over state.",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "state": {
                    "description": "US state (two-letter code such as TX, or the full name; DC included). Looks up the STATE base sales tax rate only (Tax Foundation, 1 July 2026). Local city, county and district rates are not included.",
                    "type": "string"
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "add",
                      "extract"
                    ]
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "amount": 100,
                "state": "TX"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "result": {
                    "taxAmount": 6.25,
                    "total": 106.25,
                    "net": 100,
                    "ratePct": 6.25,
                    "rateSource": "US state base rate (local taxes excluded)",
                    "state": "Texas",
                    "stateBaseRatePct": 6.25,
                    "averageCombinedRatePct": 8.2,
                    "ratesAsOf": "Tax Foundation, 1 July 2026",
                    "taxYear": 2026,
                    "sources": "Tax Foundation sales tax tables (1 July 2026). Tax year 2026. FreeDailyPro table last checked 2026-10-11 (compiled from secondary sources, confirm with the authority). Next review: January and July. https://taxfoundation.org/data/all/state/sales-tax-rates/",
                    "dataStatus": "estimate",
                    "notes": [
                      "Rate used: Texas STATE base rate 6.25%. Local (city, county, district) sales taxes are not included; the average combined rate is 8.2% (reference only, not applied). For an exact local rate send taxPercent.",
                      "Some goods (groceries, clothing, services) are taxed at other rates or exempt, which is not modelled.",
                      "Texas is among the states carried from earlier Tax Foundation tables; the 1 July 2026 figure was not separately confirmed. Marked as an estimate."
                    ],
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Neither taxPercent nor state (nor an exact zip), a ZIP that is not 5 digits or has no single rate, a taxPercent outside 0 to 100, no amount and no items, or an unknown state"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/age": {
      "post": {
        "summary": "Calculate age in years, months and days between two dates",
        "operationId": "convertersAge",
        "description": "Calculate age in years, months and days between two dates. Send JSON with startDate (required); optional: endDate. Returns JSON with years, months, days, totalDays. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Time Zones & Dates"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "startDate": {
                    "type": "string"
                  },
                  "endDate": {
                    "type": "string"
                  }
                },
                "required": [
                  "startDate"
                ],
                "additionalProperties": false
              },
              "example": {
                "startDate": "1990-05-17",
                "endDate": "2026-10-30"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Age calculator client and server side from freedailypro",
                  "years": 36,
                  "months": 5,
                  "days": 13,
                  "totalDays": 13315
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/diff": {
      "post": {
        "summary": "Compare two texts line by line and return the added and removed lines",
        "operationId": "securityDiff",
        "description": "Compare two texts line by line and return the added and removed lines. Send JSON with textA, textB (required). Returns JSON with lines, added, removed, equal, changes, identical (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text",
          "Security & Developer Utilities"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "textA": {
                    "type": "string"
                  },
                  "textB": {
                    "type": "string"
                  }
                },
                "required": [
                  "textA",
                  "textB"
                ],
                "additionalProperties": false
              },
              "example": {
                "textA": "The cat sat on the mat.\nIt was warm.",
                "textB": "The cat sat on the rug.\nIt was warm.\nThe end."
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Diff checker client and server side from freedailypro",
                  "result": {
                    "lines": [
                      {
                        "type": "remove",
                        "line": "The cat sat on the mat.",
                        "lineNumberA": 1
                      },
                      {
                        "type": "add",
                        "line": "The cat sat on the rug.",
                        "lineNumberB": 1
                      },
                      {
                        "type": "equal",
                        "line": "It was warm.",
                        "lineNumberA": 2,
                        "lineNumberB": 2
                      },
                      "..."
                    ],
                    "added": 2,
                    "removed": 1,
                    "equal": 1,
                    "changes": 3,
                    "identical": false
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/password-strength": {
      "post": {
        "summary": "Rate the strength of a password and return entropy and improvement tips",
        "operationId": "securityPasswordStrength",
        "description": "Rate the strength of a password and return entropy and improvement tips. Send JSON with password (required). Returns JSON with score, label, entropyBitsApprox, feedback (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text",
          "Security & Developer Utilities"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "password": {
                    "type": "string",
                    "description": "The password to rate. It is rated in memory and never stored or logged. The estimate is character-pool entropy minus penalties for repetition (aaaa, abcabc), sequences and keyboard runs (1234, qwerty) and common passwords (including look-alike swaps such as P@ssw0rd and a trailing 1 or !). Labels by estimated bits: under 28 Very Weak, under 36 Weak, under 60 Fair, under 80 Strong, otherwise Very Strong. It cannot know passwords leaked in breaches."
                  }
                },
                "required": [
                  "password"
                ],
                "additionalProperties": false
              },
              "example": {
                "password": "correct-horse-battery-staple"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Password strength client and server side from freedailypro",
                  "result": {
                    "score": 3,
                    "label": "Strong",
                    "entropyBitsApprox": 164,
                    "feedback": [
                      "Add uppercase letters",
                      "Add numbers"
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/random": {
      "post": {
        "summary": "Generate random numbers in a range, optionally without repeats",
        "operationId": "convertersRandom",
        "description": "The first version's request ('min', 'max', 'count' up to 1000, 'unique') is unchanged and still returns 'result', an array of whole numbers; every response now also names the 'generator' and says whether it is 'secure'. Without a seed the numbers come from Node's crypto (a cryptographically secure generator): whole numbers use crypto.randomInt, and decimals and the presets use crypto.getRandomValues with rejection sampling so every value is equally likely. Additive fields: 'decimals' (0 to 10) draws from every number with that many decimal places between min and max, both ends included (the limits are rounded inward onto that grid), and returns 'result' as numbers plus 'resultText' with the exact text of each (1.100, not 1.1) and a 'steps' array that shows the working; 'sort' returns ascending order; 'seed' makes the draw repeatable (the same seed and request give the same numbers) but switches to sfc32, which is NOT cryptographically secure, and the response says so with secure false: never use a seed for a raffle, a secret or a password. 'mode' picks a preset: dice with 'dice' as NdM or NdM+K (2d6, d20, 3d8+2) returns each roll, the sum and the total; coin with 'count' flips returns each flip and the heads and tails counts; lottery with 'pick' and 'of' returns that many different numbers from 1 to 'of', sorted, with 'oddsOneIn' (the exact 1 in C(of, pick)); list with 'items' (and 'pick', omitted to shuffle all) returns the picked items, each line its own entry. Who calls it: teachers picking students, giveaway and raffle tools (secure mode, no seed), tabletop and game apps, test-data builders, lottery quick-pick apps and MCP agents. Worked example: {\"min\":0.5,\"max\":1.5,\"count\":5,\"decimals\":3,\"seed\":\"demo\"} returns 1.354, 0.863, 1.100, 0.806 and 0.998 every time. Integration scenario: a classroom app draws a seeded order of presentations so a teacher can reproduce it, while a giveaway app calls the same endpoint with no seed and keeps the unrepeatable, secure result. A random pick does not predict a real lottery draw. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Security & Developer Utilities"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "min": {
                    "description": "Smallest value, included. Default 1.",
                    "type": "number"
                  },
                  "max": {
                    "description": "Largest value, included. Default 100.",
                    "type": "number"
                  },
                  "count": {
                    "description": "How many numbers (or coin flips). 1 to 1000. Default 1.",
                    "type": "number",
                    "minimum": 1,
                    "maximum": 1000
                  },
                  "unique": {
                    "description": "No repeated numbers.",
                    "type": "boolean"
                  },
                  "decimals": {
                    "description": "Decimal places, 0 to 10. With more than 0 the result is the list of numbers and resultText holds the exact text of each. Default 0 (whole numbers).",
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 10
                  },
                  "sort": {
                    "description": "Return the numbers in ascending order.",
                    "type": "boolean"
                  },
                  "seed": {
                    "description": "Repeatable draws: the same seed gives the same numbers. A seed switches from the secure generator to sfc32, which is NOT cryptographically secure; never use it for secrets or raffles.",
                    "type": "string",
                    "maxLength": 200
                  },
                  "mode": {
                    "description": "numbers (default), dice, coin, lottery or list.",
                    "type": "string",
                    "enum": [
                      "numbers",
                      "dice",
                      "coin",
                      "lottery",
                      "list"
                    ]
                  },
                  "dice": {
                    "description": "mode dice: NdM with an optional modifier, such as 2d6, d20 or 3d8+2.",
                    "type": "string",
                    "maxLength": 40
                  },
                  "pick": {
                    "description": "mode lottery: how many different numbers to pick. mode list: how many items to pick (omit to shuffle all).",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100000
                  },
                  "of": {
                    "description": "mode lottery: the pool, numbers 1 to this.",
                    "type": "integer",
                    "minimum": 2,
                    "maximum": 100000
                  },
                  "items": {
                    "description": "mode list: the items to pick from or shuffle.",
                    "maxItems": 10000,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 500
                    }
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "min": 1,
                "max": 50,
                "count": 6,
                "unique": true
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Random number generator client and server side from freedailypro",
                  "result": [
                    29,
                    30,
                    28,
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "description": "min above max, count outside 1 to 1000, more unique numbers than the range holds (the body says how many values exist), a range with no number at that many decimal places, a bad dice expression, a lottery pick larger than its pool, or a list pick larger than the list; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/extract-emails": {
      "post": {
        "summary": "Extract every email address from a block of text",
        "operationId": "textExtractEmails",
        "description": "Extract every email address from a block of text. Send JSON with text (required). Returns JSON: a list. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string"
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Write to sales@acme.com or support@acme.io. Not an address: user@."
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "description": "An e-mail address"
                      },
                      "description": "Unique addresses in order of first appearance"
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Email extractor client and server side from freedailypro",
                  "result": [
                    "sales@acme.com",
                    "support@acme.io"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/extract-urls": {
      "post": {
        "summary": "Extract every URL from a block of text",
        "operationId": "textExtractUrls",
        "description": "Extract every URL from a block of text. Send JSON with text (required). Returns JSON: a list. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string"
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Docs at https://www.freedailypro.com/developers and the spec at https://api.freedailypro.com/openapi.json."
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "description": "An http(s) URL, without trailing punctuation or unbalanced closing brackets"
                      },
                      "description": "Unique URLs in order of first appearance"
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Url extractor client and server side from freedailypro",
                  "result": [
                    "https://www.freedailypro.com/developers",
                    "https://api.freedailypro.com/openapi.json."
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/find-replace": {
      "post": {
        "summary": "Find and replace text, with optional regular expressions and case matching",
        "operationId": "textFindReplace",
        "description": "Find and replace text, with optional regular expressions and case matching. Send JSON with text, find, replace (required); optional: useRegex, caseSensitive, replaceAll, wholeWord. Returns JSON with the answer as a string in result. Limits: find: up to 2000 characters. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "The text to change, up to 1,000,000 characters (longer is a 422, not billed)."
                  },
                  "find": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2000
                  },
                  "replace": {
                    "type": "string"
                  },
                  "useRegex": {
                    "type": "boolean"
                  },
                  "caseSensitive": {
                    "type": "boolean"
                  },
                  "replaceAll": {
                    "type": "boolean"
                  },
                  "wholeWord": {
                    "description": "Match whole words only, so 'cat' does not match inside 'category'.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "text",
                  "find",
                  "replace"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Color and colour both appear. Color wins.",
                "find": "colou?r",
                "replace": "color",
                "useRegex": true,
                "caseSensitive": false,
                "replaceAll": true
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "string",
                      "description": "The text after replacing"
                    },
                    "replacementCount": {
                      "type": "number",
                      "description": "Replacements made (non-overlapping matches; at most 1 when replaceAll is false)"
                    }
                  },
                  "required": [
                    "result",
                    "replacementCount"
                  ]
                },
                "example": {
                  "tool": "Find replace client and server side from freedailypro",
                  "result": "color and color both appear. color wins.",
                  "replacementCount": 3
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/water-intake": {
      "post": {
        "summary": "Estimate daily water intake from body weight and activity level",
        "operationId": "convertersWaterIntake",
        "description": "Estimate daily water intake from body weight and activity level. Send JSON with weightKg (required); optional: activityLevel. Returns JSON with liters, milliliters, ounces, glassesApprox (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Fitness & Health"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "weightKg": {
                    "type": "number",
                    "minimum": 0
                  },
                  "activityLevel": {
                    "type": "string",
                    "enum": [
                      "sedentary",
                      "light",
                      "moderate",
                      "active"
                    ]
                  }
                },
                "required": [
                  "weightKg"
                ],
                "additionalProperties": false
              },
              "example": {
                "weightKg": 68,
                "activityLevel": "moderate"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Water intake calculator client and server side from freedailypro",
                  "result": {
                    "liters": 2.38,
                    "milliliters": 2380,
                    "ounces": 80.5,
                    "glassesApprox": 10
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/ideal-weight": {
      "post": {
        "summary": "Estimate an ideal weight range from height and sex",
        "operationId": "convertersIdealWeight",
        "description": "Estimate an ideal weight range from height and sex. Send JSON with heightCm, sex (required). Returns JSON with devineKg, robinsonKg, rangeKg (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Fitness & Health"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "heightCm": {
                    "type": "number",
                    "minimum": 0
                  },
                  "sex": {
                    "type": "string",
                    "enum": [
                      "male",
                      "female"
                    ]
                  }
                },
                "required": [
                  "heightCm",
                  "sex"
                ],
                "additionalProperties": false
              },
              "example": {
                "heightCm": 170,
                "sex": "female"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Ideal weight calculator client and server side from freedailypro",
                  "result": {
                    "devineKg": 61.4,
                    "robinsonKg": 60.8,
                    "rangeKg": {
                      "min": 55,
                      "max": 67.2
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/gpa": {
      "post": {
        "summary": "Calculate a GPA from course grades and credits",
        "operationId": "convertersGpa",
        "description": "Send 'courses' (each with 'grade' and 'credits') and optionally 'scale': \"4.0\" (default, grades 0 to 4) or \"percent\" (grades 0 to 100, converted with the usual bands: 90 and up is 4.0, 80 is 3.0, 70 is 2.0, 60 is 1.0, below 60 is 0). Credits must be above 0 and at most 100. Returns 'gpa' (rounded to 2 places), 'totalCredits' and 'totalPoints'. A grade outside the chosen scale (for example 5 or -1 on the 4.0 scale) or invalid credits is a 422 that names the course and the allowed range; nothing is calculated and the call is not billed. Weighted scales above 4.0 are not supported. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Everyday Math"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "courses": {
                    "minItems": 1,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "grade": {
                          "type": "number"
                        },
                        "credits": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "grade",
                        "credits"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "scale": {
                    "type": "string",
                    "enum": [
                      "4.0",
                      "percent"
                    ]
                  }
                },
                "required": [
                  "courses"
                ],
                "additionalProperties": false
              },
              "example": {
                "courses": [
                  {
                    "grade": 4,
                    "credits": 3
                  },
                  {
                    "grade": 3.3,
                    "credits": 4
                  },
                  {
                    "grade": 3.7,
                    "credits": 2
                  }
                ],
                "scale": "4.0"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Gpa calculator client and server side from freedailypro",
                  "result": {
                    "gpa": 3.62,
                    "totalCredits": 9,
                    "totalPoints": 32.6
                  }
                }
              }
            }
          },
          "400": {
            "description": "A missing or empty courses list, a non-numeric grade or credits, or an unknown scale; the body says which field"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/http-status/{code}": {
      "get": {
        "summary": "Look up one HTTP status code and return its phrase and category",
        "operationId": "securityHttpStatusCode",
        "description": "Look up one HTTP status code and return its phrase and category. Put the status code in the URL, for example /v1/security/http-status/404. Returns JSON with code, phrase, category, known (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text",
          "Security & Developer Utilities"
        ],
        "parameters": [
          {
            "name": "code",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Http status reference client and server side from freedailypro",
                  "result": {
                    "code": 404,
                    "phrase": "Not Found",
                    "category": "Client Error",
                    "known": true
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/http-status": {
      "get": {
        "summary": "List every HTTP status code with its phrase and category",
        "operationId": "securityHttpStatus",
        "description": "List every HTTP status code with its phrase and category. No input needed. Returns JSON: a list. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text",
          "Security & Developer Utilities"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Http status reference client and server side from freedailypro",
                  "result": [
                    {
                      "code": 100,
                      "phrase": "Continue",
                      "category": "Informational"
                    },
                    {
                      "code": 101,
                      "phrase": "Switching Protocols",
                      "category": "Informational"
                    },
                    {
                      "code": 102,
                      "phrase": "Processing",
                      "category": "Informational"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/readability": {
      "post": {
        "summary": "Score the reading level of text (Flesch ease, grade level, sentence and word averages)",
        "operationId": "textReadability",
        "description": "Score the reading level of text (Flesch ease, grade level, sentence and word averages). Send JSON with text (required). Returns JSON with fleschReadingEase, fleschKincaidGrade, avgWordsPerSentence, avgSyllablesPerWord, wordCount, sentenceCount, interpretation (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string"
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "The committee reached a decision after lengthy deliberation. Short sentences help. Long, winding sentences with many clauses tend to make documents harder to read."
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "fleschReadingEase": {
                          "type": "number",
                          "description": "Flesch reading ease (higher is easier)"
                        },
                        "fleschKincaidGrade": {
                          "type": "number",
                          "description": "US school grade level"
                        },
                        "avgWordsPerSentence": {
                          "type": "number",
                          "description": "Average words per sentence"
                        },
                        "avgSyllablesPerWord": {
                          "type": "number",
                          "description": "Average syllables per word"
                        },
                        "wordCount": {
                          "type": "number",
                          "description": "Words"
                        },
                        "sentenceCount": {
                          "type": "number",
                          "description": "Sentences"
                        },
                        "interpretation": {
                          "type": "string",
                          "description": "Plain-words reading level"
                        }
                      },
                      "required": [
                        "fleschReadingEase",
                        "fleschKincaidGrade",
                        "avgWordsPerSentence",
                        "avgSyllablesPerWord",
                        "wordCount",
                        "sentenceCount",
                        "interpretation"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Reading level checker client and server side from freedailypro",
                  "result": {
                    "fleschReadingEase": 43.6,
                    "fleschKincaidGrade": 9.2,
                    "avgWordsPerSentence": 8,
                    "avgSyllablesPerWord": 1.83,
                    "wordCount": 24,
                    "sentenceCount": 3,
                    "interpretation": "Difficult (College)"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/html-entities": {
      "post": {
        "summary": "Encode or decode HTML entities",
        "operationId": "securityHtmlEntities",
        "description": "Encode or decode HTML entities. Send JSON with text, action (required). Returns JSON with the answer as a string in result. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text",
          "Security & Developer Utilities"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "For 'encode': text in which & < > \" ' become &amp; &lt; &gt; &quot; &#39;. For 'decode': text containing character references. Decoding happens once (&amp;lt; becomes &lt;, not <) and understands all 2,125 named references of the HTML standard (&eacute; &copy; &nbsp; &euro; &apos; ...), legacy names without a semicolon (&copy), and decimal or hex numbers including characters above U+FFFF (&#x1F600;). Unknown names are left as written; numbers that are not characters become U+FFFD."
                  },
                  "action": {
                    "type": "string",
                    "enum": [
                      "encode",
                      "decode"
                    ],
                    "description": "encode: escape the five HTML-significant characters. decode: turn character references into characters."
                  }
                },
                "required": [
                  "text",
                  "action"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "<a href=\"/pay?a=1&b=2\">Tom & Jerry's</a>",
                "action": "encode"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Html entity converter client and server side from freedailypro",
                  "action": "encode",
                  "result": "&lt;a href=&quot;/pay?a=1&amp;b=2&quot;&gt;Tom &amp; Jerry&#39;s&lt;/a&gt;"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/binary-ascii": {
      "post": {
        "summary": "Convert text to binary or hex and back",
        "operationId": "securityBinaryAscii",
        "description": "Convert text to binary or hex and back. Send JSON with text, action (required); optional: separator. Returns JSON with the answer as a string in result. Limits: separator: up to 3 characters. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text",
          "Security & Developer Utilities"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "For toBinary / toHex: any text, converted as UTF-8 bytes (so 'é' is c3 a9, 11000011 10101001). For fromBinary: 8-bit groups separated by spaces or commas, an optional 0b prefix per group, or one unbroken run whose length is a multiple of 8. For fromHex: pairs such as '48 69', '4869', '0x48 0x69', '\\x48\\x69' or '48:69'. Malformed input (a character that is not 0/1 or a hex digit, an odd number of hex digits, a bit run that is not whole bytes, or bytes that are not valid UTF-8) is a 400 ({error, code: 'invalid_input_bytes'})."
                  },
                  "action": {
                    "type": "string",
                    "enum": [
                      "toBinary",
                      "fromBinary",
                      "toHex",
                      "fromHex"
                    ],
                    "description": "toBinary / toHex: text to UTF-8 bytes. fromBinary / fromHex: bytes back to text."
                  },
                  "separator": {
                    "description": "Text placed between bytes by toBinary and toHex (up to 3 characters, default a space). Ignored by fromBinary and fromHex.",
                    "type": "string",
                    "maxLength": 3
                  }
                },
                "required": [
                  "text",
                  "action"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Hi!",
                "action": "toBinary",
                "separator": " "
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Binary ascii converter client and server side from freedailypro",
                  "action": "toBinary",
                  "result": "01001000 01101001 00100001"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/cron": {
      "post": {
        "summary": "Explain a cron expression in plain words and validate it",
        "operationId": "securityCron",
        "description": "Explain a cron expression in plain words and validate it. Send JSON with expression (required). Returns JSON with valid, expression, description, fields. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text",
          "Time Zones & Dates"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "expression": {
                    "type": "string",
                    "description": "A 5-field cron expression: minute (0-59), hour (0-23), day-of-month (1-31), month (1-12 or JAN-DEC), day-of-week (0-7 or SUN-SAT; 0 and 7 are Sunday). Fields accept * , ranges (1-5), lists (1,15), steps (*/5, 10-30/5) and names in any case; '?' is allowed in the two day fields. Macros @yearly @annually @monthly @weekly @daily @midnight @hourly are accepted. Out-of-range values, reversed ranges (5-1), zero steps, empty list items and negative numbers make the expression invalid. The response description reads like 'At 09:00, Monday through Friday'. A valid expression is a 200; an invalid one is a 400 with {error, code: 'invalid_cron', valid: false, expression, fields} naming the first problem."
                  }
                },
                "required": [
                  "expression"
                ],
                "additionalProperties": false
              },
              "example": {
                "expression": "30 9 * * 1-5"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Cron builder client and server side from freedailypro",
                  "valid": true,
                  "expression": "30 9 * * 1-5",
                  "description": "At 30, past 9, on every day of the month, in every month, on 1-5.",
                  "fields": {
                    "minute": "30",
                    "hour": "9",
                    "dayOfMonth": "*",
                    "month": "*",
                    "dayOfWeek": "1-5"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/markdown-to-html": {
      "post": {
        "summary": "Convert Markdown to HTML",
        "operationId": "textMarkdownToHtml",
        "description": "Convert Markdown to HTML. Send JSON with markdown (required). Returns JSON with the answer as a string in result. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "markdown": {
                    "type": "string"
                  }
                },
                "required": [
                  "markdown"
                ],
                "additionalProperties": false
              },
              "example": {
                "markdown": "# Release notes\n\nVersion **2.1** adds:\n\n- PDF merge\n- [Docs](https://www.freedailypro.com/developers)"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "string",
                      "description": "The HTML (sanitised)"
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Markdown html converter client and server side from freedailypro",
                  "result": "<h1>Release notes</h1>\n<p>Version <strong>2.1</strong> adds:<br/><ul><li>PDF merge</li></ul><br/><ul><li><a href=\"https://www.freedailypro.com/developers\">Docs</a></li></ul></p>"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/bmr": {
      "post": {
        "summary": "Calculate basal metabolic rate and daily calories from body measurements and activity",
        "operationId": "convertersBmr",
        "description": "Send 'weightKg', 'heightCm', 'ageYears', 'sex' and optionally 'activity'. By default the result is Mifflin-St Jeor exactly as before: 'bmr' and 'tdee' (BMR x the activity factor) in calories a day. Optional 'formula' (mifflin-st-jeor, harris-benedict or katch-mcardle) picks the equation; optional 'bodyFatPct' (3 to 60) switches to Katch-McArdle unless 'formula' says otherwise. When either is sent the response adds 'formula', 'formulaName', 'equation', 'citation', 'comparison' (the BMR and TDEE by every formula that can be worked out: Katch-McArdle appears only with body fat) and a 'steps' array that shows the working. Equations: Mifflin-St Jeor 10 x kg + 6.25 x cm - 5 x age + 5 (men) or - 161 (women) (Mifflin et al., Am J Clin Nutr 1990;51:241-247); Harris-Benedict as revised by Roza and Shizgal (men 88.362 + 13.397 x kg + 4.799 x cm - 5.677 x age; women 447.593 + 9.247 x kg + 3.098 x cm - 4.330 x age; Am J Clin Nutr 1984;40:168-182; coefficients checked 30 Oct 2026 against the Dutch national guideline database); Katch-McArdle 370 + 21.6 x lean body mass in kg, where lean body mass = weight x (1 - body fat %) (McArdle, Katch and Katch, Exercise Physiology; page not checked). The original 1919 Harris-Benedict constants are not offered because they were not re-checked. Who calls it: fitness and nutrition apps, coaching and gym onboarding tools, wellness dashboards, and chatbots or MCP agents. Worked examples: {\"weightKg\":75,\"heightCm\":175,\"ageYears\":30,\"sex\":\"male\",\"activity\":\"light\"} returns bmr 1699 and tdee 2336; adding \"bodyFatPct\":15 returns Katch-McArdle bmr 1747 and tdee 2402 (lean mass 63.75 kg) with Mifflin 1699 and Harris-Benedict 1763 in the comparison. Integration scenario: a coaching app asks for body fat from a scan and shows the lifter the three estimates side by side with the equation behind each. These are estimates of resting energy use in healthy adults and differ by a few percent; body fat from a scale or calipers is itself an estimate. Not medical advice. A katch-mcardle formula without bodyFatPct, or a body fat outside 3 to 60, is rejected with a 400 and a plain-words message. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Fitness & Health"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "weightKg": {
                    "type": "number",
                    "minimum": 0
                  },
                  "heightCm": {
                    "type": "number",
                    "minimum": 0
                  },
                  "ageYears": {
                    "type": "number",
                    "maximum": 120,
                    "minimum": 0
                  },
                  "sex": {
                    "type": "string",
                    "enum": [
                      "male",
                      "female"
                    ]
                  },
                  "activity": {
                    "type": "string",
                    "enum": [
                      "sedentary",
                      "light",
                      "moderate",
                      "active",
                      "very_active"
                    ]
                  },
                  "formula": {
                    "description": "Equation to use. Default mifflin-st-jeor (or katch-mcardle when bodyFatPct is sent). harris-benedict is the 1984 Roza-Shizgal revision. katch-mcardle needs bodyFatPct.",
                    "type": "string",
                    "enum": [
                      "mifflin-st-jeor",
                      "harris-benedict",
                      "katch-mcardle"
                    ]
                  },
                  "bodyFatPct": {
                    "description": "Body fat as a percentage, 3 to 60. Switches to Katch-McArdle (370 + 21.6 x lean body mass in kg) unless formula says otherwise; the comparison then includes it.",
                    "type": "number"
                  }
                },
                "required": [
                  "weightKg",
                  "heightCm",
                  "ageYears",
                  "sex"
                ],
                "additionalProperties": false
              },
              "example": {
                "weightKg": 70,
                "heightCm": 175,
                "ageYears": 35,
                "sex": "male",
                "activity": "moderate"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Bmr calorie calculator client and server side from freedailypro",
                  "result": {
                    "bmr": 1624,
                    "tdee": 2517,
                    "activity": "moderate"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Katch-McArdle requested without bodyFatPct, a bodyFatPct outside 3 to 60, an unknown formula, or the usual missing or non-positive body measurements; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/pregnancy-due-date": {
      "post": {
        "summary": "Estimate a due date and gestational age from the last menstrual period",
        "operationId": "convertersPregnancyDueDate",
        "description": "Send 'lastMenstrualPeriod' (YYYY-MM-DD) and optionally 'referenceDate' (default today) and 'cycleLengthDays' (20 to 45; Naegele's rule assumes 28, and a longer or shorter cycle moves the due date by the difference). Returns 'dueDate' (LMP + 280 days, plus the cycle adjustment), 'gestationalAgeDays', 'gestationalWeeks', 'gestationalDaysRemainder', 'trimester', 'cycleAdjustmentDays', 'method' and 'citation' (ACOG Committee Opinion No. 700, Methods for Estimating the Due Date, 2017; only about 4% of babies arrive on the estimated date and early ultrasound dating is the clinical standard). Who calls it: pregnancy and parenting apps, clinic and doula intake forms, wellness tools, chatbots and MCP agents. Worked example: {\"lastMenstrualPeriod\":\"2026-01-10\"} returns 2026-10-17; with cycleLengthDays 32 it returns 2026-10-21. Pure date arithmetic, nothing to update. Not medical advice. No customer data is stored. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Fitness & Health"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "lastMenstrualPeriod": {
                    "type": "string"
                  },
                  "referenceDate": {
                    "type": "string"
                  },
                  "cycleLengthDays": {
                    "description": "Average cycle length in days (default 28). Naegele's rule assumes 28; a longer or shorter cycle moves the due date by the difference.",
                    "type": "integer",
                    "minimum": 20,
                    "maximum": 45
                  }
                },
                "required": [
                  "lastMenstrualPeriod"
                ],
                "additionalProperties": false
              },
              "example": {
                "lastMenstrualPeriod": "2026-03-01",
                "referenceDate": "2026-10-30"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Pregnancy due date calculator client and server side from freedailypro",
                  "dueDate": "2026-12-06",
                  "gestationalAgeDays": 243,
                  "gestationalWeeks": 34,
                  "gestationalDaysRemainder": 5,
                  "trimester": 3
                }
              }
            }
          },
          "400": {
            "description": "A missing lastMenstrualPeriod or a cycleLengthDays outside 20 to 45. An unreadable date comes back as 200 with an 'error' field, as before"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/sip": {
      "post": {
        "summary": "Project the future value of a monthly SIP investment",
        "operationId": "convertersSip",
        "description": "Project the future value of a monthly SIP investment. Send JSON with monthlyInvestment, annualRatePercent, years (required); optional: startDate. Returns JSON with futureValue, totalInvested, estimatedReturns, months, firstContributionDate, lastContributionDate, maturityDate (inside result). Limits: annualRatePercent: at most 100; years: at most 100. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Retirement & Debt Planning"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "monthlyInvestment": {
                    "type": "number",
                    "minimum": 0
                  },
                  "annualRatePercent": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "years": {
                    "type": "number",
                    "maximum": 100,
                    "minimum": 0
                  },
                  "startDate": {
                    "description": "Optional date of the first monthly contribution, as YYYY-MM-DD. Adds firstContributionDate, lastContributionDate and maturityDate. It only labels the plan; the amounts do not change. A day of 29 to 31 moves to the last day of shorter months.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  }
                },
                "required": [
                  "monthlyInvestment",
                  "annualRatePercent",
                  "years"
                ],
                "additionalProperties": false
              },
              "example": {
                "monthlyInvestment": 500,
                "annualRatePercent": 12,
                "years": 10,
                "startDate": "2026-11-01"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Sip calculator client and server side from freedailypro",
                  "result": {
                    "futureValue": 116169.54,
                    "totalInvested": 60000,
                    "estimatedReturns": 56169.54,
                    "months": 120,
                    "firstContributionDate": "2026-11-01",
                    "lastContributionDate": "2036-10-01",
                    "maturityDate": "2036-11-01"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/user-agent": {
      "post": {
        "summary": "Parse a User-Agent string into browser, operating system and device",
        "operationId": "securityUserAgent",
        "description": "Send 'ua' (the user-agent string). Returns 'browser', 'browserVersion', 'os', 'device' and 'isBot' as before, plus 'recognised' (false when the text does not look like a user-agent string at all, in which case a 'note' explains what a real one looks like, instead of returning Unknown fields with no explanation). Optional 'clientHints': paste the Sec-CH-UA request headers (Sec-CH-UA, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version, Sec-CH-UA-Full-Version-List, Sec-CH-UA-Model, Sec-CH-UA-Mobile, Sec-CH-UA-Arch, Sec-CH-UA-Bitness) and the response adds a 'clientHints' object with the full browser version, the model and, for Windows, 11 or 10, which the user-agent string cannot tell (Sec-CH-UA-Platform-Version 13.0.0 or higher is Windows 11). Who calls it: log analysers, analytics pipelines, support tools that triage bug reports, and agents. Worked example: {\"ua\":\"hello world\"} returns recognised false and a note. Integration scenario: a server that logs request headers sends the User-Agent value as 'ua' and the Sec-CH-UA lines as 'clientHints' to tell Windows 11 users from Windows 10 users. The text you send is parsed in memory and not stored. Client Hints are only sent by Chromium-based browsers, and a user-agent string can be spoofed, so never use the result as a security control. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Text",
          "Security & Developer Utilities"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ua": {
                    "type": "string",
                    "minLength": 1,
                    "description": "The User-Agent string. Recognises Chrome, Edge, Firefox, Safari, Opera, Samsung Internet, Vivaldi, Chrome and Firefox on iOS, UC and Yandex browsers; Windows, macOS, iOS, Android, ChromeOS, Linux, Tizen and webOS; and flags crawlers, link-preview fetchers, headless browsers and scripted clients (Googlebot, curl, python-requests, Go-http-client ...) with isBot true. device is desktop, mobile, tablet, tv (smart TVs, Tizen, webOS, Fire TV, Chromecast), bot or unknown. recognised is false when the text does not look like a user-agent string."
                  },
                  "clientHints": {
                    "description": "Optional: pasted Sec-CH-UA request headers (Sec-CH-UA, -Platform, -Platform-Version, -Full-Version-List, -Model, -Mobile, -Arch, -Bitness); adds a 'clientHints' object, e.g. Windows 11, which the user-agent string cannot tell",
                    "type": "string"
                  }
                },
                "required": [
                  "ua"
                ],
                "additionalProperties": false
              },
              "example": {
                "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "User agent parser client and server side from freedailypro",
                  "result": {
                    "raw": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1",
                    "browser": "Safari",
                    "browserVersion": "17.5",
                    "os": "iOS 17.5",
                    "device": "mobile",
                    "isBot": false
                  }
                }
              }
            }
          },
          "400": {
            "description": "A missing or non-string 'ua'"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/minify": {
      "post": {
        "summary": "Minify CSS or JavaScript and return the smaller code",
        "operationId": "securityMinify",
        "description": "Minify CSS or JavaScript and return the smaller code. Send JSON with code, type (required). Returns JSON with the answer as a string in result. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text",
          "Security & Developer Utilities"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string",
                    "description": "The CSS or JavaScript source. Comments and unneeded whitespace are removed with a tokenizer, so strings, template literals, regular expression literals and CSS url(...) are never touched. Nothing is renamed or rewritten. JavaScript newlines that automatic semicolon insertion could depend on are kept (for example before a line starting with ++ or after return), so the output behaves like the input. Unterminated strings, comments or template literals are a 400 ({error, code: 'invalid_code'})."
                  },
                  "type": {
                    "type": "string",
                    "enum": [
                      "css",
                      "js"
                    ],
                    "description": "css or js: which language the code is written in."
                  }
                },
                "required": [
                  "code",
                  "type"
                ],
                "additionalProperties": false
              },
              "example": {
                "code": "body {\n  margin: 0;\n  padding: 0;\n}\n/* header */\nh1 { color: #ff0000; }",
                "type": "css"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Css js minifier client and server side from freedailypro",
                  "type": "css",
                  "result": "body{margin:0;padding:0}h1{color:#ff0000}"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/timezone-offset": {
      "post": {
        "summary": "Apply a UTC offset to a timestamp and return the local time",
        "operationId": "convertersTimezoneOffset",
        "description": "Four request forms are accepted. Fixed offset: {\"utcIso\":\"2026-01-15T12:00:00Z\",\"offset\":\"+05:30\"}. One IANA zone: {\"utcIso\":\"2026-01-15T12:00:00Z\",\"zone\":\"America/New_York\"}. Several zones: {\"utcIso\":\"2026-01-15T12:00:00Z\",\"toZones\":[\"Europe/London\",\"Asia/Kolkata\"]}. A wall-clock time read in a zone: {\"localTime\":\"2026-11-01T01:30\",\"fromZone\":\"America/New_York\",\"toZones\":[\"Europe/London\",\"Asia/Kolkata\"]} (send localTime with fromZone and no utcIso). A body with only some of the fields is a 400 that names what is missing (for example {\"error\":\"utcIso is missing: send utcIso (ISO 8601 UTC timestamp) together with offset, or use zone / toZones.\",\"code\":\"missing_fields\",\"details\":{\"fieldErrors\":{...},\"formErrors\":[],\"issues\":[...],\"examples\":{\"offset\":{...},\"zone\":{...},\"toZones\":{...},\"localTime\":{...}}}}); a timestamp that cannot be read, an offset in the wrong format or an unknown zone is a 400 with code invalid_utc_iso, invalid_offset or unknown_zone and the offending value (cut to 50 characters) in the message. The first version's request (utcIso plus a fixed offset such as +05:30) is unchanged and still returns utc, offset, localIso and localUnixMs; a bad timestamp or offset is now a 400 with the reason (it used to be a 200 carrying an error field). A fixed offset ignores daylight saving, so for real places send IANA zones: 'zone' and/or 'toZones' (up to 10, such as America/New_York or Asia/Kolkata) with the moment as 'utcIso', or as 'localTime' (a wall-clock time such as 2026-11-01T01:30) read in 'fromZone'. Daylight saving comes from the platform's own time zone database, the same code the website converter uses, so the offset in each result is the one in force at that moment. The response then adds 'conversions', one per zone with 'zone', 'name' (a city and country), 'display' (name, the zone's own abbreviation where one exists, and the offset), 'offset' (+05:30), 'offsetMinutes' and 'localIso'. A wall-clock time that does not exist (the clocks jumped forward) or happens twice (they went back) is flagged with 'kind' gap or ambiguous and a 'note'; a skipped time is read with the offset from before the jump and an ambiguous one uses the first occurrence. 'nextChange': true adds to each conversion 'nextClockChange' (the instant, offsets before and after, the change in minutes and a sentence) found to the minute within 400 days, or null for zones that never change (India, UTC, Arizona). 'workStart' and 'workEnd' (hours, default 9 and 17) with two or more zones add 'workingHours': 'windows' lists the runs of hours when every zone is inside working hours on its own clock (from and to are the start of the first and last qualifying hour on the first zone's clock, with startsUtc and endsUtc), and 'text' says it in words. Who calls it: scheduling and booking tools, webinar and interview platforms, remote-team dashboards, calendar integrations and MCP agents. Worked example: {\"localTime\":\"2026-11-01T01:30\",\"fromZone\":\"America/New_York\",\"toZones\":[\"Europe/London\",\"Asia/Kolkata\"]} returns 2026-11-01T05:30:00.000Z with kind ambiguous (New York's clocks go back that night, so 01:30 happens twice), London 05:30 and Mumbai 11:00. Integration scenario: a booking page shows a visitor in Mumbai the slot a New York host offered, and uses workingHours to suggest only times that fall inside both people's working day. Zone data is only as current as the server's time zone database; a rule a government changed recently may be missing until it is updated. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Time Zones & Dates"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "utcIso": {
                    "description": "The moment as a UTC timestamp, such as 2026-10-30T12:00:00Z. Required unless localTime and fromZone are sent.",
                    "type": "string"
                  },
                  "offset": {
                    "description": "A fixed offset such as +05:30 or -08:00 (the first version's request). Use zone for a real time zone with daylight saving.",
                    "type": "string"
                  },
                  "zone": {
                    "description": "An IANA time zone such as America/New_York. Daylight saving is handled from the platform's own time zone database.",
                    "type": "string"
                  },
                  "toZones": {
                    "description": "More IANA zones to convert the same moment to (up to 10, together with zone).",
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "localTime": {
                    "description": "A wall-clock time such as 2026-11-01T01:30, read in fromZone. A time the clocks skip or repeat is detected and explained.",
                    "type": "string"
                  },
                  "fromZone": {
                    "description": "The IANA zone localTime is read in.",
                    "type": "string"
                  },
                  "nextChange": {
                    "description": "Add, for every zone, the next time its clocks change (to the minute) or null when they do not.",
                    "type": "boolean"
                  },
                  "workStart": {
                    "description": "Start of working hours (default 9). With workEnd, returns the hours when every zone is at work.",
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 23
                  },
                  "workEnd": {
                    "description": "End of working hours (default 17).",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 24
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "utcIso": "2026-10-30T12:00:00Z",
                "offset": "+05:30"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Timezone converter client and server side from freedailypro",
                  "utc": "2026-10-30T12:00:00.000Z",
                  "offset": "+05:30",
                  "localIso": "2026-10-30T17:30:00",
                  "localUnixMs": 1793381400000
                }
              }
            }
          },
          "400": {
            "description": "Body: {error, code, details: {fieldErrors, formErrors, issues, examples}}. code is missing_fields (the message names the missing field, for example utcIso or offset, and details.examples shows the four accepted request forms), invalid_utc_iso (timestamp cannot be read), invalid_offset (use +05:30 or -08:00), unknown_zone (not an IANA name), invalid_local_time, or invalid_timezone_input (localTime with utcIso, workStart not before workEnd, working hours with fewer than two zones); the offending value is shown cut to 50 characters"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/body-fat": {
      "post": {
        "summary": "Estimate body fat percentage from tape measurements (US Navy method)",
        "operationId": "convertersBodyFat",
        "description": "Send 'sex', 'heightCm', 'waistCm', 'neckCm' and, for women, 'hipCm' (all in centimetres); add 'weightKg' to get 'fatMassKg' and 'leanMassKg'. Returns 'bodyFatPercent', 'category' (the American College of Exercise bands, listed in 'categoryScheme'), 'method' and 'citation': Hodgdon and Beckett, Naval Health Research Center reports 84-11 and 84-29 (1984), with the usual accuracy of about 3 to 4 percentage points; it is an estimate, not a DEXA scan. Who calls it: fitness and coaching apps, gym and clinic intake tools, wellness dashboards, chatbots and MCP agents. Worked example: {\"sex\":\"male\",\"heightCm\":180,\"waistCm\":90,\"neckCm\":38,\"weightKg\":80} returns 19.8% (Average), fat mass 15.84 kg and lean mass 64.16 kg (checked against the published formula in Python). Integration scenario: an intake form sends the three tape measurements and shows the category with the citation beside it. Pure formula, nothing to update. Not medical advice. No customer data is stored. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Fitness & Health"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "sex": {
                    "type": "string",
                    "enum": [
                      "male",
                      "female"
                    ]
                  },
                  "heightCm": {
                    "type": "number",
                    "minimum": 0
                  },
                  "waistCm": {
                    "type": "number",
                    "minimum": 0
                  },
                  "neckCm": {
                    "type": "number",
                    "minimum": 0
                  },
                  "hipCm": {
                    "type": "number",
                    "minimum": 0
                  },
                  "weightKg": {
                    "description": "Optional body weight in kg; adds fatMassKg and leanMassKg to the result.",
                    "type": "number",
                    "minimum": 0
                  }
                },
                "required": [
                  "sex",
                  "heightCm",
                  "waistCm",
                  "neckCm"
                ],
                "additionalProperties": false
              },
              "example": {
                "sex": "male",
                "heightCm": 180,
                "waistCm": 88,
                "neckCm": 38
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Body fat calculator client and server side from freedailypro",
                  "bodyFatPercent": 18.4,
                  "category": "Average"
                }
              }
            }
          },
          "400": {
            "description": "A missing or non-numeric measurement or an unknown sex. Calculation problems (a missing hipCm for women, a non-positive value) come back as 200 with an 'error' field, as before"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/recipe-scale": {
      "post": {
        "summary": "Scale recipe ingredient amounts from one serving count to another",
        "operationId": "convertersRecipeScale",
        "description": "Scale recipe ingredient amounts from one serving count to another. Send JSON with ingredients, originalServings, targetServings (required). Returns JSON: a list. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Unit Conversion"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ingredients": {
                    "minItems": 1,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "amount": {
                          "type": "number"
                        },
                        "unit": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "name",
                        "amount"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "originalServings": {
                    "type": "number",
                    "minimum": 0
                  },
                  "targetServings": {
                    "type": "number",
                    "minimum": 0
                  }
                },
                "required": [
                  "ingredients",
                  "originalServings",
                  "targetServings"
                ],
                "additionalProperties": false
              },
              "example": {
                "ingredients": [
                  {
                    "name": "flour",
                    "amount": 250,
                    "unit": "g"
                  },
                  {
                    "name": "eggs",
                    "amount": 2
                  },
                  {
                    "name": "milk",
                    "amount": 300,
                    "unit": "ml"
                  }
                ],
                "originalServings": 4,
                "targetServings": 10
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Recipe scaler client and server side from freedailypro",
                  "result": [
                    {
                      "name": "flour",
                      "amount": 625,
                      "unit": "g",
                      "originalAmount": 250
                    },
                    {
                      "name": "eggs",
                      "amount": 5,
                      "originalAmount": 2
                    },
                    {
                      "name": "milk",
                      "amount": 750,
                      "unit": "ml",
                      "originalAmount": 300
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/fancy": {
      "post": {
        "summary": "Restyle text with a named Unicode font style such as bold, italic, script or monospace",
        "operationId": "textFancy",
        "description": "Send 'text' and 'style' (one of the names in the 'supported' list the endpoint returns for an unknown style: bold, italic, boldItalic, monospace, doubleStruck, script, boldScript, fraktur, circled, squared, zalgo, glitch). Returns 'result', pure Unicode you can paste anywhere plain text is accepted. 'intensity' (1 to 3, default 2) applies to zalgo only: 1 adds 2 combining marks per letter, 2 adds 7, 3 adds 14; the same text and intensity always return the same string. Who calls it: social-bio and gamer-tag tools, Discord and chat bots, and agents that restyle a heading. Worked example: {\"text\":\"Hi\",\"style\":\"boldScript\"} returns the two bold script letters. Integration scenario: a bot shows a user all styles in a list and lets them pick; for zalgo it lets them choose the intensity. Limits: squared, circled and zalgo output may show as empty boxes, be cut off or be stripped on some platforms, and screen readers do not read these characters like normal text, so keep a plain version for places where accessibility matters. Letters A-Z and a-z are mapped; digits and other characters pass through unchanged (the web tool maps more). Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string"
                  },
                  "style": {
                    "type": "string"
                  },
                  "intensity": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 3
                  }
                },
                "required": [
                  "text",
                  "style"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Grand Opening",
                "style": "bold"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "style": {
                      "type": "string",
                      "description": "The style that was applied"
                    },
                    "result": {
                      "type": "string",
                      "description": "The restyled text"
                    }
                  },
                  "required": [
                    "result",
                    "style"
                  ]
                },
                "example": {
                  "tool": "Fancy font generator client and server side from freedailypro",
                  "style": "bold",
                  "result": "𝐆𝐫𝐚𝐧𝐝 𝐎𝐩𝐞𝐧𝐢𝐧𝐠"
                }
              }
            }
          },
          "400": {
            "description": "A missing text or style, an unknown style (the body lists the supported ones), or an intensity outside 1 to 3"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/invisible": {
      "post": {
        "summary": "Encode, decode, strip or generate invisible zero-width Unicode text",
        "operationId": "textInvisible",
        "description": "Encode, decode, strip or generate invisible zero-width Unicode text. Send JSON with mode (required); optional: text, length, carrier. Returns JSON with the answer as a string in result. Limits: length: at most 500, at least 1. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "string",
                    "enum": [
                      "encode",
                      "decode",
                      "strip",
                      "generate"
                    ]
                  },
                  "text": {
                    "type": "string"
                  },
                  "length": {
                    "type": "number",
                    "minimum": 1,
                    "maximum": 500
                  },
                  "carrier": {
                    "type": "string"
                  }
                },
                "required": [
                  "mode"
                ],
                "additionalProperties": false
              },
              "example": {
                "mode": "encode",
                "text": "hi",
                "carrier": "Hello"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "mode": {
                      "type": "string",
                      "description": "encode, decode, strip or detect"
                    },
                    "result": {
                      "type": "string",
                      "description": "The output text (the carrier with the hidden message, or the decoded message)"
                    }
                  },
                  "required": [
                    "result",
                    "mode"
                  ]
                },
                "example": {
                  "tool": "Invisible text generator client and server side from freedailypro",
                  "mode": "encode",
                  "result": "Hello​​​​​​​​​‌‌​‌​​​​​​​​​​​​‌‌​‌​​‌"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/seo/meta-tags": {
      "post": {
        "summary": "Generate title, description, Open Graph and Twitter Card meta tags as HTML",
        "operationId": "seoMetaTags",
        "description": "Generate title, description, Open Graph and Twitter Card meta tags as HTML. Send JSON with title, description (required); optional: url, image, siteName, type, twitterCard. Returns JSON with html, tags. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored. HTML entities: common entities in the text you send (&amp; &lt; &gt; &quot; &#39; &nbsp; and numeric forms such as &#233; or &#xE9;) are decoded once before processing, so 'Tom &amp; Jerry' is read as 'Tom & Jerry' and is not escaped twice, and keyword counts never include the word 'amp'; other named entities are left as typed. Errors: 400 with the same body on every SEO endpoint, {error, code, details: {fieldErrors, formErrors, issues}}.",
        "tags": [
          "Text",
          "SEO & Web Markup"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "minLength": 1
                  },
                  "description": {
                    "type": "string",
                    "minLength": 1
                  },
                  "url": {
                    "type": "string"
                  },
                  "image": {
                    "type": "string"
                  },
                  "siteName": {
                    "type": "string"
                  },
                  "type": {
                    "type": "string"
                  },
                  "twitterCard": {
                    "type": "string",
                    "enum": [
                      "summary",
                      "summary_large_image"
                    ]
                  }
                },
                "required": [
                  "title",
                  "description"
                ],
                "additionalProperties": false
              },
              "example": {
                "title": "Merge PDF files online",
                "description": "Combine several PDFs into one file in your browser. Nothing is uploaded.",
                "url": "https://www.freedailypro.com/merge-pdf",
                "siteName": "FreeDailyPro",
                "twitterCard": "summary_large_image"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "html": {
                      "type": "string",
                      "description": "The tags as HTML, one per line: title, description, Open Graph and Twitter Card",
                      "example": "<title>Merge PDF files online</title>\n<meta name=\"description\" content=\"Combine several PDFs into one file.\" />"
                    },
                    "tags": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "string"
                      },
                      "description": "The same tags as name/value pairs (values are plain text, not HTML-escaped)",
                      "example": {
                        "title": "Merge PDF files online",
                        "description": "Combine several PDFs into one file.",
                        "og:title": "Merge PDF files online",
                        "twitter:card": "summary"
                      }
                    }
                  },
                  "required": [
                    "html",
                    "tags"
                  ]
                },
                "example": {
                  "html": "<title>Merge PDF files online</title>\n<meta name=\"description\" content=\"Combine several PDFs into one file in your browser. Nothing is uploaded.\" />\n<meta property=\"og:url\" content=\"https://www.freedailypro.com/merge-pdf\" />\n<meta property=\"og:title\" content=\"Merge PDF files online\" />\n<meta propert...",
                  "tags": {
                    "title": "Merge PDF files online",
                    "description": "Combine several PDFs into one file in your browser. Nothing is uploaded.",
                    "og:url": "https://www.freedailypro.com/merge-pdf",
                    "og:title": "Merge PDF files online",
                    "og:description": "Combine several PDFs into one file in your browser. Nothing is uploaded.",
                    "og:type": "website",
                    "og:site_name": "FreeDailyPro",
                    "twitter:card": "summary_large_image",
                    "twitter:title": "Merge PDF files online",
                    "twitter:description": "Combine several PDFs into one file in your browser. Nothing is uploaded."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input. Body: {error, code, details: {fieldErrors, formErrors, issues}}; error is a plain sentence naming the field, code is invalid_input or a specific code, issues lists each problem as {path, message, code}."
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/seo/keyword-density": {
      "post": {
        "summary": "Count how often a keyword appears in text and return its density percentage",
        "operationId": "seoKeywordDensity",
        "description": "Count how often a keyword appears in text and return its density percentage. Send JSON with text, keyword (required); optional: caseSensitive. Returns JSON with totalWords, keywordCount, densityPercent, occurrences (inside result). Limits: keyword: up to 500 characters. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored. HTML entities: common entities in the text you send (&amp; &lt; &gt; &quot; &#39; &nbsp; and numeric forms such as &#233; or &#xE9;) are decoded once before processing, so 'Tom &amp; Jerry' is read as 'Tom & Jerry' and is not escaped twice, and keyword counts never include the word 'amp'; other named entities are left as typed. Errors: 400 with the same body on every SEO endpoint, {error, code, details: {fieldErrors, formErrors, issues}}.",
        "tags": [
          "Text",
          "SEO & Web Markup"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "The text to analyse, in any language. Words are runs of letters and numbers in any script (accents, Cyrillic, Arabic ...); Japanese, Chinese, Korean and Thai text written without spaces is split with a word segmenter."
                  },
                  "keyword": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500,
                    "description": "The word or phrase to count (up to 500 characters). A phrase must appear as the same whole words in a row. Matching is by whole word, accent-sensitive ('cafe' does not match 'café') and case-insensitive unless caseSensitive is true. A keyword with no letters or numbers is a 400."
                  },
                  "caseSensitive": {
                    "description": "true: 'PDF' and 'pdf' are different. Default false.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "text",
                  "keyword"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "PDF tools make work easier. Merge a PDF, split a PDF, compress a PDF.",
                "keyword": "pdf"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "totalWords": {
                          "type": "integer",
                          "description": "Words in the text after HTML entities are decoded",
                          "example": 14
                        },
                        "keywordCount": {
                          "type": "integer",
                          "description": "How many times the keyword (or phrase) appears as whole words",
                          "example": 4
                        },
                        "densityPercent": {
                          "type": "number",
                          "description": "Share of the words covered by the keyword, 0 to 100, 2 decimals",
                          "example": 28.57
                        },
                        "occurrences": {
                          "type": "array",
                          "items": {
                            "type": "integer"
                          },
                          "description": "Zero-based word positions where each match starts",
                          "example": [
                            0,
                            7,
                            10,
                            13
                          ]
                        }
                      },
                      "required": [
                        "totalWords",
                        "keywordCount",
                        "densityPercent",
                        "occurrences"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "result": {
                    "totalWords": 14,
                    "keywordCount": 4,
                    "densityPercent": 28.57,
                    "occurrences": [
                      0,
                      7,
                      10,
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input. Body: {error, code, details: {fieldErrors, formErrors, issues}}; error is a plain sentence naming the field, code is invalid_input or a specific code, issues lists each problem as {path, message, code}."
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/seo/hashtags": {
      "post": {
        "summary": "Extract hashtags from text or generate them from keywords",
        "operationId": "seoHashtags",
        "description": "Extract hashtags from text or generate them from keywords. Send JSON with action (required); optional: text, keywords, max. Returns JSON: a list. Limits: max: at most 50, at least 1. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored. HTML entities: common entities in the text you send (&amp; &lt; &gt; &quot; &#39; &nbsp; and numeric forms such as &#233; or &#xE9;) are decoded once before processing, so 'Tom &amp; Jerry' is read as 'Tom & Jerry' and is not escaped twice, and keyword counts never include the word 'amp'; other named entities are left as typed. Errors: 400 with the same body on every SEO endpoint, {error, code, details: {fieldErrors, formErrors, issues}}.",
        "tags": [
          "Text",
          "SEO & Web Markup"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "action": {
                    "type": "string",
                    "enum": [
                      "extract",
                      "generate"
                    ],
                    "description": "extract finds #hashtags already in 'text'; generate builds hashtags from 'keywords' (or from the main words of 'text' if no keywords are sent)."
                  },
                  "text": {
                    "description": "Required for 'extract' (a missing or blank text is a 400): the text to read #hashtags from, in any language (#日本語, #café). A hashtag must contain a letter; #2024 alone is not one. Results are lower-cased and de-duplicated. For 'generate' it is only used to build hashtags from its most frequent words when no keywords are sent.",
                    "type": "string"
                  },
                  "keywords": {
                    "description": "Words or phrases to turn into hashtags, for example ['coffee shop', 'grand opening'].",
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "max": {
                    "description": "Maximum hashtags to return (default 30, or 10 when built from text).",
                    "type": "number",
                    "minimum": 1,
                    "maximum": 50
                  }
                },
                "required": [
                  "action"
                ],
                "additionalProperties": false
              },
              "example": {
                "action": "generate",
                "keywords": [
                  "pdf tools",
                  "productivity"
                ],
                "max": 6
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "description": "A hashtag starting with #"
                      },
                      "description": "extract: the hashtags found, lower-cased and de-duplicated; generate: the hashtags built",
                      "example": [
                        "#PdfTools",
                        "#Productivity"
                      ]
                    },
                    "note": {
                      "type": "string",
                      "description": "Present only when generate built the hashtags from the text because no keywords were sent"
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "result": [
                    "#PdfTools",
                    "#Productivity"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input. Body: {error, code, details: {fieldErrors, formErrors, issues}}; error is a plain sentence naming the field, code is invalid_input or a specific code, issues lists each problem as {path, message, code}."
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/design/color-convert": {
      "post": {
        "summary": "Convert a colour between HEX, RGB and HSL",
        "operationId": "designColorConvert",
        "description": "Send 'hex' (3 or 6 digits, # optional) or 'r', 'g' and 'b' (0 to 255). Returns 'hex', 'rgb' and 'hsl' as before, plus 'hsv', 'cmyk', 'lab' (CIELAB with the D50 white point, as CSS lab() uses) and 'oklch' as numbers, and a 'css' object with ready-to-paste strings (hsv, cmyk, lab, oklch). 'cmyk' is a simple conversion from RGB with no printer profile, so a print shop's own conversion can differ. By default an r, g or b outside 0 to 255 answers 400; send 'clamp': true to clamp it instead, and the response lists each change in 'clamped' (for example 'Clamped red 300→255.'). Who calls it: design-token and theme tools, front-end build scripts that need OKLCH or LAB for a brand colour, accessibility checkers, and chatbots or MCP agents. Worked example: {\"hex\":\"#6366f1\"} returns oklch 58.5% 0.204 277.1 and lab 49 30.4 -71.9. Integration scenario: a design-token pipeline sends each brand hex once and writes the 'css.oklch' string into a stylesheet; a form that accepts typed rgb values sends 'clamp': true and shows the 'clamped' notes to the user. The input is a colour you provide; nothing is looked up or stored. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "hex": {
                    "description": "A colour as 3 or 6 hex digits, with or without a leading # and with any letter case; surrounding spaces are ignored (' #FF0000 ' works). The answer's 'hex' is always the normalised lower-case #rrggbb (#f00 becomes #ff0000). Send either hex or r, g and b, not both. Anything else is a 400.",
                    "type": "string"
                  },
                  "r": {
                    "description": "Red, a whole number 0-255 (with clamp true, whole numbers outside the range are clamped). A fraction such as 1.5 is a 400.",
                    "type": "number"
                  },
                  "g": {
                    "description": "Green, a whole number 0-255 (with clamp true, whole numbers outside the range are clamped). A fraction is a 400.",
                    "type": "number"
                  },
                  "b": {
                    "description": "Blue, a whole number 0-255 (with clamp true, whole numbers outside the range are clamped). A fraction is a 400.",
                    "type": "number"
                  },
                  "clamp": {
                    "description": "Clamp r, g, b to 0-255 and list each change in 'clamped', instead of answering 400",
                    "type": "boolean"
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "hex": "#3b82f6"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Color converter client and server side from freedailypro",
                  "hex": "#3b82f6",
                  "rgb": {
                    "r": 59,
                    "g": 130,
                    "b": 246
                  },
                  "hsl": {
                    "h": 217,
                    "s": 91.2,
                    "l": 59.8
                  }
                }
              }
            }
          },
          "400": {
            "description": "No hex or r, g, b; an invalid hex; or an r, g or b outside 0 to 255 when 'clamp' is not true"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/design/contrast": {
      "post": {
        "summary": "Check the WCAG contrast ratio of two colours and return AA and AAA pass or fail",
        "operationId": "designContrast",
        "description": "Check the WCAG contrast ratio of two colours and return AA and AAA pass or fail. Send JSON with foreground, background (required). Returns JSON with ratio, aa, aaa, aaLarge. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "foreground": {
                    "type": "string"
                  },
                  "background": {
                    "type": "string"
                  }
                },
                "required": [
                  "foreground",
                  "background"
                ],
                "additionalProperties": false
              },
              "example": {
                "foreground": "#767676",
                "background": "#ffffff"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Contrast checker client and server side from freedailypro",
                  "ratio": 4.54,
                  "aa": true,
                  "aaa": false,
                  "aaLarge": true
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/fillable-forms/parse": {
      "post": {
        "summary": "List the fillable fields in a PDF form",
        "operationId": "fillableFormsParse",
        "description": "Returns every fillable field of a PDF form: name, type (text, checkbox, dropdown, radio, optionlist, or button/signature for fields that cannot be filled), current value, options for dropdowns, radio groups and option lists, and flags (readOnly, required, maxLength and multiline for text, editable for dropdowns, multiselect for option lists). kind is the same word as type (kept for existing clients). Use it before fill to get the exact names and option values. Limits: reads AcroForm fields only; XFA (dynamic) forms and PDFs with no fields return an empty list or a 422. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF",
          "PDF Forms"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF form. Up to 20 MB."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pdf"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "fieldCount": 6,
                  "fields": [
                    {
                      "name": "name",
                      "kind": "text",
                      "type": "text",
                      "readOnly": false,
                      "required": false,
                      "value": "Jane Doe",
                      "multiline": false
                    },
                    {
                      "name": "email",
                      "kind": "text",
                      "type": "text",
                      "readOnly": false,
                      "required": false,
                      "value": "",
                      "multiline": false
                    },
                    {
                      "name": "agree",
                      "kind": "checkbox",
                      "type": "checkbox",
                      "readOnly": false,
                      "required": false,
                      "checked": false,
                      "value": false
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/fillable-forms/fill": {
      "post": {
        "summary": "Fill a PDF form's fields from JSON and return the filled PDF",
        "operationId": "fillableFormsFill",
        "description": "Fills the fields you name and returns the PDF. Only the fields named in values or checked change; every other field keeps its current value (a partial fill never erases the rest). Supported field types: text (string), checkbox (true or false, in checked or values), dropdown (one of its options), radio group (one of its options) and option list (one option or an array when it allows several). To clear a field on purpose send null (or an empty string for text, dropdown, radio and option list; false for a checkbox). Dropdown, radio and option-list values are matched to the option exactly, or ignoring case and surrounding spaces when that is unambiguous. A field that cannot be set is reported with the reason: in the X-Fields-Not-Set and X-Fields-Not-Set-Detail response headers, or in the body when you send format=json (fieldsSet, fieldsNotSet, fieldsUntouched, plus the PDF as fileBase64). If none of the named fields could be set the call returns 422 with the same report and is not billed. flatten=true burns the values in so they can no longer be edited (done after filling). Limits: AcroForm fields only (no XFA); text must be Latin-1 (WinAnsi) characters, other scripts are reported as not set; push buttons and signature fields cannot be filled; the output uses the form's standard appearance, so very custom field fonts may look different in some viewers. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF",
          "PDF Forms"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF form. Up to 20 MB."
                  },
                  "values": {
                    "type": "string",
                    "description": "JSON object of field values by field name, for example {\"Name\":\"Ada\",\"Country\":\"Canada\",\"Plan\":\"Pro\"}. A string for text, dropdown and radio; a string or array of strings for an option list; true/false for a checkbox; null clears the field. Fields not named here are not changed"
                  },
                  "checked": {
                    "type": "string",
                    "description": "JSON object of checkbox states, for example {\"Agree\":true}. Only the named checkboxes change"
                  },
                  "flatten": {
                    "type": "string",
                    "description": "true to flatten the form so it can no longer be edited"
                  },
                  "format": {
                    "type": "string",
                    "description": "Send json to get a JSON body with the fill report and the PDF as base64 instead of the PDF file",
                    "enum": [
                      "pdf",
                      "json"
                    ]
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "form.pdf",
                "values": "{\"name\":\"Jane Doe\",\"plan\":\"Pro\"}",
                "checked": "{\"agree\":true}"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 7,487 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Fields-Set": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of fields changed by this call",
                "example": "3"
              },
              "X-Fields-Not-Set": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of named fields that could not be set",
                "example": "0"
              },
              "X-Fields-Not-Set-Detail": {
                "schema": {
                  "type": "string"
                },
                "description": "URL-encoded JSON list of {name, reason} for the fields that could not be set (shortened to 3,000 characters)",
                "example": "%5B%5D"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/redact-pdf": {
      "post": {
        "summary": "Permanently redact areas of a PDF",
        "operationId": "redactPdf",
        "description": "Removes everything under the given boxes from the file itself and draws an opaque black bar over each box. Everything outside the boxes is left as it was: the remaining text stays real, selectable and searchable in its original fonts (embedded or not), and the file does not grow into page pictures. Pages are numbered from 1. Each box is { x, y, width, height } in PDF points (1 point = 1/72 inch), measured from the TOP-LEFT corner of the page as displayed (x to the right, y downwards, after the page rotation, inside the crop box); a US Letter page is 612 x 792 points. A box that runs past the page edge is cut to the page. What is removed with mode=auto (the default): TEXT: every character whose box (its advance width by the font's ascent and descent) overlaps a box is deleted from the page's content, including invisible text and text in hidden layers; a character only partly covered is removed whole, and the text after it keeps its position. PICTURES: the pixels under a box are painted black and the picture is stored again (re-encoded, JPEG at quality 90), so the original pixels are not in the file. VECTOR ART: rectangle fills and straight lines are cut around the box, and shapes lying entirely inside a box are deleted. ANNOTATIONS: links, comments and form fields (with their values) whose rectangle overlaps a box are deleted; page thumbnails, page-level metadata and tagged-PDF alternative text (/ActualText, /Alt) of the pages that have boxes are dropped. The replaced content is purged from the output file, not kept as an old version. Not changed or inspected: pages without boxes, document metadata (title, author, XMP), bookmarks and attachments. When a page cannot be edited exactly (curved or irregular drawings that stick out of a box, gradient fills, unusual font encodings, pictures in formats that cannot be re-encoded, files that cannot be edited in place such as encrypted ones with an empty password), only that page is turned into a picture with the boxes painted black, so nothing is left behind and nothing disappears, but that page's text can no longer be selected. The response header X-Redaction-Mode says which happened: text-removed (no page was turned into a picture) or rasterized-pages (X-Redaction-Rasterized-Pages lists the pages). Send mode=raster to turn every page with a box into a picture on purpose. Scanned (image-only) PDFs work. Errors: 400 with a plain message for a page that does not exist (0, 99, -1, abc), a box with a missing or non-numeric x, y, width or height, a width or height of 0 or less, a box that starts outside the page, malformed or missing 'boxes' JSON, or an unknown mode; 422 for a PDF that needs a password or cannot be read. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF. Up to 20 MB."
                  },
                  "boxes": {
                    "type": "string",
                    "description": "JSON object: page number (from 1) to a list of boxes, for example {\"1\":[{\"x\":50,\"y\":100,\"width\":200,\"height\":20}]}. x and y are points from the top-left corner.",
                    "example": "{\"1\":[{\"x\":50,\"y\":100,\"width\":200,\"height\":20}]}"
                  },
                  "mode": {
                    "type": "string",
                    "description": "auto (default) removes the covered content and keeps the rest as real text, turning a page into a picture only when it has to; raster always turns pages with boxes into pictures",
                    "enum": [
                      "auto",
                      "raster"
                    ],
                    "default": "auto"
                  }
                },
                "required": [
                  "file",
                  "boxes"
                ]
              },
              "example": {
                "file": "sample.bin",
                "boxes": "{\"1\":[{\"x\":50,\"y\":100,\"width\":200,\"height\":20}]}"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Redaction-Mode": {
                "schema": {
                  "type": "string"
                },
                "description": "text-removed when no page was turned into a picture, rasterized-pages otherwise"
              },
              "X-Redaction-Rasterized-Pages": {
                "schema": {
                  "type": "string"
                },
                "description": "Comma-separated page numbers (from 1) that were turned into a picture; empty when none"
              },
              "X-Redaction-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "What was removed, for example glyphs=25;pictures=0;drawings=0;annotations=0"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pdf/merge": {
      "post": {
        "summary": "Merge PDFs into one",
        "operationId": "pdfMerge",
        "description": "Combines two or more PDFs in the order sent. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "files": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "binary"
                    },
                    "description": "At least two PDFs (repeat the field). 60 MB in total."
                  }
                },
                "required": [
                  "files"
                ]
              },
              "example": {
                "files": [
                  "a.pdf",
                  "b.pdf"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 2,199 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pdf/split": {
      "post": {
        "summary": "Split a PDF by page ranges",
        "operationId": "pdfSplit",
        "description": "Splits a PDF into one or more PDFs by page ranges (pages start at 1). Use commas for pages inside one output, for example 1-3,5, and semicolons to start a new output file, for example 1-3;4-6. One output returns a PDF; several return JSON with a base64 file for each, unless combineIntoOne is true. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF. Up to 20 MB."
                  },
                  "ranges": {
                    "type": "string",
                    "description": "Pages or ranges, pages start at 1. Commas join pages into one output (1-3,5); semicolons separate outputs (1-3;4-6)"
                  },
                  "combineIntoOne": {
                    "type": "string",
                    "description": "true to return a single PDF with all selected pages"
                  }
                },
                "required": [
                  "file",
                  "ranges"
                ]
              },
              "example": {
                "file": "document.pdf",
                "ranges": "1-3;4-6"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "PDF splitter client and server side from freedailypro",
                  "files": [
                    {
                      "name": "split_1.pdf",
                      "base64": "JVBERi0xLjcKJYGBgYEKCjUgMCBvYmoKPDwKL0ZpbHRlciAvRmxhdGVEZWNvZGUKL0xlbmd0aCAxNTEKPj4Kc3RyZWFtCnicdY6xCgIxEET7/YqtBXGTbGZzIMLpRSxshPyAiIqixYn4/V60UVAGZqYYeNPTvJBw1e1Ik9X+8tjfT7vt2KRJmsRSw165HKj6mtxr6tg8mwiXK01jgENnggWilyEdrLbgZlzOVEaUC22o/0dqTD2Sj0js/E8S8CZpwBLZdCAE09B6QTv0jKiCaOnjR0bddl8Pnmc3M9QKZW5k..."
                    },
                    {
                      "name": "split_2.pdf",
                      "base64": "JVBERi0xLjcKJYGBgYEKCjUgMCBvYmoKPDwKL0ZpbHRlciAvRmxhdGVEZWNvZGUKL0xlbmd0aCAxNTEKPj4Kc3RyZWFtCnicdY6xCgIxEET7/YqtBXGTTWZTiHB6EQsbIT8gcsqJFifi93vRRkEZmJli4M1Ay0LCVbcTzTbd5dHd+8N+atF8VEUC+8DlSNW35F5Tx+bZRLhcaR4VDq0JVohexnSw2lQXXM5UJpQL7Wj4R0ohikvixNj5nyTgTQqKNbKFkaAWtPGCZuwZMQiipY8fGXXbfj14AlkCM7cKZW5k..."
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pdf/rotate": {
      "post": {
        "summary": "Rotate chosen pages of a PDF and return the PDF",
        "operationId": "pdfRotate",
        "description": "Rotates chosen pages by multiples of 90 degrees. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF. Up to 20 MB."
                  },
                  "rotations": {
                    "type": "string",
                    "description": "JSON object: 1-based page number to degrees, for example {\"1\":90,\"2\":180}"
                  }
                },
                "required": [
                  "file",
                  "rotations"
                ]
              },
              "example": {
                "file": "sample.pdf",
                "rotations": "value"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 1,478 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pdf/add-page-numbers": {
      "post": {
        "summary": "Add page numbers to every page of a PDF and return the PDF",
        "operationId": "pdfAddPageNumbers",
        "description": "Stamps page numbers on every page, or on a page range. Numbering starts at startAt on the FIRST NUMBERED page (not necessarily page 1) and goes up by one for each numbered page. With format=page-of-total the total is the last number used, counted from startAt: startAt 5 on 3 pages gives Page 5 of 7, Page 6 of 7, Page 7 of 7. prefix only applies with format=prefixed. skipFirstPage also works together with pageRange (page 1 is left out even if the range includes it). The built-in font draws Latin text only. Errors: 400 for a startAt that is not a whole number of 1 or more, a fontSize outside 4 to 72, a pageRange that is not valid for this PDF (pages are numbered from 1), a prefix with characters outside Latin text, or an unknown position or format; 422 for a PDF that needs a password or cannot be read. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF. Up to 20 MB."
                  },
                  "position": {
                    "type": "string",
                    "description": "Where to place the number. Default bottom-center.",
                    "enum": [
                      "bottom-center",
                      "bottom-right",
                      "bottom-left",
                      "top-center",
                      "top-right",
                      "top-left"
                    ]
                  },
                  "format": {
                    "type": "string",
                    "description": "plain = 1, 2, 3 (default); page-of-total = Page 1 of 10; prefixed = your prefix then the number (for example No. 1).",
                    "enum": [
                      "plain",
                      "page-of-total",
                      "prefixed"
                    ]
                  },
                  "prefix": {
                    "type": "string",
                    "description": "Text before the number. Only used when format is prefixed. Latin letters, digits and common punctuation."
                  },
                  "startAt": {
                    "type": "number",
                    "description": "Number shown on the first numbered page. A whole number from 1 up. Default 1.",
                    "minimum": 1
                  },
                  "fontSize": {
                    "type": "number",
                    "description": "Font size in points, 4 to 72. Default 10.",
                    "minimum": 4,
                    "maximum": 72
                  },
                  "pageRange": {
                    "type": "string",
                    "description": "Pages to number, from 1, for example 2-10 or 1,3,5-8. Default: every page.",
                    "example": "2-10"
                  },
                  "skipFirstPage": {
                    "type": "string",
                    "description": "true (also yes, 1, on) to leave page 1 unnumbered, also inside pageRange. Default false."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pdf"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 2,165 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pdf/watermark": {
      "post": {
        "summary": "Stamp a text watermark on a PDF and return the PDF",
        "operationId": "pdfWatermark",
        "description": "Stamps visible text on every page, above the page content by default (set layer to behind to put it under the page's own text and pictures; a full-page scan or a solid background colour hides a watermark placed behind it). By default the text is centred, diagonal (45 degrees), mid-grey (808080) at 40% opacity, and sized automatically to fill about 80% of the page so it is always readable; long text is shrunk to fit and never runs off the page. Pages with a rotation or crop box are handled as displayed. Set position to move it to a corner (smaller) or to tile it. Errors: 400 for a missing file or text, or an option outside its range (the message names the option and its allowed range); 422 when the PDF is damaged or password-protected. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF. Up to 20 MB."
                  },
                  "text": {
                    "type": "string",
                    "description": "Watermark text, Latin letters, digits and common punctuation",
                    "example": "CONFIDENTIAL"
                  },
                  "position": {
                    "type": "string",
                    "description": "center (default), top-left, top-right, bottom-left, bottom-right or tiled",
                    "enum": [
                      "center",
                      "top-left",
                      "top-right",
                      "bottom-left",
                      "bottom-right",
                      "tiled"
                    ]
                  },
                  "opacity": {
                    "type": "number",
                    "description": "0.05 to 1 (1 is solid). Default 0.4",
                    "minimum": 0.05,
                    "maximum": 1
                  },
                  "color": {
                    "type": "string",
                    "description": "Text colour, 6-digit hex. Default 808080 (mid-grey)."
                  },
                  "fontSize": {
                    "type": "number",
                    "description": "Font size in points, 6 to 400. Default: automatic, about 80% of the page along the diagonal",
                    "minimum": 6,
                    "maximum": 400
                  },
                  "rotationDegrees": {
                    "type": "number",
                    "description": "Rotation in degrees, -360 to 360. Default 45; 0 is horizontal",
                    "minimum": -360,
                    "maximum": 360
                  },
                  "layer": {
                    "type": "string",
                    "description": "above (default) draws over the page content; behind draws under it so the page's own text stays fully dark",
                    "enum": [
                      "above",
                      "behind"
                    ]
                  }
                },
                "required": [
                  "file",
                  "text"
                ]
              },
              "example": {
                "file": "sample.pdf",
                "text": "CONFIDENTIAL"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 2,437 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pdf/extract": {
      "post": {
        "summary": "Extract pages from a PDF",
        "operationId": "pdfExtract",
        "description": "Keeps only the pages you list, for example 1,3-5,8 (pages start at 1), and returns them as a new PDF. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF. Up to 20 MB."
                  },
                  "pages": {
                    "type": "string",
                    "description": "Comma-separated pages or ranges, for example 1,3-5,8"
                  }
                },
                "required": [
                  "file",
                  "pages"
                ]
              },
              "example": {
                "file": "document.pdf",
                "pages": "1,3-5,8"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 1,188 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pdf/organize": {
      "post": {
        "summary": "Reorder, rotate, delete or insert PDF pages",
        "operationId": "pdfOrganize",
        "description": "Rebuilds a PDF page by page from a pageSpecs list. Each item is {\"type\":\"source\",\"index\":0,\"rotation\":90} to copy a page (index starts at 0; rotation optional, a multiple of 90) or {\"type\":\"blank\"} to insert a blank page. Leave a page out to delete it. Errors name the item that is wrong and give the real page count of the PDF. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF. Up to 20 MB."
                  },
                  "pageSpecs": {
                    "type": "string",
                    "description": "JSON array, for example [{\"type\":\"source\",\"index\":2},{\"type\":\"source\",\"index\":0,\"rotation\":90},{\"type\":\"blank\"}]"
                  }
                },
                "required": [
                  "file",
                  "pageSpecs"
                ]
              },
              "example": {
                "file": "document.pdf",
                "pageSpecs": "[{\"type\":\"source\",\"index\":2},{\"type\":\"source\",\"index\":0},{\"type\":\"blank\"}]"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 1,218 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pdf/flatten": {
      "post": {
        "summary": "Flatten a PDF's form fields into fixed text and return the PDF",
        "operationId": "pdfFlatten",
        "description": "Turns form fields and annotations into fixed page content. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF",
          "PDF Forms"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF. Up to 20 MB."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pdf"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 7,139 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pdf/repair": {
      "post": {
        "summary": "Repair a damaged PDF and return a PDF that opens",
        "operationId": "pdfRepair",
        "description": "Rebuilds the structure of a PDF that will not open cleanly and returns a fresh copy. A password-protected PDF is not repaired: it returns 422 saying it is password-protected. A file that is not a PDF returns 422 saying what it looks like (plain text, a picture, a Word file, an empty file); a file with no readable pages returns 422 with a plain message. The response header X-Repair-Summary says what was fixed in one sentence, for example \"Rebuilt the cross-reference table; recovered 2 pages\", or that no structural damage was found. Repair is best-effort: this endpoint reads the file leniently and rewrites it; it does not rebuild pages from a cut-off file. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF. Up to 20 MB."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pdf"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 1,442 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Repair-Summary": {
                "schema": {
                  "type": "string"
                },
                "description": "What was fixed, in one plain sentence"
              },
              "X-Pages": {
                "schema": {
                  "type": "string"
                },
                "description": "Pages in the repaired file"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pdf/compress": {
      "post": {
        "summary": "Compress a PDF to a smaller file and return the PDF",
        "operationId": "pdfCompress",
        "description": "Shrinks a PDF. By default (level=auto) it aims for half the original size (or your targetFileSize): it tidies the file structure first (text untouched), then shrinks the pictures inside only as much as needed, never below readable quality. If the target size cannot be reached it returns the best readable result and says so in the X-Target-Met and X-Compress-Note response headers (also X-Original-Bytes, X-Compressed-Bytes, X-Reduction-Percent). Returns 422 when nothing can be made smaller (for example an already-optimized, text-only PDF). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF. Up to 20 MB."
                  },
                  "level": {
                    "type": "string",
                    "description": "auto (default), medium (balanced pictures), or strong (smallest pictures).",
                    "enum": [
                      "auto",
                      "medium",
                      "strong"
                    ],
                    "default": "auto"
                  },
                  "targetFileSize": {
                    "type": "string",
                    "description": "The size you want the PDF to end up at, for example 2MB, 500KB or a number of bytes (level=auto only). Default: half the original size. If the file is already at or under it, nothing is changed.",
                    "example": "2MB"
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pdf"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 28,562 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Compress-Note": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "Reached the target size using the gentlest picture settings that fit; text stays text."
              },
              "X-Compressed-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "28562"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "119040"
              },
              "X-Reduction-Percent": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "76"
              },
              "X-Target-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "59520"
              },
              "X-Target-Met": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "true"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/image/resize": {
      "post": {
        "summary": "Resize an image by width, height or both, with fit modes, and return the image",
        "operationId": "imageResize",
        "description": "Reads JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG and BMP (not HEIC/HEIF from phones) and writes the same format unless format is given: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico. Errors: 400 for a missing file or a bad option (the message names it), 413 when the file is over 15 MB, 422 when the file cannot be read as an image. The X-Image-Width, X-Image-Height and X-Image-Frames headers describe the result. Send width, height or both: with one of them the aspect ratio is kept; with both, fit decides how the picture meets the box. fit: fill (the default, stretches to exactly width x height as this endpoint always did), contain (fits inside the box and pads the rest with backgroundColor), cover (fills the box and crops the overflow around the centre), inside (fits within the box keeping the ratio, no padding), outside (at least as large as the box, keeping the ratio). withoutEnlargement=true never makes the picture bigger than the original. Animated GIF and WebP stay animated. Limits: width and height 1 to 16384; the crop of cover is centred (no focal-point choice); output metadata is removed unless stripMetadata=false. Trial keys: images up to 10 MB (over that returns 413 file_too_large; the call is not billed). Paid plans keep the larger limit of 15 MB. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Image",
          "Image Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The image (JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG or BMP). Up to 15 MB."
                  },
                  "width": {
                    "type": "number",
                    "description": "Target width in pixels, 1 to 16384. Send width, height or both",
                    "minimum": 1,
                    "maximum": 16384
                  },
                  "height": {
                    "type": "number",
                    "description": "Target height in pixels, 1 to 16384",
                    "minimum": 1,
                    "maximum": 16384
                  },
                  "fit": {
                    "type": "string",
                    "description": "fill (default, exact size, stretches), contain, cover, inside or outside",
                    "enum": [
                      "fill",
                      "contain",
                      "cover",
                      "inside",
                      "outside"
                    ],
                    "default": "fill"
                  },
                  "withoutEnlargement": {
                    "type": "boolean",
                    "description": "Never make the picture larger than the original. Default false"
                  },
                  "format": {
                    "type": "string",
                    "description": "Output format: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico (image/... types also work). Default: the same format as the input",
                    "enum": [
                      "png",
                      "jpeg",
                      "jpg",
                      "webp",
                      "avif",
                      "gif",
                      "tiff",
                      "bmp",
                      "ico"
                    ]
                  },
                  "quality": {
                    "type": "number",
                    "description": "Quality for JPEG, WebP and AVIF (and palette PNG): 0 to 1 (for example 0.8) or 1 to 100 (for example 80)"
                  },
                  "backgroundColor": {
                    "type": "string",
                    "description": "Fill for transparent areas and for contain padding, for example #ffffff or white. JPEG always flattens onto it (white by default)"
                  },
                  "stripMetadata": {
                    "type": "boolean",
                    "description": "Remove EXIF, GPS and colour-profile data. Default true; false keeps it"
                  },
                  "animated": {
                    "type": "boolean",
                    "description": "Keep every frame of an animated GIF or WebP. Default true"
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "photo.jpg",
                "width": 800,
                "fit": "cover",
                "height": 600
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, image/png, 1,676 bytes.",
            "content": {
              "image/png, image/jpeg, image/webp, image/avif, image/gif, image/tiff, image/bmp or image/x-icon": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Image-Width": {
                "schema": {
                  "type": "string"
                },
                "description": "Width of the result in pixels",
                "example": "320"
              },
              "X-Image-Height": {
                "schema": {
                  "type": "string"
                },
                "description": "Height of the result in pixels",
                "example": "240"
              },
              "X-Image-Frames": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of frames (1 unless an animated GIF or WebP was kept)",
                "example": "1"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/image/crop": {
      "post": {
        "summary": "Crop an image by pixels or fractions",
        "operationId": "imageCrop",
        "description": "Reads JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG and BMP (not HEIC/HEIF from phones) and writes the same format unless format is given: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico. Errors: 400 for a missing file or a bad option (the message names it), 413 when the file is over 15 MB, 422 when the file cannot be read as an image. The X-Image-Width, X-Image-Height and X-Image-Frames headers describe the result. By default x, y, w and h are fractions of the image (0 to 1); add unit=px to give pixel values instead. width and height are accepted as aliases for w and h, and x and y default to 0. A box that runs past the image edge is clamped to the image. The box refers to the upright picture (a phone photo is turned upright from its EXIF flag first). An animated GIF or WebP is cropped on its first frame only. Trial keys: images up to 10 MB (over that returns 413 file_too_large; the call is not billed). Paid plans keep the larger limit of 15 MB. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Image",
          "Image Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The image (JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG or BMP). Up to 15 MB."
                  },
                  "unit": {
                    "type": "string",
                    "description": "fraction (default; values 0 to 1) or px (pixels of the original image)",
                    "enum": [
                      "fraction",
                      "px"
                    ],
                    "default": "fraction"
                  },
                  "x": {
                    "type": "number",
                    "description": "Left edge: a fraction 0 to 1, or pixels with unit=px. Default 0"
                  },
                  "y": {
                    "type": "number",
                    "description": "Top edge: a fraction 0 to 1, or pixels with unit=px. Default 0"
                  },
                  "w": {
                    "type": "number",
                    "description": "Width: a fraction above 0 up to 1, or pixels (at least 1) with unit=px. Alias: width"
                  },
                  "h": {
                    "type": "number",
                    "description": "Height: a fraction above 0 up to 1, or pixels (at least 1) with unit=px. Alias: height"
                  },
                  "width": {
                    "type": "number",
                    "description": "Alias for w"
                  },
                  "height": {
                    "type": "number",
                    "description": "Alias for h"
                  },
                  "format": {
                    "type": "string",
                    "description": "Output format: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico (image/... types also work). Default: the same format as the input",
                    "enum": [
                      "png",
                      "jpeg",
                      "jpg",
                      "webp",
                      "avif",
                      "gif",
                      "tiff",
                      "bmp",
                      "ico"
                    ]
                  },
                  "quality": {
                    "type": "number",
                    "description": "Quality for JPEG, WebP and AVIF (and palette PNG): 0 to 1 (for example 0.8) or 1 to 100 (for example 80)"
                  },
                  "backgroundColor": {
                    "type": "string",
                    "description": "Fill for transparent areas and for contain padding, for example #ffffff or white. JPEG always flattens onto it (white by default)"
                  },
                  "stripMetadata": {
                    "type": "boolean",
                    "description": "Remove EXIF, GPS and colour-profile data. Default true; false keeps it"
                  }
                },
                "required": [
                  "file",
                  "w",
                  "h"
                ]
              },
              "example": {
                "file": "photo.jpg",
                "unit": "px",
                "x": 100,
                "y": 50,
                "w": 400,
                "h": 300
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, image/png, 843 bytes.",
            "content": {
              "image/png, image/jpeg, image/webp, image/avif, image/gif, image/tiff, image/bmp or image/x-icon": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Image-Width": {
                "schema": {
                  "type": "string"
                },
                "description": "Width of the result in pixels",
                "example": "200"
              },
              "X-Image-Height": {
                "schema": {
                  "type": "string"
                },
                "description": "Height of the result in pixels",
                "example": "150"
              },
              "X-Image-Frames": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of frames (1 unless an animated GIF or WebP was kept)",
                "example": "1"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/image/flip": {
      "post": {
        "summary": "Flip an image horizontally or vertically and return the image",
        "operationId": "imageFlip",
        "description": "Reads JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG and BMP (not HEIC/HEIF from phones) and writes the same format unless format is given: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico. Errors: 400 for a missing file or a bad option (the message names it), 413 when the file is over 15 MB, 422 when the file cannot be read as an image. The X-Image-Width, X-Image-Height and X-Image-Frames headers describe the result. horizontal mirrors left to right, vertical mirrors top to bottom. An animated GIF or WebP is flipped on its first frame only. Trial keys: images up to 10 MB (over that returns 413 file_too_large; the call is not billed). Paid plans keep the larger limit of 15 MB. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Image",
          "Image Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The image (JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG or BMP). Up to 15 MB."
                  },
                  "direction": {
                    "type": "string",
                    "description": "horizontal or vertical",
                    "enum": [
                      "horizontal",
                      "vertical"
                    ]
                  },
                  "format": {
                    "type": "string",
                    "description": "Output format: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico (image/... types also work). Default: the same format as the input",
                    "enum": [
                      "png",
                      "jpeg",
                      "jpg",
                      "webp",
                      "avif",
                      "gif",
                      "tiff",
                      "bmp",
                      "ico"
                    ]
                  },
                  "quality": {
                    "type": "number",
                    "description": "Quality for JPEG, WebP and AVIF (and palette PNG): 0 to 1 (for example 0.8) or 1 to 100 (for example 80)"
                  },
                  "backgroundColor": {
                    "type": "string",
                    "description": "Fill for transparent areas and for contain padding, for example #ffffff or white. JPEG always flattens onto it (white by default)"
                  },
                  "stripMetadata": {
                    "type": "boolean",
                    "description": "Remove EXIF, GPS and colour-profile data. Default true; false keeps it"
                  }
                },
                "required": [
                  "file",
                  "direction"
                ]
              },
              "example": {
                "file": "sample.png",
                "direction": "horizontal"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, image/png, 5,747 bytes.",
            "content": {
              "image/png, image/jpeg, image/webp, image/avif, image/gif, image/tiff, image/bmp or image/x-icon": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Image-Width": {
                "schema": {
                  "type": "string"
                },
                "description": "Width of the result in pixels",
                "example": "640"
              },
              "X-Image-Height": {
                "schema": {
                  "type": "string"
                },
                "description": "Height of the result in pixels",
                "example": "480"
              },
              "X-Image-Frames": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of frames (1 unless an animated GIF or WebP was kept)",
                "example": "1"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/image/rotate": {
      "post": {
        "summary": "Rotate an image by 90, 180 or 270 degrees and return the image",
        "operationId": "imageRotate",
        "description": "Reads JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG and BMP (not HEIC/HEIF from phones) and writes the same format unless format is given: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico. Errors: 400 for a missing file or a bad option (the message names it), 413 when the file is over 15 MB, 422 when the file cannot be read as an image. The X-Image-Width, X-Image-Height and X-Image-Frames headers describe the result. Rotates clockwise by 90, 180 or 270 degrees; other angles are not supported. An animated GIF or WebP is rotated on its first frame only. Trial keys: images up to 10 MB (over that returns 413 file_too_large; the call is not billed). Paid plans keep the larger limit of 15 MB. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Image",
          "Image Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The image (JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG or BMP). Up to 15 MB."
                  },
                  "degrees": {
                    "type": "number",
                    "description": "Clockwise rotation: 90, 180 or 270",
                    "enum": [
                      90,
                      180,
                      270
                    ]
                  },
                  "format": {
                    "type": "string",
                    "description": "Output format: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico (image/... types also work). Default: the same format as the input",
                    "enum": [
                      "png",
                      "jpeg",
                      "jpg",
                      "webp",
                      "avif",
                      "gif",
                      "tiff",
                      "bmp",
                      "ico"
                    ]
                  },
                  "quality": {
                    "type": "number",
                    "description": "Quality for JPEG, WebP and AVIF (and palette PNG): 0 to 1 (for example 0.8) or 1 to 100 (for example 80)"
                  },
                  "backgroundColor": {
                    "type": "string",
                    "description": "Fill for transparent areas and for contain padding, for example #ffffff or white. JPEG always flattens onto it (white by default)"
                  },
                  "stripMetadata": {
                    "type": "boolean",
                    "description": "Remove EXIF, GPS and colour-profile data. Default true; false keeps it"
                  }
                },
                "required": [
                  "file",
                  "degrees"
                ]
              },
              "example": {
                "file": "sample.png",
                "degrees": 90
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, image/png, 5,835 bytes.",
            "content": {
              "image/png, image/jpeg, image/webp, image/avif, image/gif, image/tiff, image/bmp or image/x-icon": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Image-Width": {
                "schema": {
                  "type": "string"
                },
                "description": "Width of the result in pixels",
                "example": "480"
              },
              "X-Image-Height": {
                "schema": {
                  "type": "string"
                },
                "description": "Height of the result in pixels",
                "example": "640"
              },
              "X-Image-Frames": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of frames (1 unless an animated GIF or WebP was kept)",
                "example": "1"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/image/compress": {
      "post": {
        "summary": "Make an image file smaller (quality, target format, metadata stripping) and return it",
        "operationId": "imageCompress",
        "description": "Makes an image file smaller and returns it. Same format as the input unless format is given (png, jpeg, webp, avif, gif or tiff; converting, for example PNG to WebP, is often the biggest saving). quality is 1 to 100 (or 0 to 1) for JPEG, WebP and AVIF and defaults to 80 (AVIF 55); JPEG is written progressive. PNG stays lossless at the highest compression unless quality is below 100, which makes a smaller 256-colour palette PNG (lossy). Metadata (EXIF, GPS, colour profile) is removed unless stripMetadata=false. maxWidth and maxHeight shrink the picture first (never enlarge). Animated GIF and WebP stay animated. If the result cannot be made smaller in the same format, the original bytes are returned unchanged and X-Compress-Note says so. The X-Original-Bytes, X-Output-Bytes and X-Reduction-Percent headers report the saving. Limits: the saving depends on the picture (an already optimised JPEG may not shrink); lossy quality settings change pixels; there is no target-file-size mode. Errors: 400 for a missing file or a bad option (the message names it), 413 when the file is over 15 MB, 422 when the file cannot be read as an image. Trial keys: images up to 10 MB (over that returns 413 file_too_large; the call is not billed). Paid plans keep the larger limit of 15 MB. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Image",
          "Image Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The image (JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG or BMP). Up to 15 MB."
                  },
                  "format": {
                    "type": "string",
                    "description": "Output format: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico (image/... types also work). Default: the same format as the input",
                    "enum": [
                      "png",
                      "jpeg",
                      "jpg",
                      "webp",
                      "avif",
                      "gif",
                      "tiff",
                      "bmp",
                      "ico"
                    ]
                  },
                  "quality": {
                    "type": "number",
                    "description": "Quality for JPEG, WebP and AVIF (and palette PNG): 0 to 1 (for example 0.8) or 1 to 100 (for example 80)"
                  },
                  "backgroundColor": {
                    "type": "string",
                    "description": "Fill for transparent areas and for contain padding, for example #ffffff or white. JPEG always flattens onto it (white by default)"
                  },
                  "stripMetadata": {
                    "type": "boolean",
                    "description": "Remove EXIF, GPS and colour-profile data. Default true; false keeps it"
                  },
                  "maxWidth": {
                    "type": "number",
                    "description": "Shrink to at most this width first, 1 to 16384 (never enlarges)",
                    "minimum": 1,
                    "maximum": 16384
                  },
                  "maxHeight": {
                    "type": "number",
                    "description": "Shrink to at most this height first, 1 to 16384",
                    "minimum": 1,
                    "maximum": 16384
                  },
                  "lossless": {
                    "type": "boolean",
                    "description": "WebP and AVIF lossless mode"
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "photo.jpg",
                "quality": 75,
                "format": "webp"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, image/webp, 626 bytes.",
            "content": {
              "image/png, image/jpeg, image/webp, image/avif, image/gif, image/tiff, image/bmp or image/x-icon": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Image-Width": {
                "schema": {
                  "type": "string"
                },
                "description": "Width of the result in pixels",
                "example": "640"
              },
              "X-Image-Height": {
                "schema": {
                  "type": "string"
                },
                "description": "Height of the result in pixels",
                "example": "480"
              },
              "X-Image-Frames": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of frames (1 unless an animated GIF or WebP was kept)",
                "example": "1"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file you sent",
                "example": "5747"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "626"
              },
              "X-Reduction-Percent": {
                "schema": {
                  "type": "string"
                },
                "description": "How much smaller, in percent (0 when it could not be made smaller)",
                "example": "89.1"
              },
              "X-Compress-Note": {
                "schema": {
                  "type": "string"
                },
                "description": "Present when the original was returned unchanged or the result is not smaller"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/image/watermark": {
      "post": {
        "summary": "Add a text or picture watermark to an image and return it",
        "operationId": "imageWatermark",
        "description": "Stamps a watermark on an image and returns it. Send text (up to 200 characters, drawn in Roboto Regular: Latin, Greek and Cyrillic letters; other scripts such as Chinese or Arabic are not drawn) or a watermark picture in the file field watermark (PNG with transparency works best), not both. position: center, top-left, top, top-right, left, right, bottom-left, bottom, bottom-right (default) or tile (repeats across the picture, rotated -30 degrees by default). opacity 0 to 1 (default 0.5), margin in pixels from the edge, rotation in degrees. For text: fontSize in pixels (default about one twelfth of the shorter side), color (a name or hex, default white; a soft shadow keeps it readable). For a picture: scale is its width as a share of the image width (default 0.2). A watermark larger than the picture is scaled down to fit. An animated GIF or WebP is watermarked on its first frame only. Limits: watermark text is one line; there is no per-letter styling, font choice or invisible watermark. Errors: 400 for a missing file or a bad option (the message names it), 413 when the file is over 15 MB, 422 when the file cannot be read as an image. Trial keys: images up to 10 MB (over that returns 413 file_too_large; the call is not billed). Paid plans keep the larger limit of 15 MB. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Image",
          "Image Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The image (JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG or BMP). Up to 15 MB."
                  },
                  "text": {
                    "type": "string",
                    "description": "The words to stamp, up to 200 characters. Send this or a watermark picture"
                  },
                  "watermark": {
                    "type": "string",
                    "format": "binary",
                    "description": "The watermark picture (PNG, JPEG, WebP, GIF, TIFF or SVG). Up to 15 MB. Send this or text"
                  },
                  "position": {
                    "type": "string",
                    "description": "center, top-left, top, top-right, left, right, bottom-left, bottom, bottom-right (default) or tile",
                    "enum": [
                      "center",
                      "top-left",
                      "top",
                      "top-right",
                      "left",
                      "right",
                      "bottom-left",
                      "bottom",
                      "bottom-right",
                      "tile"
                    ],
                    "default": "bottom-right"
                  },
                  "opacity": {
                    "type": "number",
                    "description": "0 (invisible) to 1 (solid). Default 0.5",
                    "minimum": 0,
                    "maximum": 1,
                    "default": 0.5
                  },
                  "fontSize": {
                    "type": "number",
                    "description": "Text size in pixels, 6 to 1000",
                    "minimum": 6,
                    "maximum": 1000
                  },
                  "color": {
                    "type": "string",
                    "description": "Text colour: a name such as white or red, or hex such as #ffffff. Default white"
                  },
                  "margin": {
                    "type": "number",
                    "description": "Distance from the edge in pixels, 0 to 2000. Default 2% of the shorter side",
                    "minimum": 0,
                    "maximum": 2000
                  },
                  "rotation": {
                    "type": "number",
                    "description": "Rotation in degrees, -180 to 180. Default 0 (tile: -30)",
                    "minimum": -180,
                    "maximum": 180
                  },
                  "scale": {
                    "type": "number",
                    "description": "Watermark picture width as a share of the image width, above 0 up to 1. Default 0.2",
                    "minimum": 0.01,
                    "maximum": 1,
                    "default": 0.2
                  },
                  "format": {
                    "type": "string",
                    "description": "Output format: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico (image/... types also work). Default: the same format as the input",
                    "enum": [
                      "png",
                      "jpeg",
                      "jpg",
                      "webp",
                      "avif",
                      "gif",
                      "tiff",
                      "bmp",
                      "ico"
                    ]
                  },
                  "quality": {
                    "type": "number",
                    "description": "Quality for JPEG, WebP and AVIF (and palette PNG): 0 to 1 (for example 0.8) or 1 to 100 (for example 80)"
                  },
                  "backgroundColor": {
                    "type": "string",
                    "description": "Fill for transparent areas and for contain padding, for example #ffffff or white. JPEG always flattens onto it (white by default)"
                  },
                  "stripMetadata": {
                    "type": "boolean",
                    "description": "Remove EXIF, GPS and colour-profile data. Default true; false keeps it"
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "photo.jpg",
                "text": "SAMPLE",
                "position": "bottom-right",
                "opacity": 0.5
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, image/png, 13,682 bytes.",
            "content": {
              "image/png, image/jpeg, image/webp, image/avif, image/gif, image/tiff, image/bmp or image/x-icon": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Image-Width": {
                "schema": {
                  "type": "string"
                },
                "description": "Width of the result in pixels",
                "example": "640"
              },
              "X-Image-Height": {
                "schema": {
                  "type": "string"
                },
                "description": "Height of the result in pixels",
                "example": "480"
              },
              "X-Image-Frames": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of frames (1 unless an animated GIF or WebP was kept)",
                "example": "1"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/image/convert": {
      "post": {
        "summary": "Convert an image to PNG, JPEG, WebP, AVIF, GIF, TIFF, BMP or ICO and return the image",
        "operationId": "imageConvert",
        "description": "Converts one image to PNG, JPEG, WebP, AVIF, GIF, TIFF, BMP or ICO (several icon sizes in one file) and returns the single converted file with the right Content-Type and file extension. Inputs: JPEG, PNG, WebP, GIF (animated GIFs and WebPs stay animated when the output is GIF or WebP), AVIF, TIFF, SVG and BMP. HEIC/HEIF input is not supported and returns 400. Optional controls: quality, background colour for formats without transparency, lossless, progressive JPEG, resize with fit modes, rotate and flip, grayscale, auto-orient from EXIF, keep or strip metadata, DPI, sharpen and blur. Options that do not apply to the chosen format are ignored. backgroundColor (hex such as #ffffff) fills transparent areas; JPEG (and 24-bit BMP) has no transparency, so it always flattens onto backgroundColor, white by default. Errors: 400 for a bad option (the message names it, for example an invalid backgroundColor), 413 when the file is over 15 MB, 422 when the file cannot be read as an image. Response headers X-Image-Width, X-Image-Height and X-Image-Frames describe the result. Trial keys: images up to 10 MB (over that returns 413 file_too_large; the call is not billed). Paid plans keep the larger limit of 15 MB. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Image",
          "Image Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The image. Up to 15 MB."
                  },
                  "format": {
                    "type": "string",
                    "description": "Output format: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico. image/... types such as image/webp are accepted too.",
                    "enum": [
                      "png",
                      "jpeg",
                      "webp",
                      "avif",
                      "gif",
                      "tiff",
                      "bmp",
                      "ico"
                    ]
                  },
                  "quality": {
                    "type": "number",
                    "description": "Quality for JPEG, WebP and AVIF (also palette PNG and JPEG-compressed TIFF). Either 0 to 1 (0.8) or 1 to 100 (80); 1 means 100. Defaults: JPEG 90, WebP 85, AVIF 60."
                  },
                  "backgroundColor": {
                    "type": "string",
                    "description": "Fill for transparent areas and for the padding of fit=contain: a hex colour such as #ffffff, ffffff or #fff, or a colour name such as white. Default white for JPEG and 24-bit BMP. For other formats it is only applied when you send it (GIF: send it to flatten transparency). Junk values return 400."
                  },
                  "lossless": {
                    "type": "boolean",
                    "description": "WebP and AVIF lossless mode. For PNG, false makes a smaller 256-colour palette PNG."
                  },
                  "progressive": {
                    "type": "boolean",
                    "description": "JPEG only: progressive (interlaced) scan."
                  },
                  "chromaSubsampling": {
                    "type": "string",
                    "description": "JPEG and AVIF colour detail: 4:4:4 (sharpest colour edges) or 4:2:0 (smaller file).",
                    "enum": [
                      "4:4:4",
                      "4:2:0"
                    ]
                  },
                  "pngCompressionLevel": {
                    "type": "number",
                    "description": "PNG zlib level 0 to 9 (default 6). Higher is smaller and slower.",
                    "minimum": 0,
                    "maximum": 9
                  },
                  "pngPalette": {
                    "type": "boolean",
                    "description": "PNG only: reduce to a palette of up to 256 colours for a much smaller file."
                  },
                  "effort": {
                    "type": "number",
                    "description": "CPU effort from 0 (fastest) to 10 (smallest file); clamped to the format's own range (WebP 0-6, AVIF 0-9, PNG and GIF 1-10). 'speed' is accepted as the same setting.",
                    "minimum": 0,
                    "maximum": 10
                  },
                  "width": {
                    "type": "number",
                    "description": "Target width in pixels (1 to 16384). With only one of width and height the other follows the picture's shape.",
                    "minimum": 1,
                    "maximum": 16384
                  },
                  "height": {
                    "type": "number",
                    "description": "Target height in pixels (1 to 16384).",
                    "minimum": 1,
                    "maximum": 16384
                  },
                  "fit": {
                    "type": "string",
                    "description": "How the picture meets width and height: inside (default; fits within the box, keeps the shape), contain (fits and pads to the exact box), cover (fills the box and crops the overflow), fill (stretches to the box), outside (at least as large as the box).",
                    "enum": [
                      "inside",
                      "contain",
                      "cover",
                      "fill",
                      "outside"
                    ],
                    "default": "inside"
                  },
                  "withoutEnlargement": {
                    "type": "boolean",
                    "description": "Never make the picture larger than the original."
                  },
                  "autoOrient": {
                    "type": "boolean",
                    "description": "Turn photos upright from their EXIF rotation flag. Default true."
                  },
                  "stripMetadata": {
                    "type": "boolean",
                    "description": "Remove EXIF, location, camera and colour-profile data. Default true; false keeps it where the output format can hold it."
                  },
                  "grayscale": {
                    "type": "boolean",
                    "description": "Convert to black and white."
                  },
                  "dpi": {
                    "type": "number",
                    "description": "Print resolution to write into PNG, JPEG, TIFF and BMP files, 1 to 2400. It does not change the pixel size.",
                    "minimum": 1,
                    "maximum": 2400
                  },
                  "rotate": {
                    "type": "number",
                    "description": "Rotate clockwise by a multiple of 90 degrees (90, 180, 270, -90). Not available for animated output."
                  },
                  "flip": {
                    "type": "boolean",
                    "description": "Mirror top to bottom."
                  },
                  "flop": {
                    "type": "boolean",
                    "description": "Mirror left to right."
                  },
                  "sharpen": {
                    "type": "string",
                    "description": "true, or an amount (sigma) from 0.3 to 100, to sharpen the result."
                  },
                  "blur": {
                    "type": "string",
                    "description": "true, or an amount (sigma) from 0.3 to 100, to blur the result."
                  },
                  "sizes": {
                    "type": "string",
                    "description": "ICO only: pixel sizes to pack into the icon, from 16, 32, 48, 64, 128, 256, comma separated. Default 16,32,48.",
                    "example": "16,32,48,256"
                  },
                  "bitDepth": {
                    "type": "number",
                    "description": "BMP only: 24 (default; transparency is flattened on the background colour) or 32 (keeps transparency).",
                    "enum": [
                      24,
                      32
                    ]
                  },
                  "tiffCompression": {
                    "type": "string",
                    "description": "TIFF only: none, lzw (default), deflate or jpeg.",
                    "enum": [
                      "none",
                      "lzw",
                      "deflate",
                      "jpeg"
                    ]
                  },
                  "animated": {
                    "type": "boolean",
                    "description": "Keep every frame of an animated GIF or WebP when the output is GIF or WebP. Default true; false converts only the first frame."
                  }
                },
                "required": [
                  "file",
                  "format"
                ]
              },
              "example": {
                "file": "sample.png",
                "format": "png"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, image/jpeg, 2,070 bytes.",
            "content": {
              "image/png, image/jpeg, image/webp, image/avif, image/gif, image/tiff, image/bmp or image/x-icon": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Image-Frames": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "1"
              },
              "X-Image-Height": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "480"
              },
              "X-Image-Width": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "640"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/video/convert": {
      "post": {
        "summary": "Convert a video to MP4, WebM or MOV and return the video",
        "operationId": "videoConvert",
        "description": "Video files are processed on a shared server, so large files can take a minute or more; keep uploads small (for example under 50 MB) for fast results. Re-encodes a video to another container. mov gives a QuickTime file that plays everywhere: H.264 video (yuv420p, even picture size), AAC audio and the index at the front of the file. mp4 and mp4-web use the same codecs; webm uses VP8 and Vorbis. Errors: 400 for a missing file or a bad option, 413 when the file is over the size limit, 422 when the video cannot be read or processed (the message says why). Trial keys: video up to 25 MB and 60 seconds in total (over the size returns 413 file_too_large, over the length returns 422 duration_too_long; neither is billed). Paid plans keep the larger limits (100 MB per file). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Video",
          "Video Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The video. Up to 100 MB."
                  },
                  "format": {
                    "type": "string",
                    "description": "mp4, mp4-web (H.264 with faststart for web playback), webm or mov",
                    "enum": [
                      "mp4",
                      "mp4-web",
                      "webm",
                      "mov"
                    ]
                  }
                },
                "required": [
                  "file",
                  "format"
                ]
              },
              "example": {
                "file": "sample.mp4",
                "format": "mp4"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, video/webm, 59,681 bytes.",
            "content": {
              "video/mp4, video/webm or video/quicktime": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted or an unsupported format), or on trial keys it is longer than 60 seconds (code \"duration_too_long\", with limit_seconds and received_seconds). Neither is billed."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/video/trim": {
      "post": {
        "summary": "Trim a video between a start and end time and return the clip",
        "operationId": "videoTrim",
        "description": "Video files are processed on a shared server, so large files can take a minute or more; keep uploads small (for example under 50 MB) for fast results. Keeps the part between two times (startSeconds and endSeconds are seconds from the start of the video, decimals allowed; endSeconds must be greater than startSeconds). The video is re-encoded so the cut starts and ends exactly at the times you give (for example 0 to 11 seconds returns the first 11 seconds). Errors: 400 for a missing file or a bad option, 413 when the file is over the size limit, 422 when the video cannot be read or processed (the message says why). Trial keys: video up to 25 MB and 60 seconds in total (over the size returns 413 file_too_large, over the length returns 422 duration_too_long; neither is billed). Paid plans keep the larger limits (100 MB per file). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Video",
          "Video Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The video. Up to 100 MB."
                  },
                  "startSeconds": {
                    "type": "number",
                    "description": "Start time in seconds"
                  },
                  "endSeconds": {
                    "type": "number",
                    "description": "End time in seconds"
                  }
                },
                "required": [
                  "file",
                  "startSeconds",
                  "endSeconds"
                ]
              },
              "example": {
                "file": "sample.mp4",
                "startSeconds": 1,
                "endSeconds": 1
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, video/mp4, 17,775 bytes.",
            "content": {
              "video/mp4": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted or an unsupported format), or on trial keys it is longer than 60 seconds (code \"duration_too_long\", with limit_seconds and received_seconds). Neither is billed."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/video/merge": {
      "post": {
        "summary": "Join several videos into one and return the video",
        "operationId": "videoMerge",
        "description": "Video files are processed on a shared server, so large files can take a minute or more; keep uploads small (for example under 50 MB) for fast results. Joins videos end to end, strictly in the order sent: send each video as a repeated 'files' field and they play in the order they appear in the request. If you name the fields with numbers (video1, video2, ... or files[0], files[1], ...) they play in numeric order, whatever order they arrive in. Videos with different sizes or codecs are matched to the first video; audio is kept when every video has an audio track. Errors: 400 for a missing file or a bad option, 413 when the file is over the size limit, 422 when the video cannot be read or processed (the message says why). Trial keys: video up to 25 MB and 60 seconds in total (over the size returns 413 file_too_large, over the length returns 422 duration_too_long; neither is billed). Paid plans keep the larger limits (100 MB per file). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Video",
          "Video Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "files": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "binary"
                    },
                    "description": "Two or more videos (repeat the field). Each up to 100 MB."
                  }
                },
                "required": [
                  "files"
                ]
              },
              "example": {
                "files": [
                  "a.mp4",
                  "b.mp4"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, video/mp4, 90,626 bytes.",
            "content": {
              "video/mp4": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted or an unsupported format), or on trial keys it is longer than 60 seconds (code \"duration_too_long\", with limit_seconds and received_seconds). Neither is billed."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/video/extract-audio": {
      "post": {
        "summary": "Extract the audio of a video as MP3",
        "operationId": "videoExtractAudio",
        "description": "Video files are processed on a shared server, so large files can take a minute or more; keep uploads small (for example under 50 MB) for fast results. Returns the soundtrack as an MP3 file. Errors share one shape, {error, code, details: {fieldErrors, formErrors, issues}}: 400 with code missing_file, empty_file or invalid_multipart; 413 file_too_large; 422 with code no_audio_track, unreadable_video, unsupported_codec or processing_timeout when the file itself cannot be processed. Example: curl -X POST https://api.freedailypro.com/v1/video/extract-audio -H \"X-API-Key: YOUR_KEY\" -F file=@clip.mp4 -o audio.mp3 Trial keys: video up to 25 MB and 60 seconds in total (over the size returns 413 file_too_large, over the length returns 422 duration_too_long; neither is billed). Paid plans keep the larger limits (100 MB per file). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Video",
          "Video Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The video. Up to 100 MB."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.mp4"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, audio/mpeg, 11,150 bytes.",
            "content": {
              "audio/mpeg": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted or an unsupported format), or on trial keys it is longer than 60 seconds (code \"duration_too_long\", with limit_seconds and received_seconds). Neither is billed."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/video/thumbnail": {
      "post": {
        "summary": "Grab a still frame from a video and return it as a JPEG image",
        "operationId": "videoThumbnail",
        "description": "Video files are processed on a shared server, so large files can take a minute or more; keep uploads small (for example under 50 MB) for fast results. Returns a JPEG of the frame at the given time. Trial keys: video up to 25 MB and 60 seconds in total (over the size returns 413 file_too_large, over the length returns 422 duration_too_long; neither is billed). Paid plans keep the larger limits (100 MB per file). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Video",
          "Video Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The video. Up to 100 MB."
                  },
                  "atSeconds": {
                    "type": "number",
                    "description": "Time of the frame in seconds, default 0"
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.mp4"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, image/jpeg, 9,367 bytes.",
            "content": {
              "image/jpeg": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted or an unsupported format), or on trial keys it is longer than 60 seconds (code \"duration_too_long\", with limit_seconds and received_seconds). Neither is billed."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/audio/convert": {
      "post": {
        "summary": "Convert audio to MP3, WAV, OGG, M4A or FLAC and return the audio",
        "operationId": "audioConvert",
        "description": "Re-encodes audio to another format. Trial keys: audio up to 25 MB and 60 seconds in total (over the size returns 413 file_too_large, over the length returns 422 duration_too_long; neither is billed). Paid plans keep the larger limits (30 MB per file). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Audio",
          "Audio Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The audio file. Up to 30 MB."
                  },
                  "format": {
                    "type": "string",
                    "description": "mp3, wav, ogg, m4a or flac",
                    "enum": [
                      "mp3",
                      "wav",
                      "ogg",
                      "m4a",
                      "flac"
                    ]
                  }
                },
                "required": [
                  "file",
                  "format"
                ]
              },
              "example": {
                "file": "sample.mp3",
                "format": "mp3"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, audio/wav, 264,678 bytes.",
            "content": {
              "audio/*": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted or an unsupported format), or on trial keys it is longer than 60 seconds (code \"duration_too_long\", with limit_seconds and received_seconds). Neither is billed."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/audio/trim": {
      "post": {
        "summary": "Trim audio between a start and end time and return the clip",
        "operationId": "audioTrim",
        "description": "Keeps the part between startSeconds and endSeconds and returns it as MP3. Both are required. Errors: 400 when startSeconds or endSeconds is beyond the length of the audio (the message gives the length), when endSeconds is not greater than startSeconds, or when the file is not readable audio. It never returns an empty file. Trial keys: audio up to 25 MB and 60 seconds in total (over the size returns 413 file_too_large, over the length returns 422 duration_too_long; neither is billed). Paid plans keep the larger limits (30 MB per file). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Audio",
          "Audio Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The audio file. Up to 30 MB."
                  },
                  "startSeconds": {
                    "type": "number",
                    "description": "Start time in seconds, 0 or more, before the end of the audio",
                    "minimum": 0
                  },
                  "endSeconds": {
                    "type": "number",
                    "description": "End time in seconds, greater than startSeconds and not beyond the end of the audio"
                  }
                },
                "required": [
                  "file",
                  "startSeconds",
                  "endSeconds"
                ]
              },
              "example": {
                "file": "sample.mp3",
                "startSeconds": 0,
                "endSeconds": 1
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, audio/mpeg, 10,291 bytes.",
            "content": {
              "audio/mpeg": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted or an unsupported format), or on trial keys it is longer than 60 seconds (code \"duration_too_long\", with limit_seconds and received_seconds). Neither is billed."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/audio/merge": {
      "post": {
        "summary": "Join several audio files into one and return the audio",
        "operationId": "audioMerge",
        "description": "Joins audio files end to end in the order sent. Trial keys: audio up to 25 MB and 60 seconds in total (over the size returns 413 file_too_large, over the length returns 422 duration_too_long; neither is billed). Paid plans keep the larger limits (30 MB per file). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Audio",
          "Audio Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "files": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "binary"
                    },
                    "description": "Two or more audio files (repeat the field). Each up to 30 MB."
                  }
                },
                "required": [
                  "files"
                ]
              },
              "example": {
                "files": [
                  "a.mp3",
                  "b.mp3"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, audio/mpeg, 28,336 bytes.",
            "content": {
              "audio/mpeg": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted or an unsupported format), or on trial keys it is longer than 60 seconds (code \"duration_too_long\", with limit_seconds and received_seconds). Neither is billed."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/audio/compress": {
      "post": {
        "summary": "Compress audio to a smaller MP3, optionally to a target size, and return the audio",
        "operationId": "audioCompress",
        "description": "Re-encodes the audio as MP3 so that the result is about targetFileSize. targetFileSize is optional: leave it out and the result is about half the original size (0.5). The size is reached by choosing a bitrate between 32 and 320 kbps, so very small or very large targets are limited to that range, and a target at or above the original size is treated as 99% of it. Different targets give different file sizes. Trial keys: audio up to 25 MB and 60 seconds in total (over the size returns 413 file_too_large, over the length returns 422 duration_too_long; neither is billed). Paid plans keep the larger limits (30 MB per file). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Audio",
          "Audio Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The audio file. Up to 30 MB."
                  },
                  "targetFileSize": {
                    "type": "string",
                    "description": "Optional. The size you want the file to end up at, for example 2MB, 500KB or a number of bytes. Default: half the original size.",
                    "example": "2MB"
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.mp3"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, audio/mpeg, 12,347 bytes.",
            "content": {
              "audio/mpeg": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted or an unsupported format), or on trial keys it is longer than 60 seconds (code \"duration_too_long\", with limit_seconds and received_seconds). Neither is billed."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/audio/normalize": {
      "post": {
        "summary": "Normalize audio loudness and return the audio",
        "operationId": "audioNormalize",
        "description": "Brings the whole file to one target loudness (EBU R128 integrated loudness, default -16 LUFS, true peak limited to -1.5 dB) in two passes: the file is measured first, then one fixed gain is applied, so the result lands on the target. Quiet files get louder and loud files get quieter. Returns MP3 at the file's own sample rate (or 44.1 kHz). A silent file returns 400. Trial keys: audio up to 25 MB and 60 seconds in total (over the size returns 413 file_too_large, over the length returns 422 duration_too_long; neither is billed). Paid plans keep the larger limits (30 MB per file). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Audio",
          "Audio Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The audio file. Up to 30 MB."
                  },
                  "targetLufs": {
                    "type": "number",
                    "description": "Optional. The loudness to reach, as LUFS below full scale: 16 means -16 LUFS (default), 23 means -23 LUFS. 5 to 40.",
                    "minimum": 5,
                    "maximum": 40,
                    "default": 16
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.mp3"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, audio/mpeg, 18,585 bytes.",
            "content": {
              "audio/mpeg": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted or an unsupported format), or on trial keys it is longer than 60 seconds (code \"duration_too_long\", with limit_seconds and received_seconds). Neither is billed."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/audio/speed": {
      "post": {
        "summary": "Change audio speed between 0.5x and 2x and return the audio",
        "operationId": "audioSpeed",
        "description": "Speeds up or slows down without changing pitch. Trial keys: audio up to 25 MB and 60 seconds in total (over the size returns 413 file_too_large, over the length returns 422 duration_too_long; neither is billed). Paid plans keep the larger limits (30 MB per file). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Audio",
          "Audio Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The audio file. Up to 30 MB."
                  },
                  "speed": {
                    "type": "number",
                    "description": "Between 0.5 and 2.0, for example 1.5"
                  }
                },
                "required": [
                  "file",
                  "speed"
                ]
              },
              "example": {
                "file": "sample.mp3",
                "speed": 1
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, audio/mpeg, 11,539 bytes.",
            "content": {
              "audio/mpeg": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted or an unsupported format), or on trial keys it is longer than 60 seconds (code \"duration_too_long\", with limit_seconds and received_seconds). Neither is billed."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/audio/pitch": {
      "post": {
        "summary": "Shift audio pitch by semitones and return the audio",
        "operationId": "audioPitch",
        "description": "Raises or lowers the pitch by a number of semitones and keeps the original speed and length (a 3 second file stays 3 seconds). Works for any sample rate. 12 semitones is one octave. Returns MP3. Trial keys: audio up to 25 MB and 60 seconds in total (over the size returns 413 file_too_large, over the length returns 422 duration_too_long; neither is billed). Paid plans keep the larger limits (30 MB per file). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Audio",
          "Audio Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The audio file. Up to 30 MB."
                  },
                  "semitones": {
                    "type": "number",
                    "description": "Required. From -24 to 24: for example 4 to go up four semitones or -3 to go down three. 0 leaves the pitch unchanged.",
                    "minimum": -24,
                    "maximum": 24
                  }
                },
                "required": [
                  "file",
                  "semitones"
                ]
              },
              "example": {
                "file": "sample.mp3",
                "semitones": -24
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, audio/mpeg, 13,698 bytes.",
            "content": {
              "audio/mpeg": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted or an unsupported format), or on trial keys it is longer than 60 seconds (code \"duration_too_long\", with limit_seconds and received_seconds). Neither is billed."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/audio/denoise": {
      "post": {
        "summary": "Reduce background noise in audio and return the audio",
        "operationId": "audioDenoise",
        "description": "Reduces steady background noise (hiss, hum, fan noise). A higher strengthDb always removes more noise. Very high values can make voices sound thin, so start around the default. Returns MP3. Trial keys: audio up to 25 MB and 60 seconds in total (over the size returns 413 file_too_large, over the length returns 422 duration_too_long; neither is billed). Paid plans keep the larger limits (30 MB per file). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Audio",
          "Audio Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The audio file. Up to 30 MB."
                  },
                  "strengthDb": {
                    "type": "number",
                    "description": "Optional. Noise reduction strength: minimum 1, maximum 60, default 30. Higher removes more noise.",
                    "minimum": 1,
                    "maximum": 60,
                    "default": 30
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.mp3"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, audio/mpeg, 12,838 bytes.",
            "content": {
              "audio/mpeg": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted or an unsupported format), or on trial keys it is longer than 60 seconds (code \"duration_too_long\", with limit_seconds and received_seconds). Neither is billed."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/audio/remove-silence": {
      "post": {
        "summary": "Cut silent gaps out of audio and return the audio",
        "operationId": "audioRemoveSilence",
        "description": "Cuts every silent stretch that lasts at least minDurationSeconds, anywhere in the file (start, middle and end), and joins what is left. Only silence is removed: speech or sound, even a very short word, is never cut. Silences shorter than minDurationSeconds stay. If nothing qualifies, the audio comes back unchanged (as MP3), including when minDurationSeconds is longer than the file. Errors: 400 for a thresholdDb outside -90 to -10, a minDurationSeconds outside 0.01 to 60, a file that is not readable audio, or a file that is entirely quieter than thresholdDb (the message suggests a lower threshold). It never returns an empty file. Trial keys: audio up to 25 MB and 60 seconds in total (over the size returns 413 file_too_large, over the length returns 422 duration_too_long; neither is billed). Paid plans keep the larger limits (30 MB per file). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Audio",
          "Audio Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The audio file. Up to 30 MB."
                  },
                  "minDurationSeconds": {
                    "type": "number",
                    "description": "Optional. Shortest silence to remove, in seconds: 0.01 to 60, default 0.3.",
                    "minimum": 0.01,
                    "maximum": 60,
                    "default": 0.3
                  },
                  "thresholdDb": {
                    "type": "number",
                    "description": "Optional. Audio quieter than this counts as silence, in dB: -90 to -10, default -30. Use a lower value (for example -50) for quiet recordings.",
                    "minimum": -90,
                    "maximum": -10,
                    "default": -30
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.mp3"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, audio/mpeg, 14,607 bytes.",
            "content": {
              "audio/mpeg": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted or an unsupported format), or on trial keys it is longer than 60 seconds (code \"duration_too_long\", with limit_seconds and received_seconds). Neither is billed."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/video/to-gif": {
      "post": {
        "summary": "Turn a video clip into an animated GIF and return the GIF",
        "operationId": "videoToGif",
        "description": "Video files are processed on a shared server, so large files can take a minute or more; keep uploads small (for example under 50 MB) for fast results. Returns a complete, playable GIF of the clip, up to about 1.9 MB. Longer or larger clips are made smaller (lower frame rate and width, never shorter) so the GIF is never cut off. If even the smallest setting would exceed 1.9 MB the request is refused with 422 and a message asking for a shorter clip (about 10 seconds is safe), rather than returning a truncated file. Errors: 400 for a missing file or a bad option, 413 when the file is over the size limit, 422 when the video cannot be read or processed (the message says why). Trial keys: video up to 25 MB and 60 seconds in total (over the size returns 413 file_too_large, over the length returns 422 duration_too_long; neither is billed). Paid plans keep the larger limits (100 MB per file). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Video",
          "Video Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The video. Up to 100 MB."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.mp4"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, image/gif, 293,374 bytes.",
            "content": {
              "image/gif": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted or an unsupported format), or on trial keys it is longer than 60 seconds (code \"duration_too_long\", with limit_seconds and received_seconds). Neither is billed."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/video/subtitle": {
      "post": {
        "summary": "Burn SRT subtitles into a video and return the video",
        "operationId": "videoSubtitle",
        "description": "Video files are processed on a shared server, so large files can take a minute or more; keep uploads small (for example under 50 MB) for fast results. Draws the subtitle text permanently on the picture. Trial keys: video up to 25 MB and 60 seconds in total (over the size returns 413 file_too_large, over the length returns 422 duration_too_long; neither is billed). Paid plans keep the larger limits (100 MB per file). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Video",
          "Video Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The video. Up to 100 MB."
                  },
                  "srt": {
                    "type": "string",
                    "description": "Subtitles in SRT format"
                  }
                },
                "required": [
                  "file",
                  "srt"
                ]
              },
              "example": {
                "file": "sample.mp4",
                "srt": "value"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, video/mp4, 37,848 bytes.",
            "content": {
              "video/mp4": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted or an unsupported format), or on trial keys it is longer than 60 seconds (code \"duration_too_long\", with limit_seconds and received_seconds). Neither is billed."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/video/compress": {
      "post": {
        "summary": "Compress a video to a target size and return the video",
        "operationId": "videoCompress",
        "description": "Video files are processed on a shared server, so large files can take a minute or more; keep uploads small (for example under 50 MB) for fast results. Re-encodes a video to a smaller file. The response headers X-Met-Target, X-Output-Size and X-Target-Size report how close it got. Errors share one shape, {error, code, details: {fieldErrors, formErrors, issues}}: 400 with code missing_file, empty_file, invalid_multipart or invalid_target_size; 413 file_too_large; 422 with code unreadable_video, unsupported_codec, no_video_track or processing_timeout when the file itself cannot be processed. Example: curl -X POST https://api.freedailypro.com/v1/video/compress -H \"X-API-Key: YOUR_KEY\" -F file=@clip.mp4 -F targetFileSize=25MB -o compressed.mp4 Trial keys: video up to 25 MB and 60 seconds in total (over the size returns 413 file_too_large, over the length returns 422 duration_too_long; neither is billed). Paid plans keep the larger limits (100 MB per file). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Video",
          "Video Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The video. Up to 100 MB."
                  },
                  "targetFileSize": {
                    "type": "string",
                    "description": "The size you want the video to end up at, for example 25MB, 500KB or a number of bytes. Default: half the original size.",
                    "example": "25MB"
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.mp4"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, video/mp4, 54,103 bytes.",
            "content": {
              "video/mp4": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Met-Target": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "false"
              },
              "X-Output-Size": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "54103"
              },
              "X-Target-Size": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "15195"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits."
          },
          "422": {
            "description": "The file could not be processed (corrupted or an unsupported format), or on trial keys it is longer than 60 seconds (code \"duration_too_long\", with limit_seconds and received_seconds). Neither is billed."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/publishing/typeset-book": {
      "post": {
        "summary": "Typeset a print-ready book PDF (trim size, fonts, front and back matter)",
        "operationId": "publishingTypesetBook",
        "description": "Renders chapters and optional front and back matter to a paginated, print-ready PDF at your trim size (inches), with real hyphenation, running headers, page numbers (front matter in roman numerals, then arabic), drop caps, widow and orphan control, an optional table of contents and full-bleed covers. The response body is the PDF (application/pdf). Body font: one of six embedded fonts (default literata). Margins follow gutterModel (default kdp-scaled: KDP inside margins that grow with the page count). The copyright page reads \"(c) year holder\": copyrightHolder, else the names of the authors with role main, else only the year (never the book title); copyrightYear defaults to the current year. The watermark is opt-in. By default (watermark absent or false) the file is clean and contains no promotional text. Send watermark: true to add a visible preview marking: in the PDF a light diagonal PREVIEW tiled over every page; in the EPUB a red banner reading PREVIEW COPY on the cover and at the top of every chapter; in the DOCX a PREVIEW COPY line in the page header. The X-Watermark response header says which was produced. The PDF fonts are embedded and cover Latin (all accented letters, including Polish, Czech, Turkish, Romanian and Vietnamese), Greek (including polytonic), Cyrillic, Hebrew, Arabic, Devanagari (Hindi, Marathi, Nepali), Bengali, Tamil, Telugu, Gujarati, Kannada, Malayalam and Thai; Hebrew and Arabic are set right to left. Chinese, Japanese, Korean, Punjabi, Sinhala, Lao, Khmer, Burmese, Georgian, Armenian and Ethiopic would print as missing characters, so such text is refused with 422 and code unsupported_script (the body names the scripts found, the field and the supported list) before anything is rendered. Use the EPUB or DOCX endpoint for such text. Symbols, emoji and punctuation are not checked. Rendering uses a headless browser: at most 3 PDFs are rendered at the same time and up to 40 wait in a queue (at most 90 seconds); when it is busy the answer is 503 with a Retry-After header, and error messages never contain internal output or file paths. Limits: trim 3 to 14 inches, up to 100 chapters, 800 blocks per chapter, about 10 MB per picture. All fields not listed in the schema are rejected with a 400. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "bookTitle": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 300,
                    "description": "The book title: title page, cover, running header. Spaces at both ends are removed first; a blank title is a 400."
                  },
                  "subtitle": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "edition": {
                    "description": "For example 2nd Edition; shown on the title page and covers.",
                    "type": "string",
                    "maxLength": 200
                  },
                  "seriesName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "direction": {
                    "description": "Reading direction: auto (the default), ltr or rtl. With auto, a book whose text is mostly Arabic or Hebrew is laid out right to left and anything else left to right; ltr or rtl overrides that. Right to left means the first page is a left-hand page with the binding on its right, mirrored margins, text, lists, tables and the table of contents running from the right, correct mixing of English words and numbers inside Arabic or Hebrew lines, and a PDF marked right-to-left (page 1 on the right of the spine in two-page view). EPUB: every page is dir=rtl and the spine has page-progression-direction=rtl. DOCX: right-to-left paragraphs and sections, Arabic and Hebrew runs marked right-to-left.",
                    "type": "string",
                    "enum": [
                      "auto",
                      "ltr",
                      "rtl"
                    ]
                  },
                  "bodyFontFamily": {
                    "description": "Body font, embedded in the PDF. Default literata. Eight OFL fonts: literata, eb-garamond, merriweather, lora, tinos (serif), inter, arimo (sans), playfair-display (display). All draw Latin (including Polish, Czech, Turkish, Romanian and Vietnamese letters); Greek and Cyrillic come from the font or from Tinos when the font lacks them (Lora and Playfair Display have no Greek); Hebrew, Arabic, Devanagari, Bengali, Tamil, Telugu, Gujarati, Kannada, Malayalam and Thai are added from embedded Noto fonts (Tinos for Hebrew) when the text needs them. Chinese, Japanese, Korean and other unsupported scripts are rejected with 422 unsupported_script.",
                    "type": "string",
                    "enum": [
                      "literata",
                      "eb-garamond",
                      "merriweather",
                      "lora",
                      "tinos",
                      "inter",
                      "arimo",
                      "playfair-display"
                    ]
                  },
                  "isbn": {
                    "description": "Printed on the copyright page as given. ISBN-10 or ISBN-13; hyphens and spaces are allowed. The length and the check digit are verified, and a value that is not a valid ISBN is a 400.",
                    "type": "string",
                    "maxLength": 50
                  },
                  "eisbn": {
                    "description": "Electronic ISBN, printed on the copyright page. ISBN-10 or ISBN-13; hyphens and spaces are allowed. The length and the check digit are verified, and a value that is not a valid ISBN is a 400.",
                    "type": "string",
                    "maxLength": 50
                  },
                  "frontCover": {
                    "description": "Adds a full-bleed front cover as the first page.",
                    "type": "object",
                    "properties": {
                      "imageDataUri": {
                        "description": "Full-bleed cover image as a data URI.",
                        "type": "string",
                        "maxLength": 15000000
                      },
                      "publisherLogoDataUri": {
                        "type": "string",
                        "maxLength": 15000000
                      },
                      "publisherName": {
                        "type": "string",
                        "maxLength": 300
                      }
                    },
                    "additionalProperties": false
                  },
                  "backCover": {
                    "description": "Adds a full-bleed back cover as the last page.",
                    "type": "object",
                    "properties": {
                      "imageDataUri": {
                        "type": "string",
                        "maxLength": 15000000
                      },
                      "blurb": {
                        "description": "The back-cover text.",
                        "minItems": 1,
                        "maxItems": 800,
                        "type": "array",
                        "items": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "paragraph"
                                  ]
                                },
                                "runs": {
                                  "minItems": 1,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "text": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The words of this run. Control characters that XML cannot hold are removed."
                                      },
                                      "bold": {
                                        "type": "boolean"
                                      },
                                      "italic": {
                                        "type": "boolean"
                                      },
                                      "underline": {
                                        "type": "boolean"
                                      },
                                      "color": {
                                        "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                        "type": "string",
                                        "pattern": "^#[0-9a-fA-F]{3,8}$"
                                      },
                                      "superscript": {
                                        "type": "boolean"
                                      },
                                      "subscript": {
                                        "type": "boolean"
                                      }
                                    },
                                    "required": [
                                      "text"
                                    ],
                                    "additionalProperties": false,
                                    "description": "A piece of text with one style. A paragraph is a list of runs."
                                  }
                                },
                                "align": {
                                  "type": "string",
                                  "enum": [
                                    "left",
                                    "center",
                                    "right",
                                    "justify"
                                  ]
                                },
                                "lineHeight": {
                                  "type": "string",
                                  "pattern": "^[0-9](\\.[0-9]+)?$",
                                  "description": "Line height as a multiplier written as text, for example 1.5."
                                }
                              },
                              "required": [
                                "type",
                                "runs"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "heading"
                                  ]
                                },
                                "runs": {
                                  "minItems": 1,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "text": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The words of this run. Control characters that XML cannot hold are removed."
                                      },
                                      "bold": {
                                        "type": "boolean"
                                      },
                                      "italic": {
                                        "type": "boolean"
                                      },
                                      "underline": {
                                        "type": "boolean"
                                      },
                                      "color": {
                                        "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                        "type": "string",
                                        "pattern": "^#[0-9a-fA-F]{3,8}$"
                                      },
                                      "superscript": {
                                        "type": "boolean"
                                      },
                                      "subscript": {
                                        "type": "boolean"
                                      }
                                    },
                                    "required": [
                                      "text"
                                    ],
                                    "additionalProperties": false,
                                    "description": "A piece of text with one style. A paragraph is a list of runs."
                                  }
                                },
                                "level": {
                                  "anyOf": [
                                    {
                                      "type": "number",
                                      "enum": [
                                        1
                                      ]
                                    },
                                    {
                                      "type": "number",
                                      "enum": [
                                        2
                                      ]
                                    },
                                    {
                                      "type": "number",
                                      "enum": [
                                        3
                                      ]
                                    },
                                    {
                                      "type": "number",
                                      "enum": [
                                        4
                                      ]
                                    }
                                  ],
                                  "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                                },
                                "align": {
                                  "type": "string",
                                  "enum": [
                                    "left",
                                    "center",
                                    "right",
                                    "justify"
                                  ]
                                },
                                "lineHeight": {
                                  "type": "string",
                                  "pattern": "^[0-9](\\.[0-9]+)?$",
                                  "description": "Line height as a multiplier written as text, for example 1.5."
                                }
                              },
                              "required": [
                                "type",
                                "runs",
                                "level"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "image"
                                  ]
                                },
                                "dataUri": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 15000000,
                                  "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                                },
                                "caption": {
                                  "description": "Shown under the picture (PDF, EPUB and DOCX).",
                                  "type": "string",
                                  "maxLength": 500
                                },
                                "alt": {
                                  "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                                  "type": "string",
                                  "maxLength": 500
                                },
                                "widthFrac": {
                                  "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                                  "type": "number",
                                  "minimum": 0.1,
                                  "maximum": 1
                                }
                              },
                              "required": [
                                "type",
                                "dataUri"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "list"
                                  ]
                                },
                                "ordered": {
                                  "type": "boolean",
                                  "description": "true for a numbered list, false for bullets."
                                },
                                "items": {
                                  "minItems": 1,
                                  "maxItems": 300,
                                  "type": "array",
                                  "items": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "text": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The words of this run. Control characters that XML cannot hold are removed."
                                        },
                                        "bold": {
                                          "type": "boolean"
                                        },
                                        "italic": {
                                          "type": "boolean"
                                        },
                                        "underline": {
                                          "type": "boolean"
                                        },
                                        "color": {
                                          "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                          "type": "string",
                                          "pattern": "^#[0-9a-fA-F]{3,8}$"
                                        },
                                        "superscript": {
                                          "type": "boolean"
                                        },
                                        "subscript": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "text"
                                      ],
                                      "additionalProperties": false,
                                      "description": "A piece of text with one style. A paragraph is a list of runs."
                                    }
                                  }
                                }
                              },
                              "required": [
                                "type",
                                "ordered",
                                "items"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "table"
                                  ]
                                },
                                "rows": {
                                  "minItems": 1,
                                  "maxItems": 200,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "cells": {
                                        "minItems": 1,
                                        "maxItems": 30,
                                        "type": "array",
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "text": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The words of this run. Control characters that XML cannot hold are removed."
                                              },
                                              "bold": {
                                                "type": "boolean"
                                              },
                                              "italic": {
                                                "type": "boolean"
                                              },
                                              "underline": {
                                                "type": "boolean"
                                              },
                                              "color": {
                                                "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                                "type": "string",
                                                "pattern": "^#[0-9a-fA-F]{3,8}$"
                                              },
                                              "superscript": {
                                                "type": "boolean"
                                              },
                                              "subscript": {
                                                "type": "boolean"
                                              }
                                            },
                                            "required": [
                                              "text"
                                            ],
                                            "additionalProperties": false,
                                            "description": "A piece of text with one style. A paragraph is a list of runs."
                                          }
                                        },
                                        "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                      },
                                      "header": {
                                        "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                        "type": "boolean"
                                      }
                                    },
                                    "required": [
                                      "cells"
                                    ],
                                    "additionalProperties": false
                                  }
                                }
                              },
                              "required": [
                                "type",
                                "rows"
                              ],
                              "additionalProperties": false,
                              "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "sceneBreak"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ],
                              "additionalProperties": false,
                              "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                            }
                          ]
                        }
                      },
                      "barcodeDataUri": {
                        "description": "A barcode image you made yourself (for example with /v1/security/barcode-code128 or an EAN-13 image); it is placed, not generated.",
                        "type": "string",
                        "maxLength": 5000000
                      },
                      "qrCodeDataUri": {
                        "description": "A QR code image you made yourself; it is placed, not generated.",
                        "type": "string",
                        "maxLength": 5000000
                      },
                      "publisherLogoDataUri": {
                        "type": "string",
                        "maxLength": 15000000
                      },
                      "publisherName": {
                        "type": "string",
                        "maxLength": 300
                      }
                    },
                    "additionalProperties": false
                  },
                  "titlePageImageDataUri": {
                    "type": "string",
                    "maxLength": 15000000
                  },
                  "titlePageContent": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "copyrightPageImageDataUri": {
                    "type": "string",
                    "maxLength": 15000000
                  },
                  "copyrightPageContent": {
                    "description": "Extra copyright-page text, after the standard notice.",
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "authors": {
                    "maxItems": 50,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        "role": {
                          "type": "string",
                          "enum": [
                            "main",
                            "contributing",
                            "illustrator",
                            "editor"
                          ],
                          "description": "main authors are named in the default copyright holder and on the title page."
                        },
                        "bio": {
                          "description": "Shown on the About the Author page.",
                          "minItems": 1,
                          "maxItems": 800,
                          "type": "array",
                          "items": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "paragraph"
                                    ]
                                  },
                                  "runs": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "text": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The words of this run. Control characters that XML cannot hold are removed."
                                        },
                                        "bold": {
                                          "type": "boolean"
                                        },
                                        "italic": {
                                          "type": "boolean"
                                        },
                                        "underline": {
                                          "type": "boolean"
                                        },
                                        "color": {
                                          "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                          "type": "string",
                                          "pattern": "^#[0-9a-fA-F]{3,8}$"
                                        },
                                        "superscript": {
                                          "type": "boolean"
                                        },
                                        "subscript": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "text"
                                      ],
                                      "additionalProperties": false,
                                      "description": "A piece of text with one style. A paragraph is a list of runs."
                                    }
                                  },
                                  "align": {
                                    "type": "string",
                                    "enum": [
                                      "left",
                                      "center",
                                      "right",
                                      "justify"
                                    ]
                                  },
                                  "lineHeight": {
                                    "type": "string",
                                    "pattern": "^[0-9](\\.[0-9]+)?$",
                                    "description": "Line height as a multiplier written as text, for example 1.5."
                                  }
                                },
                                "required": [
                                  "type",
                                  "runs"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "heading"
                                    ]
                                  },
                                  "runs": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "text": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The words of this run. Control characters that XML cannot hold are removed."
                                        },
                                        "bold": {
                                          "type": "boolean"
                                        },
                                        "italic": {
                                          "type": "boolean"
                                        },
                                        "underline": {
                                          "type": "boolean"
                                        },
                                        "color": {
                                          "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                          "type": "string",
                                          "pattern": "^#[0-9a-fA-F]{3,8}$"
                                        },
                                        "superscript": {
                                          "type": "boolean"
                                        },
                                        "subscript": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "text"
                                      ],
                                      "additionalProperties": false,
                                      "description": "A piece of text with one style. A paragraph is a list of runs."
                                    }
                                  },
                                  "level": {
                                    "anyOf": [
                                      {
                                        "type": "number",
                                        "enum": [
                                          1
                                        ]
                                      },
                                      {
                                        "type": "number",
                                        "enum": [
                                          2
                                        ]
                                      },
                                      {
                                        "type": "number",
                                        "enum": [
                                          3
                                        ]
                                      },
                                      {
                                        "type": "number",
                                        "enum": [
                                          4
                                        ]
                                      }
                                    ],
                                    "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                                  },
                                  "align": {
                                    "type": "string",
                                    "enum": [
                                      "left",
                                      "center",
                                      "right",
                                      "justify"
                                    ]
                                  },
                                  "lineHeight": {
                                    "type": "string",
                                    "pattern": "^[0-9](\\.[0-9]+)?$",
                                    "description": "Line height as a multiplier written as text, for example 1.5."
                                  }
                                },
                                "required": [
                                  "type",
                                  "runs",
                                  "level"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "image"
                                    ]
                                  },
                                  "dataUri": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 15000000,
                                    "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                                  },
                                  "caption": {
                                    "description": "Shown under the picture (PDF, EPUB and DOCX).",
                                    "type": "string",
                                    "maxLength": 500
                                  },
                                  "alt": {
                                    "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                                    "type": "string",
                                    "maxLength": 500
                                  },
                                  "widthFrac": {
                                    "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                                    "type": "number",
                                    "minimum": 0.1,
                                    "maximum": 1
                                  }
                                },
                                "required": [
                                  "type",
                                  "dataUri"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "list"
                                    ]
                                  },
                                  "ordered": {
                                    "type": "boolean",
                                    "description": "true for a numbered list, false for bullets."
                                  },
                                  "items": {
                                    "minItems": 1,
                                    "maxItems": 300,
                                    "type": "array",
                                    "items": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    }
                                  }
                                },
                                "required": [
                                  "type",
                                  "ordered",
                                  "items"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "table"
                                    ]
                                  },
                                  "rows": {
                                    "minItems": 1,
                                    "maxItems": 200,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "cells": {
                                          "minItems": 1,
                                          "maxItems": 30,
                                          "type": "array",
                                          "items": {
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "text": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The words of this run. Control characters that XML cannot hold are removed."
                                                },
                                                "bold": {
                                                  "type": "boolean"
                                                },
                                                "italic": {
                                                  "type": "boolean"
                                                },
                                                "underline": {
                                                  "type": "boolean"
                                                },
                                                "color": {
                                                  "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                                  "type": "string",
                                                  "pattern": "^#[0-9a-fA-F]{3,8}$"
                                                },
                                                "superscript": {
                                                  "type": "boolean"
                                                },
                                                "subscript": {
                                                  "type": "boolean"
                                                }
                                              },
                                              "required": [
                                                "text"
                                              ],
                                              "additionalProperties": false,
                                              "description": "A piece of text with one style. A paragraph is a list of runs."
                                            }
                                          },
                                          "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                        },
                                        "header": {
                                          "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "cells"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "type",
                                  "rows"
                                ],
                                "additionalProperties": false,
                                "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "sceneBreak"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ],
                                "additionalProperties": false,
                                "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                              }
                            ]
                          }
                        },
                        "photoDataUri": {
                          "description": "Author photo as an image data URI.",
                          "type": "string",
                          "maxLength": 15000000
                        }
                      },
                      "required": [
                        "name",
                        "role"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "trimWidthIn": {
                    "type": "number",
                    "minimum": 3,
                    "maximum": 14,
                    "description": "Page width in inches (3 to 14), for example 5.5 for a 5.5 x 8.5 in book."
                  },
                  "trimHeightIn": {
                    "type": "number",
                    "minimum": 3,
                    "maximum": 14,
                    "description": "Page height in inches (3 to 14)."
                  },
                  "gutterModel": {
                    "description": "Margin model. kdp-scaled (default): Amazon KDP inside margins that grow with page count. flat-0.5: 0.5 in all round (IngramSpark, Lulu). flat-0.75-inside: 0.75 in inside margin (B&N Press).",
                    "type": "string",
                    "enum": [
                      "kdp-scaled",
                      "flat-0.5",
                      "flat-0.75-inside"
                    ]
                  },
                  "chapters": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "title": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 300,
                          "description": "The chapter title, printed as the chapter heading and used in the table of contents."
                        },
                        "blocks": {
                          "minItems": 1,
                          "maxItems": 800,
                          "type": "array",
                          "items": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "paragraph"
                                    ]
                                  },
                                  "runs": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "text": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The words of this run. Control characters that XML cannot hold are removed."
                                        },
                                        "bold": {
                                          "type": "boolean"
                                        },
                                        "italic": {
                                          "type": "boolean"
                                        },
                                        "underline": {
                                          "type": "boolean"
                                        },
                                        "color": {
                                          "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                          "type": "string",
                                          "pattern": "^#[0-9a-fA-F]{3,8}$"
                                        },
                                        "superscript": {
                                          "type": "boolean"
                                        },
                                        "subscript": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "text"
                                      ],
                                      "additionalProperties": false,
                                      "description": "A piece of text with one style. A paragraph is a list of runs."
                                    }
                                  },
                                  "align": {
                                    "type": "string",
                                    "enum": [
                                      "left",
                                      "center",
                                      "right",
                                      "justify"
                                    ]
                                  },
                                  "lineHeight": {
                                    "type": "string",
                                    "pattern": "^[0-9](\\.[0-9]+)?$",
                                    "description": "Line height as a multiplier written as text, for example 1.5."
                                  }
                                },
                                "required": [
                                  "type",
                                  "runs"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "heading"
                                    ]
                                  },
                                  "runs": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "text": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The words of this run. Control characters that XML cannot hold are removed."
                                        },
                                        "bold": {
                                          "type": "boolean"
                                        },
                                        "italic": {
                                          "type": "boolean"
                                        },
                                        "underline": {
                                          "type": "boolean"
                                        },
                                        "color": {
                                          "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                          "type": "string",
                                          "pattern": "^#[0-9a-fA-F]{3,8}$"
                                        },
                                        "superscript": {
                                          "type": "boolean"
                                        },
                                        "subscript": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "text"
                                      ],
                                      "additionalProperties": false,
                                      "description": "A piece of text with one style. A paragraph is a list of runs."
                                    }
                                  },
                                  "level": {
                                    "anyOf": [
                                      {
                                        "type": "number",
                                        "enum": [
                                          1
                                        ]
                                      },
                                      {
                                        "type": "number",
                                        "enum": [
                                          2
                                        ]
                                      },
                                      {
                                        "type": "number",
                                        "enum": [
                                          3
                                        ]
                                      },
                                      {
                                        "type": "number",
                                        "enum": [
                                          4
                                        ]
                                      }
                                    ],
                                    "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                                  },
                                  "align": {
                                    "type": "string",
                                    "enum": [
                                      "left",
                                      "center",
                                      "right",
                                      "justify"
                                    ]
                                  },
                                  "lineHeight": {
                                    "type": "string",
                                    "pattern": "^[0-9](\\.[0-9]+)?$",
                                    "description": "Line height as a multiplier written as text, for example 1.5."
                                  }
                                },
                                "required": [
                                  "type",
                                  "runs",
                                  "level"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "image"
                                    ]
                                  },
                                  "dataUri": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 15000000,
                                    "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                                  },
                                  "caption": {
                                    "description": "Shown under the picture (PDF, EPUB and DOCX).",
                                    "type": "string",
                                    "maxLength": 500
                                  },
                                  "alt": {
                                    "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                                    "type": "string",
                                    "maxLength": 500
                                  },
                                  "widthFrac": {
                                    "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                                    "type": "number",
                                    "minimum": 0.1,
                                    "maximum": 1
                                  }
                                },
                                "required": [
                                  "type",
                                  "dataUri"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "list"
                                    ]
                                  },
                                  "ordered": {
                                    "type": "boolean",
                                    "description": "true for a numbered list, false for bullets."
                                  },
                                  "items": {
                                    "minItems": 1,
                                    "maxItems": 300,
                                    "type": "array",
                                    "items": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    }
                                  }
                                },
                                "required": [
                                  "type",
                                  "ordered",
                                  "items"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "table"
                                    ]
                                  },
                                  "rows": {
                                    "minItems": 1,
                                    "maxItems": 200,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "cells": {
                                          "minItems": 1,
                                          "maxItems": 30,
                                          "type": "array",
                                          "items": {
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "text": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The words of this run. Control characters that XML cannot hold are removed."
                                                },
                                                "bold": {
                                                  "type": "boolean"
                                                },
                                                "italic": {
                                                  "type": "boolean"
                                                },
                                                "underline": {
                                                  "type": "boolean"
                                                },
                                                "color": {
                                                  "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                                  "type": "string",
                                                  "pattern": "^#[0-9a-fA-F]{3,8}$"
                                                },
                                                "superscript": {
                                                  "type": "boolean"
                                                },
                                                "subscript": {
                                                  "type": "boolean"
                                                }
                                              },
                                              "required": [
                                                "text"
                                              ],
                                              "additionalProperties": false,
                                              "description": "A piece of text with one style. A paragraph is a list of runs."
                                            }
                                          },
                                          "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                        },
                                        "header": {
                                          "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "cells"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "type",
                                  "rows"
                                ],
                                "additionalProperties": false,
                                "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "sceneBreak"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ],
                                "additionalProperties": false,
                                "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                              }
                            ]
                          },
                          "description": "The chapter content in reading order, up to 800 blocks."
                        },
                        "partTitle": {
                          "description": "Groups this chapter and the following ones with the same partTitle under a Part divider page, such as Part One.",
                          "type": "string",
                          "maxLength": 300
                        }
                      },
                      "required": [
                        "title",
                        "blocks"
                      ],
                      "additionalProperties": false
                    },
                    "description": "The chapters, in order, up to 100."
                  },
                  "watermark": {
                    "description": "Opt-in preview watermark. Default false: the file is clean, with no promotional text. true adds a visible PREVIEW marking: in the PDF a light diagonal PREVIEW tiled across every page, in the EPUB and DOCX a banner line reading PREVIEW COPY on the cover and every chapter (EPUB) or in the page header (DOCX). The X-Watermark response header says whether it was applied.",
                    "type": "boolean"
                  },
                  "dedication": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "dedicationImageDataUri": {
                    "type": "string",
                    "maxLength": 15000000
                  },
                  "dedicationShowLabel": {
                    "type": "boolean"
                  },
                  "epigraph": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "epigraphImageDataUri": {
                    "type": "string",
                    "maxLength": 15000000
                  },
                  "epigraphShowLabel": {
                    "type": "boolean"
                  },
                  "foreword": {
                    "type": "object",
                    "properties": {
                      "authorName": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 300,
                        "description": "Who wrote the foreword; printed under it."
                      },
                      "blocks": {
                        "minItems": 1,
                        "maxItems": 800,
                        "type": "array",
                        "items": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "paragraph"
                                  ]
                                },
                                "runs": {
                                  "minItems": 1,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "text": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The words of this run. Control characters that XML cannot hold are removed."
                                      },
                                      "bold": {
                                        "type": "boolean"
                                      },
                                      "italic": {
                                        "type": "boolean"
                                      },
                                      "underline": {
                                        "type": "boolean"
                                      },
                                      "color": {
                                        "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                        "type": "string",
                                        "pattern": "^#[0-9a-fA-F]{3,8}$"
                                      },
                                      "superscript": {
                                        "type": "boolean"
                                      },
                                      "subscript": {
                                        "type": "boolean"
                                      }
                                    },
                                    "required": [
                                      "text"
                                    ],
                                    "additionalProperties": false,
                                    "description": "A piece of text with one style. A paragraph is a list of runs."
                                  }
                                },
                                "align": {
                                  "type": "string",
                                  "enum": [
                                    "left",
                                    "center",
                                    "right",
                                    "justify"
                                  ]
                                },
                                "lineHeight": {
                                  "type": "string",
                                  "pattern": "^[0-9](\\.[0-9]+)?$",
                                  "description": "Line height as a multiplier written as text, for example 1.5."
                                }
                              },
                              "required": [
                                "type",
                                "runs"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "heading"
                                  ]
                                },
                                "runs": {
                                  "minItems": 1,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "text": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The words of this run. Control characters that XML cannot hold are removed."
                                      },
                                      "bold": {
                                        "type": "boolean"
                                      },
                                      "italic": {
                                        "type": "boolean"
                                      },
                                      "underline": {
                                        "type": "boolean"
                                      },
                                      "color": {
                                        "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                        "type": "string",
                                        "pattern": "^#[0-9a-fA-F]{3,8}$"
                                      },
                                      "superscript": {
                                        "type": "boolean"
                                      },
                                      "subscript": {
                                        "type": "boolean"
                                      }
                                    },
                                    "required": [
                                      "text"
                                    ],
                                    "additionalProperties": false,
                                    "description": "A piece of text with one style. A paragraph is a list of runs."
                                  }
                                },
                                "level": {
                                  "anyOf": [
                                    {
                                      "type": "number",
                                      "enum": [
                                        1
                                      ]
                                    },
                                    {
                                      "type": "number",
                                      "enum": [
                                        2
                                      ]
                                    },
                                    {
                                      "type": "number",
                                      "enum": [
                                        3
                                      ]
                                    },
                                    {
                                      "type": "number",
                                      "enum": [
                                        4
                                      ]
                                    }
                                  ],
                                  "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                                },
                                "align": {
                                  "type": "string",
                                  "enum": [
                                    "left",
                                    "center",
                                    "right",
                                    "justify"
                                  ]
                                },
                                "lineHeight": {
                                  "type": "string",
                                  "pattern": "^[0-9](\\.[0-9]+)?$",
                                  "description": "Line height as a multiplier written as text, for example 1.5."
                                }
                              },
                              "required": [
                                "type",
                                "runs",
                                "level"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "image"
                                  ]
                                },
                                "dataUri": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 15000000,
                                  "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                                },
                                "caption": {
                                  "description": "Shown under the picture (PDF, EPUB and DOCX).",
                                  "type": "string",
                                  "maxLength": 500
                                },
                                "alt": {
                                  "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                                  "type": "string",
                                  "maxLength": 500
                                },
                                "widthFrac": {
                                  "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                                  "type": "number",
                                  "minimum": 0.1,
                                  "maximum": 1
                                }
                              },
                              "required": [
                                "type",
                                "dataUri"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "list"
                                  ]
                                },
                                "ordered": {
                                  "type": "boolean",
                                  "description": "true for a numbered list, false for bullets."
                                },
                                "items": {
                                  "minItems": 1,
                                  "maxItems": 300,
                                  "type": "array",
                                  "items": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "text": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The words of this run. Control characters that XML cannot hold are removed."
                                        },
                                        "bold": {
                                          "type": "boolean"
                                        },
                                        "italic": {
                                          "type": "boolean"
                                        },
                                        "underline": {
                                          "type": "boolean"
                                        },
                                        "color": {
                                          "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                          "type": "string",
                                          "pattern": "^#[0-9a-fA-F]{3,8}$"
                                        },
                                        "superscript": {
                                          "type": "boolean"
                                        },
                                        "subscript": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "text"
                                      ],
                                      "additionalProperties": false,
                                      "description": "A piece of text with one style. A paragraph is a list of runs."
                                    }
                                  }
                                }
                              },
                              "required": [
                                "type",
                                "ordered",
                                "items"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "table"
                                  ]
                                },
                                "rows": {
                                  "minItems": 1,
                                  "maxItems": 200,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "cells": {
                                        "minItems": 1,
                                        "maxItems": 30,
                                        "type": "array",
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "text": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The words of this run. Control characters that XML cannot hold are removed."
                                              },
                                              "bold": {
                                                "type": "boolean"
                                              },
                                              "italic": {
                                                "type": "boolean"
                                              },
                                              "underline": {
                                                "type": "boolean"
                                              },
                                              "color": {
                                                "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                                "type": "string",
                                                "pattern": "^#[0-9a-fA-F]{3,8}$"
                                              },
                                              "superscript": {
                                                "type": "boolean"
                                              },
                                              "subscript": {
                                                "type": "boolean"
                                              }
                                            },
                                            "required": [
                                              "text"
                                            ],
                                            "additionalProperties": false,
                                            "description": "A piece of text with one style. A paragraph is a list of runs."
                                          }
                                        },
                                        "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                      },
                                      "header": {
                                        "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                        "type": "boolean"
                                      }
                                    },
                                    "required": [
                                      "cells"
                                    ],
                                    "additionalProperties": false
                                  }
                                }
                              },
                              "required": [
                                "type",
                                "rows"
                              ],
                              "additionalProperties": false,
                              "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "sceneBreak"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ],
                              "additionalProperties": false,
                              "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                            }
                          ]
                        }
                      }
                    },
                    "required": [
                      "authorName",
                      "blocks"
                    ],
                    "additionalProperties": false
                  },
                  "praise": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "authorsNote": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "preface": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "howToUseThisBook": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "publisher": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 300
                      },
                      "logoDataUri": {
                        "type": "string",
                        "maxLength": 15000000
                      },
                      "intro": {
                        "minItems": 1,
                        "maxItems": 800,
                        "type": "array",
                        "items": {
                          "oneOf": [
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "paragraph"
                                  ]
                                },
                                "runs": {
                                  "minItems": 1,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "text": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The words of this run. Control characters that XML cannot hold are removed."
                                      },
                                      "bold": {
                                        "type": "boolean"
                                      },
                                      "italic": {
                                        "type": "boolean"
                                      },
                                      "underline": {
                                        "type": "boolean"
                                      },
                                      "color": {
                                        "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                        "type": "string",
                                        "pattern": "^#[0-9a-fA-F]{3,8}$"
                                      },
                                      "superscript": {
                                        "type": "boolean"
                                      },
                                      "subscript": {
                                        "type": "boolean"
                                      }
                                    },
                                    "required": [
                                      "text"
                                    ],
                                    "additionalProperties": false,
                                    "description": "A piece of text with one style. A paragraph is a list of runs."
                                  }
                                },
                                "align": {
                                  "type": "string",
                                  "enum": [
                                    "left",
                                    "center",
                                    "right",
                                    "justify"
                                  ]
                                },
                                "lineHeight": {
                                  "type": "string",
                                  "pattern": "^[0-9](\\.[0-9]+)?$",
                                  "description": "Line height as a multiplier written as text, for example 1.5."
                                }
                              },
                              "required": [
                                "type",
                                "runs"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "heading"
                                  ]
                                },
                                "runs": {
                                  "minItems": 1,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "text": {
                                        "type": "string",
                                        "minLength": 1,
                                        "description": "The words of this run. Control characters that XML cannot hold are removed."
                                      },
                                      "bold": {
                                        "type": "boolean"
                                      },
                                      "italic": {
                                        "type": "boolean"
                                      },
                                      "underline": {
                                        "type": "boolean"
                                      },
                                      "color": {
                                        "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                        "type": "string",
                                        "pattern": "^#[0-9a-fA-F]{3,8}$"
                                      },
                                      "superscript": {
                                        "type": "boolean"
                                      },
                                      "subscript": {
                                        "type": "boolean"
                                      }
                                    },
                                    "required": [
                                      "text"
                                    ],
                                    "additionalProperties": false,
                                    "description": "A piece of text with one style. A paragraph is a list of runs."
                                  }
                                },
                                "level": {
                                  "anyOf": [
                                    {
                                      "type": "number",
                                      "enum": [
                                        1
                                      ]
                                    },
                                    {
                                      "type": "number",
                                      "enum": [
                                        2
                                      ]
                                    },
                                    {
                                      "type": "number",
                                      "enum": [
                                        3
                                      ]
                                    },
                                    {
                                      "type": "number",
                                      "enum": [
                                        4
                                      ]
                                    }
                                  ],
                                  "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                                },
                                "align": {
                                  "type": "string",
                                  "enum": [
                                    "left",
                                    "center",
                                    "right",
                                    "justify"
                                  ]
                                },
                                "lineHeight": {
                                  "type": "string",
                                  "pattern": "^[0-9](\\.[0-9]+)?$",
                                  "description": "Line height as a multiplier written as text, for example 1.5."
                                }
                              },
                              "required": [
                                "type",
                                "runs",
                                "level"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "image"
                                  ]
                                },
                                "dataUri": {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 15000000,
                                  "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                                },
                                "caption": {
                                  "description": "Shown under the picture (PDF, EPUB and DOCX).",
                                  "type": "string",
                                  "maxLength": 500
                                },
                                "alt": {
                                  "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                                  "type": "string",
                                  "maxLength": 500
                                },
                                "widthFrac": {
                                  "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                                  "type": "number",
                                  "minimum": 0.1,
                                  "maximum": 1
                                }
                              },
                              "required": [
                                "type",
                                "dataUri"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "list"
                                  ]
                                },
                                "ordered": {
                                  "type": "boolean",
                                  "description": "true for a numbered list, false for bullets."
                                },
                                "items": {
                                  "minItems": 1,
                                  "maxItems": 300,
                                  "type": "array",
                                  "items": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "text": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The words of this run. Control characters that XML cannot hold are removed."
                                        },
                                        "bold": {
                                          "type": "boolean"
                                        },
                                        "italic": {
                                          "type": "boolean"
                                        },
                                        "underline": {
                                          "type": "boolean"
                                        },
                                        "color": {
                                          "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                          "type": "string",
                                          "pattern": "^#[0-9a-fA-F]{3,8}$"
                                        },
                                        "superscript": {
                                          "type": "boolean"
                                        },
                                        "subscript": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "text"
                                      ],
                                      "additionalProperties": false,
                                      "description": "A piece of text with one style. A paragraph is a list of runs."
                                    }
                                  }
                                }
                              },
                              "required": [
                                "type",
                                "ordered",
                                "items"
                              ],
                              "additionalProperties": false
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "table"
                                  ]
                                },
                                "rows": {
                                  "minItems": 1,
                                  "maxItems": 200,
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "cells": {
                                        "minItems": 1,
                                        "maxItems": 30,
                                        "type": "array",
                                        "items": {
                                          "type": "array",
                                          "items": {
                                            "type": "object",
                                            "properties": {
                                              "text": {
                                                "type": "string",
                                                "minLength": 1,
                                                "description": "The words of this run. Control characters that XML cannot hold are removed."
                                              },
                                              "bold": {
                                                "type": "boolean"
                                              },
                                              "italic": {
                                                "type": "boolean"
                                              },
                                              "underline": {
                                                "type": "boolean"
                                              },
                                              "color": {
                                                "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                                "type": "string",
                                                "pattern": "^#[0-9a-fA-F]{3,8}$"
                                              },
                                              "superscript": {
                                                "type": "boolean"
                                              },
                                              "subscript": {
                                                "type": "boolean"
                                              }
                                            },
                                            "required": [
                                              "text"
                                            ],
                                            "additionalProperties": false,
                                            "description": "A piece of text with one style. A paragraph is a list of runs."
                                          }
                                        },
                                        "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                      },
                                      "header": {
                                        "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                        "type": "boolean"
                                      }
                                    },
                                    "required": [
                                      "cells"
                                    ],
                                    "additionalProperties": false
                                  }
                                }
                              },
                              "required": [
                                "type",
                                "rows"
                              ],
                              "additionalProperties": false,
                              "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                            },
                            {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "type": "string",
                                  "enum": [
                                    "sceneBreak"
                                  ]
                                }
                              },
                              "required": [
                                "type"
                              ],
                              "additionalProperties": false,
                              "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                            }
                          ]
                        }
                      }
                    },
                    "required": [
                      "name"
                    ],
                    "additionalProperties": false
                  },
                  "peerReviewNote": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "copyrightHolder": {
                    "description": "Name printed after the copyright symbol. Default: the names of the authors with role main; if there are none, the line shows only the year (the book title is never used).",
                    "type": "string",
                    "maxLength": 300
                  },
                  "copyrightYear": {
                    "description": "Default: the current year. Must not be later than next year (a later year is a 400).",
                    "type": "integer",
                    "minimum": 1000,
                    "maximum": 9999
                  },
                  "includeToc": {
                    "type": "boolean"
                  },
                  "includeListOfImages": {
                    "type": "boolean"
                  },
                  "listOfTables": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "listOfGraphs": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "acknowledgments": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "alsoByAuthor": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "appendix": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "bibliography": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "endnotes": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "glossary": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "answerKey": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "index": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "frontMatterOrder": {
                    "description": "Order of the front-matter sections. Default: praise, title-page, copyright-page, authors, dedication, epigraph, foreword, authors-note, preface, how-to-use, publisher, peer-review, toc, list-of-images, list-of-tables, list-of-graphs. A section that is omitted from this list is left out.",
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "praise",
                        "title-page",
                        "copyright-page",
                        "authors",
                        "dedication",
                        "epigraph",
                        "foreword",
                        "authors-note",
                        "preface",
                        "how-to-use",
                        "publisher",
                        "peer-review",
                        "toc",
                        "list-of-images",
                        "list-of-tables",
                        "list-of-graphs"
                      ]
                    }
                  },
                  "backMatterOrder": {
                    "description": "Order of the back-matter sections. Default: acknowledgments, also-by-author, appendix, bibliography, endnotes, glossary, answer-key, index.",
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "acknowledgments",
                        "also-by-author",
                        "appendix",
                        "bibliography",
                        "endnotes",
                        "glossary",
                        "answer-key",
                        "index"
                      ]
                    }
                  }
                },
                "required": [
                  "bookTitle",
                  "trimWidthIn",
                  "trimHeightIn",
                  "chapters"
                ],
                "additionalProperties": false
              },
              "example": {
                "bookTitle": "The Lantern Harbor",
                "trimWidthIn": 5.5,
                "trimHeightIn": 8.5,
                "chapters": [
                  {
                    "title": "Chapter One",
                    "blocks": [
                      {
                        "type": "paragraph",
                        "runs": [
                          {
                            "text": "The harbor woke slowly, one lantern at a time."
                          }
                        ]
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The PDF file Real example: 200, application/pdf, 57,138 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "Content-Disposition": {
                "schema": {
                  "type": "string"
                },
                "description": "attachment; filename=book.pdf"
              },
              "X-Watermark": {
                "schema": {
                  "type": "string"
                },
                "description": "true when the preview watermark was applied, otherwise false",
                "example": "true"
              }
            }
          },
          "400": {
            "description": "A field is missing, out of range or has the wrong type, or a field is unknown; the body names the problem"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "422": {
            "description": "The text uses a script the PDF fonts cannot draw, for example Chinese, Japanese or Korean (code unsupported_script; the body has error, scripts, field and supported, the list of supported scripts). Use the EPUB or DOCX endpoint for that text."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          },
          "500": {
            "description": "The renderer failed unexpectedly. The body has a generic message {error, code: render_failed}; internal details are never returned."
          },
          "503": {
            "description": "The PDF renderer is busy or out of capacity (code busy or renderer_unavailable). At most 3 PDFs are rendered at once and up to 40 more wait in a queue for up to 90 seconds; beyond that you get this response with a Retry-After header (seconds). Retry after that time.",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds to wait before retrying"
              }
            }
          }
        }
      }
    },
    "/v1/publishing/typeset-manuscript": {
      "post": {
        "summary": "Typeset a manuscript as a Shunn standard-format PDF",
        "operationId": "publishingTypesetManuscript",
        "description": "Renders the manuscript to a PDF in Standard Manuscript Format (12 pt Tinos, which is metric-compatible with Times New Roman, double spaced, 1 inch margins, title page, running head on every page). The response body is the PDF (application/pdf). The watermark is opt-in. By default (watermark absent or false) the file is clean and contains no promotional text. Send watermark: true to add a visible preview marking: in the PDF a light diagonal PREVIEW tiled over every page; in the EPUB a red banner reading PREVIEW COPY on the cover and at the top of every chapter; in the DOCX a PREVIEW COPY line in the page header. The X-Watermark response header says which was produced. The PDF fonts are embedded and cover Latin (all accented letters, including Polish, Czech, Turkish, Romanian and Vietnamese), Greek (including polytonic), Cyrillic, Hebrew, Arabic, Devanagari (Hindi, Marathi, Nepali), Bengali, Tamil, Telugu, Gujarati, Kannada, Malayalam and Thai; Hebrew and Arabic are set right to left. Chinese, Japanese, Korean, Punjabi, Sinhala, Lao, Khmer, Burmese, Georgian, Armenian and Ethiopic would print as missing characters, so such text is refused with 422 and code unsupported_script (the body names the scripts found, the field and the supported list) before anything is rendered. Use the EPUB or DOCX endpoint for such text. Symbols, emoji and punctuation are not checked. Rendering uses a headless browser: at most 3 PDFs are rendered at the same time and up to 40 wait in a queue (at most 90 seconds); when it is busy the answer is 503 with a Retry-After header. Error messages never contain internal output or file paths. All fields not listed in the schema are rejected with a 400. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "bookTitle": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 300,
                    "description": "Title, printed on the title page and in the running head (shortened, upper case). Spaces at both ends are removed first; a blank title is a 400."
                  },
                  "byline": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 300,
                    "description": "Written as it should appear after by, for example Maria Lopez."
                  },
                  "authorLegalName": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 300,
                    "description": "Your legal name: top-left of the title page and the DOCX author property. The running-head surname is worked out from it unless runningHeadName is given: a trailing suffix (Jr., Sr., II, III, IV, PhD, MD, Esq.) and a leading title (Dr., Prof.) are ignored, 'Surname, First' gives the part before the comma, and particles and multi-word surnames stay together. Examples: Martin Luther King Jr. gives King, Lopez, Maria gives Lopez, Ursula K. Le Guin gives Le Guin, Anna van der Berg gives van der Berg."
                  },
                  "runningHeadName": {
                    "description": "The name printed first in the running head (for example Le Guin / TITLE / 2). Overrides the surname worked out from authorLegalName; use it for any name the automatic rule gets wrong.",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "pageSize": {
                    "description": "Page size of the DOCX and the PDF: letter (8.5 x 11 in, the default) or a4 (210 x 297 mm).",
                    "type": "string",
                    "enum": [
                      "letter",
                      "a4"
                    ]
                  },
                  "authorAddress": {
                    "type": "string",
                    "maxLength": 500
                  },
                  "authorPhone": {
                    "type": "string",
                    "maxLength": 100
                  },
                  "authorEmail": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "chapters": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "title": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 300
                        },
                        "blocks": {
                          "minItems": 1,
                          "maxItems": 800,
                          "type": "array",
                          "items": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "paragraph"
                                    ]
                                  },
                                  "runs": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "text": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The words of this run. Control characters that XML cannot hold are removed."
                                        },
                                        "bold": {
                                          "type": "boolean"
                                        },
                                        "italic": {
                                          "type": "boolean"
                                        },
                                        "underline": {
                                          "type": "boolean"
                                        },
                                        "color": {
                                          "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                          "type": "string",
                                          "pattern": "^#[0-9a-fA-F]{3,8}$"
                                        },
                                        "superscript": {
                                          "type": "boolean"
                                        },
                                        "subscript": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "text"
                                      ],
                                      "additionalProperties": false,
                                      "description": "A piece of text with one style. A paragraph is a list of runs."
                                    }
                                  },
                                  "align": {
                                    "type": "string",
                                    "enum": [
                                      "left",
                                      "center",
                                      "right",
                                      "justify"
                                    ]
                                  },
                                  "lineHeight": {
                                    "type": "string",
                                    "pattern": "^[0-9](\\.[0-9]+)?$",
                                    "description": "Line height as a multiplier written as text, for example 1.5."
                                  }
                                },
                                "required": [
                                  "type",
                                  "runs"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "heading"
                                    ]
                                  },
                                  "runs": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "text": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The words of this run. Control characters that XML cannot hold are removed."
                                        },
                                        "bold": {
                                          "type": "boolean"
                                        },
                                        "italic": {
                                          "type": "boolean"
                                        },
                                        "underline": {
                                          "type": "boolean"
                                        },
                                        "color": {
                                          "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                          "type": "string",
                                          "pattern": "^#[0-9a-fA-F]{3,8}$"
                                        },
                                        "superscript": {
                                          "type": "boolean"
                                        },
                                        "subscript": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "text"
                                      ],
                                      "additionalProperties": false,
                                      "description": "A piece of text with one style. A paragraph is a list of runs."
                                    }
                                  },
                                  "level": {
                                    "anyOf": [
                                      {
                                        "type": "number",
                                        "enum": [
                                          1
                                        ]
                                      },
                                      {
                                        "type": "number",
                                        "enum": [
                                          2
                                        ]
                                      },
                                      {
                                        "type": "number",
                                        "enum": [
                                          3
                                        ]
                                      },
                                      {
                                        "type": "number",
                                        "enum": [
                                          4
                                        ]
                                      }
                                    ],
                                    "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                                  },
                                  "align": {
                                    "type": "string",
                                    "enum": [
                                      "left",
                                      "center",
                                      "right",
                                      "justify"
                                    ]
                                  },
                                  "lineHeight": {
                                    "type": "string",
                                    "pattern": "^[0-9](\\.[0-9]+)?$",
                                    "description": "Line height as a multiplier written as text, for example 1.5."
                                  }
                                },
                                "required": [
                                  "type",
                                  "runs",
                                  "level"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "image"
                                    ]
                                  },
                                  "dataUri": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 15000000,
                                    "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                                  },
                                  "caption": {
                                    "description": "Shown under the picture (PDF, EPUB and DOCX).",
                                    "type": "string",
                                    "maxLength": 500
                                  },
                                  "alt": {
                                    "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                                    "type": "string",
                                    "maxLength": 500
                                  },
                                  "widthFrac": {
                                    "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                                    "type": "number",
                                    "minimum": 0.1,
                                    "maximum": 1
                                  }
                                },
                                "required": [
                                  "type",
                                  "dataUri"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "list"
                                    ]
                                  },
                                  "ordered": {
                                    "type": "boolean",
                                    "description": "true for a numbered list, false for bullets."
                                  },
                                  "items": {
                                    "minItems": 1,
                                    "maxItems": 300,
                                    "type": "array",
                                    "items": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    }
                                  }
                                },
                                "required": [
                                  "type",
                                  "ordered",
                                  "items"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "table"
                                    ]
                                  },
                                  "rows": {
                                    "minItems": 1,
                                    "maxItems": 200,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "cells": {
                                          "minItems": 1,
                                          "maxItems": 30,
                                          "type": "array",
                                          "items": {
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "text": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The words of this run. Control characters that XML cannot hold are removed."
                                                },
                                                "bold": {
                                                  "type": "boolean"
                                                },
                                                "italic": {
                                                  "type": "boolean"
                                                },
                                                "underline": {
                                                  "type": "boolean"
                                                },
                                                "color": {
                                                  "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                                  "type": "string",
                                                  "pattern": "^#[0-9a-fA-F]{3,8}$"
                                                },
                                                "superscript": {
                                                  "type": "boolean"
                                                },
                                                "subscript": {
                                                  "type": "boolean"
                                                }
                                              },
                                              "required": [
                                                "text"
                                              ],
                                              "additionalProperties": false,
                                              "description": "A piece of text with one style. A paragraph is a list of runs."
                                            }
                                          },
                                          "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                        },
                                        "header": {
                                          "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "cells"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "type",
                                  "rows"
                                ],
                                "additionalProperties": false,
                                "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "sceneBreak"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ],
                                "additionalProperties": false,
                                "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                              }
                            ]
                          }
                        },
                        "partTitle": {
                          "type": "string",
                          "maxLength": 300
                        }
                      },
                      "required": [
                        "title",
                        "blocks"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "direction": {
                    "description": "Reading direction: auto (the default), ltr or rtl. With auto, a book whose text is mostly Arabic or Hebrew is laid out right to left and anything else left to right; ltr or rtl overrides that. Right to left means the first page is a left-hand page with the binding on its right, mirrored margins, text, lists, tables and the table of contents running from the right, correct mixing of English words and numbers inside Arabic or Hebrew lines, and a PDF marked right-to-left (page 1 on the right of the spine in two-page view). EPUB: every page is dir=rtl and the spine has page-progression-direction=rtl. DOCX: right-to-left paragraphs and sections, Arabic and Hebrew runs marked right-to-left.",
                    "type": "string",
                    "enum": [
                      "auto",
                      "ltr",
                      "rtl"
                    ]
                  },
                  "watermark": {
                    "description": "Opt-in preview watermark. Default false: the file is clean, with no promotional text. true adds a visible PREVIEW marking: in the PDF a light diagonal PREVIEW tiled across every page, in the EPUB and DOCX a banner line reading PREVIEW COPY on the cover and every chapter (EPUB) or in the page header (DOCX). The X-Watermark response header says whether it was applied.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "bookTitle",
                  "byline",
                  "authorLegalName",
                  "chapters"
                ],
                "additionalProperties": false
              },
              "example": {
                "bookTitle": "The Lantern Harbor",
                "byline": "Maria Lopez",
                "authorLegalName": "Maria Lopez",
                "chapters": [
                  {
                    "title": "Chapter One",
                    "blocks": [
                      {
                        "type": "paragraph",
                        "runs": [
                          {
                            "text": "The harbor woke slowly, one lantern at a time."
                          }
                        ]
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The PDF file Real example: 200, application/pdf, 32,612 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "Content-Disposition": {
                "schema": {
                  "type": "string"
                },
                "description": "attachment; filename=manuscript.pdf"
              },
              "X-Watermark": {
                "schema": {
                  "type": "string"
                },
                "description": "true when the preview watermark was applied, otherwise false",
                "example": "true"
              }
            }
          },
          "400": {
            "description": "A field is missing or has the wrong type, or a field is unknown; the body names the problem"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "422": {
            "description": "The text uses a script the PDF fonts cannot draw, for example Chinese, Japanese or Korean (code unsupported_script; the body has error, scripts, field and supported, the list of supported scripts). Use the EPUB or DOCX endpoint for that text."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          },
          "500": {
            "description": "The renderer failed unexpectedly. The body has a generic message {error, code: render_failed}; internal details are never returned."
          },
          "503": {
            "description": "The PDF renderer is busy or out of capacity (code busy or renderer_unavailable). At most 3 PDFs are rendered at once and up to 40 more wait in a queue for up to 90 seconds; beyond that you get this response with a Retry-After header (seconds). Retry after that time.",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds to wait before retrying"
              }
            }
          }
        }
      }
    },
    "/v1/publishing/manuscript-docx": {
      "post": {
        "summary": "Build a standard manuscript format (Shunn) Word file",
        "operationId": "publishingManuscriptDocx",
        "description": "Builds a Word .docx in Standard Manuscript Format: 12 pt Times New Roman, double spaced, 1 inch margins, a title page with your contact details and a rounded word count, a running head (Surname / TITLE / page) on every later page, chapter headings and Part pages. The response body is the .docx file (application/vnd.openxmlformats-officedocument.wordprocessingml.document). Tables are written as real Word tables (header rows in bold and repeated on each page), pictures are placed and scaled to fit the page width (jpeg, png and gif as they are, webp and svg converted to PNG) with alt text and the caption underneath in italics; a picture that is not a real image is a 400. The file's properties are set: title is bookTitle and the author is authorLegalName. The watermark is opt-in. By default (watermark absent or false) the file is clean and contains no promotional text. Send watermark: true to add a visible preview marking: in the PDF a light diagonal PREVIEW tiled over every page; in the EPUB a red banner reading PREVIEW COPY on the cover and at the top of every chapter; in the DOCX a PREVIEW COPY line in the page header. The X-Watermark response header says which was produced. Control characters that XML cannot hold are removed from every text field. All fields not listed in the schema are rejected with a 400. Colours and fonts of runs are ignored (a manuscript is plain black Times New Roman). Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "bookTitle": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 300,
                    "description": "Title, printed on the title page and in the running head (shortened, upper case). Spaces at both ends are removed first; a blank title is a 400."
                  },
                  "byline": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 300,
                    "description": "Written as it should appear after by, for example Maria Lopez."
                  },
                  "authorLegalName": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 300,
                    "description": "Your legal name: top-left of the title page and the DOCX author property. The running-head surname is worked out from it unless runningHeadName is given: a trailing suffix (Jr., Sr., II, III, IV, PhD, MD, Esq.) and a leading title (Dr., Prof.) are ignored, 'Surname, First' gives the part before the comma, and particles and multi-word surnames stay together. Examples: Martin Luther King Jr. gives King, Lopez, Maria gives Lopez, Ursula K. Le Guin gives Le Guin, Anna van der Berg gives van der Berg."
                  },
                  "runningHeadName": {
                    "description": "The name printed first in the running head (for example Le Guin / TITLE / 2). Overrides the surname worked out from authorLegalName; use it for any name the automatic rule gets wrong.",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "pageSize": {
                    "description": "Page size of the DOCX and the PDF: letter (8.5 x 11 in, the default) or a4 (210 x 297 mm).",
                    "type": "string",
                    "enum": [
                      "letter",
                      "a4"
                    ]
                  },
                  "authorAddress": {
                    "type": "string",
                    "maxLength": 500
                  },
                  "authorPhone": {
                    "type": "string",
                    "maxLength": 100
                  },
                  "authorEmail": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "chapters": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "title": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 300
                        },
                        "blocks": {
                          "minItems": 1,
                          "maxItems": 800,
                          "type": "array",
                          "items": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "paragraph"
                                    ]
                                  },
                                  "runs": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "text": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The words of this run. Control characters that XML cannot hold are removed."
                                        },
                                        "bold": {
                                          "type": "boolean"
                                        },
                                        "italic": {
                                          "type": "boolean"
                                        },
                                        "underline": {
                                          "type": "boolean"
                                        },
                                        "color": {
                                          "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                          "type": "string",
                                          "pattern": "^#[0-9a-fA-F]{3,8}$"
                                        },
                                        "superscript": {
                                          "type": "boolean"
                                        },
                                        "subscript": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "text"
                                      ],
                                      "additionalProperties": false,
                                      "description": "A piece of text with one style. A paragraph is a list of runs."
                                    }
                                  },
                                  "align": {
                                    "type": "string",
                                    "enum": [
                                      "left",
                                      "center",
                                      "right",
                                      "justify"
                                    ]
                                  },
                                  "lineHeight": {
                                    "type": "string",
                                    "pattern": "^[0-9](\\.[0-9]+)?$",
                                    "description": "Line height as a multiplier written as text, for example 1.5."
                                  }
                                },
                                "required": [
                                  "type",
                                  "runs"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "heading"
                                    ]
                                  },
                                  "runs": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "text": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The words of this run. Control characters that XML cannot hold are removed."
                                        },
                                        "bold": {
                                          "type": "boolean"
                                        },
                                        "italic": {
                                          "type": "boolean"
                                        },
                                        "underline": {
                                          "type": "boolean"
                                        },
                                        "color": {
                                          "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                          "type": "string",
                                          "pattern": "^#[0-9a-fA-F]{3,8}$"
                                        },
                                        "superscript": {
                                          "type": "boolean"
                                        },
                                        "subscript": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "text"
                                      ],
                                      "additionalProperties": false,
                                      "description": "A piece of text with one style. A paragraph is a list of runs."
                                    }
                                  },
                                  "level": {
                                    "anyOf": [
                                      {
                                        "type": "number",
                                        "enum": [
                                          1
                                        ]
                                      },
                                      {
                                        "type": "number",
                                        "enum": [
                                          2
                                        ]
                                      },
                                      {
                                        "type": "number",
                                        "enum": [
                                          3
                                        ]
                                      },
                                      {
                                        "type": "number",
                                        "enum": [
                                          4
                                        ]
                                      }
                                    ],
                                    "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                                  },
                                  "align": {
                                    "type": "string",
                                    "enum": [
                                      "left",
                                      "center",
                                      "right",
                                      "justify"
                                    ]
                                  },
                                  "lineHeight": {
                                    "type": "string",
                                    "pattern": "^[0-9](\\.[0-9]+)?$",
                                    "description": "Line height as a multiplier written as text, for example 1.5."
                                  }
                                },
                                "required": [
                                  "type",
                                  "runs",
                                  "level"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "image"
                                    ]
                                  },
                                  "dataUri": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 15000000,
                                    "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                                  },
                                  "caption": {
                                    "description": "Shown under the picture (PDF, EPUB and DOCX).",
                                    "type": "string",
                                    "maxLength": 500
                                  },
                                  "alt": {
                                    "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                                    "type": "string",
                                    "maxLength": 500
                                  },
                                  "widthFrac": {
                                    "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                                    "type": "number",
                                    "minimum": 0.1,
                                    "maximum": 1
                                  }
                                },
                                "required": [
                                  "type",
                                  "dataUri"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "list"
                                    ]
                                  },
                                  "ordered": {
                                    "type": "boolean",
                                    "description": "true for a numbered list, false for bullets."
                                  },
                                  "items": {
                                    "minItems": 1,
                                    "maxItems": 300,
                                    "type": "array",
                                    "items": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    }
                                  }
                                },
                                "required": [
                                  "type",
                                  "ordered",
                                  "items"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "table"
                                    ]
                                  },
                                  "rows": {
                                    "minItems": 1,
                                    "maxItems": 200,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "cells": {
                                          "minItems": 1,
                                          "maxItems": 30,
                                          "type": "array",
                                          "items": {
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "text": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The words of this run. Control characters that XML cannot hold are removed."
                                                },
                                                "bold": {
                                                  "type": "boolean"
                                                },
                                                "italic": {
                                                  "type": "boolean"
                                                },
                                                "underline": {
                                                  "type": "boolean"
                                                },
                                                "color": {
                                                  "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                                  "type": "string",
                                                  "pattern": "^#[0-9a-fA-F]{3,8}$"
                                                },
                                                "superscript": {
                                                  "type": "boolean"
                                                },
                                                "subscript": {
                                                  "type": "boolean"
                                                }
                                              },
                                              "required": [
                                                "text"
                                              ],
                                              "additionalProperties": false,
                                              "description": "A piece of text with one style. A paragraph is a list of runs."
                                            }
                                          },
                                          "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                        },
                                        "header": {
                                          "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "cells"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "type",
                                  "rows"
                                ],
                                "additionalProperties": false,
                                "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "sceneBreak"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ],
                                "additionalProperties": false,
                                "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                              }
                            ]
                          }
                        },
                        "partTitle": {
                          "type": "string",
                          "maxLength": 300
                        }
                      },
                      "required": [
                        "title",
                        "blocks"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "direction": {
                    "description": "Reading direction: auto (the default), ltr or rtl. With auto, a book whose text is mostly Arabic or Hebrew is laid out right to left and anything else left to right; ltr or rtl overrides that. Right to left means the first page is a left-hand page with the binding on its right, mirrored margins, text, lists, tables and the table of contents running from the right, correct mixing of English words and numbers inside Arabic or Hebrew lines, and a PDF marked right-to-left (page 1 on the right of the spine in two-page view). EPUB: every page is dir=rtl and the spine has page-progression-direction=rtl. DOCX: right-to-left paragraphs and sections, Arabic and Hebrew runs marked right-to-left.",
                    "type": "string",
                    "enum": [
                      "auto",
                      "ltr",
                      "rtl"
                    ]
                  },
                  "watermark": {
                    "description": "Opt-in preview watermark. Default false: the file is clean, with no promotional text. true adds a visible PREVIEW marking: in the PDF a light diagonal PREVIEW tiled across every page, in the EPUB and DOCX a banner line reading PREVIEW COPY on the cover and every chapter (EPUB) or in the page header (DOCX). The X-Watermark response header says whether it was applied.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "bookTitle",
                  "byline",
                  "authorLegalName",
                  "chapters"
                ],
                "additionalProperties": false
              },
              "example": {
                "bookTitle": "The Lantern Harbor",
                "byline": "Maria Lopez",
                "authorLegalName": "Maria Lopez",
                "chapters": [
                  {
                    "title": "Chapter One",
                    "blocks": [
                      {
                        "type": "paragraph",
                        "runs": [
                          {
                            "text": "The harbor woke slowly, one lantern at a time."
                          }
                        ]
                      }
                    ]
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The Word file Real example: 200, application/vnd.openxmlformats-officedocument.wordprocessingml.document, 11,031 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.wordprocessingml.document": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "Content-Disposition": {
                "schema": {
                  "type": "string"
                },
                "description": "attachment; filename=manuscript.docx"
              },
              "X-Watermark": {
                "schema": {
                  "type": "string"
                },
                "description": "true when the preview watermark was applied, otherwise false",
                "example": "true"
              }
            }
          },
          "400": {
            "description": "A field is missing or has the wrong type, a picture is not a real image, or a field is unknown; the body names the problem"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          },
          "500": {
            "description": "The file could not be built. The body is {error, code} with a generic message."
          }
        }
      }
    },
    "/v1/publishing/epub": {
      "post": {
        "summary": "Build an EPUB 3 e-book from chapters",
        "operationId": "publishingEpub",
        "description": "Packs chapters (paragraphs, headings, lists, tables, pictures, scene breaks) into a reflowable EPUB 3 file with a cover page, title page, copyright page, optional dedication and epigraph, a contents page, a navigation document, Part divider pages, and accessibility metadata. The response body is the .epub file (application/epub+zip). The watermark is opt-in. By default (watermark absent or false) the file is clean and contains no promotional text. Send watermark: true to add a visible preview marking: in the PDF a light diagonal PREVIEW tiled over every page; in the EPUB a red banner reading PREVIEW COPY on the cover and at the top of every chapter; in the DOCX a PREVIEW COPY line in the page header. The X-Watermark response header says which was produced. Text fields: control characters that XML 1.0 cannot hold are removed. language must be a BCP 47 tag such as en, en-US or pt-BR (anything else is a 400). coverImageDataUri and every picture must be a base64 data URI of a real jpeg, png, gif, webp or svg image: the type is read from the bytes, a wrong label, HTML, a damaged image or an SVG with scripts is a 400, and web addresses are never fetched. The book identifier is urn:isbn: with eisbn (or isbn) when given, otherwise urn:uuid: with stableId when it is a UUID, a UUID derived from stableId when it is any other text, or a random UUID. The copyright line uses copyrightHolder, else the author names, else only the year (never the book title). Limits: up to 100 chapters, 800 blocks per chapter. All fields not listed in the schema are rejected with a 400. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "bookTitle": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 300,
                    "description": "The book title. Spaces at both ends are removed first; a blank title is a 400."
                  },
                  "subtitle": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "authorNames": {
                    "minItems": 1,
                    "maxItems": 50,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "description": "At least one name (an empty list is a 400). Each name becomes a creator in the EPUB metadata and is joined on the title page."
                  },
                  "language": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 35,
                    "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z]{4})?(?:-(?:[A-Za-z]{2}|[0-9]{3}))?(?:-(?:[A-Za-z0-9]{5,8}|[0-9][A-Za-z0-9]{3}))*$",
                    "description": "BCP 47 language tag such as en, en-US, fr, pt-BR or zh-Hant. A value that is not a language tag (for example notalang) is a 400."
                  },
                  "isbn": {
                    "description": "Printed on the copyright page and used as the book identifier (urn:isbn: followed by the digits only) unless eisbn is given. ISBN-10 or ISBN-13; hyphens and spaces are allowed. The length and the check digit are verified, and a value that is not a valid ISBN is a 400.",
                    "type": "string",
                    "maxLength": 50
                  },
                  "eisbn": {
                    "description": "Takes priority over isbn as the EPUB identifier. ISBN-10 or ISBN-13; hyphens and spaces are allowed. The length and the check digit are verified, and a value that is not a valid ISBN is a 400.",
                    "type": "string",
                    "maxLength": 50
                  },
                  "publisherName": {
                    "type": "string",
                    "maxLength": 300
                  },
                  "coverImageDataUri": {
                    "description": "Cover picture as a base64 data URI. Only image/jpeg, image/png, image/gif, image/webp and image/svg+xml are accepted, the bytes must decode as that type, and SVG must not contain scripts. Anything else (for example text/html) is a 400.",
                    "type": "string",
                    "maxLength": 15000000
                  },
                  "copyrightHolder": {
                    "description": "Name after the copyright symbol. Default: the author names; if there are none, only the year is shown (the title is never used).",
                    "type": "string",
                    "maxLength": 300
                  },
                  "copyrightYear": {
                    "description": "Default: the current year. Must not be later than next year (a later year is a 400).",
                    "type": "integer",
                    "minimum": 1500,
                    "maximum": 3000
                  },
                  "copyrightNotice": {
                    "description": "EPUB only. Your own wording for the copyright page, replacing the default two lines (the copyright symbol, year and holder followed by All rights reserved, and the sentence that no part may be reproduced without written permission). One paragraph per line; at most 2000 characters; a blank value is a 400. The ISBN and e-ISBN lines are still added. Default: the standard wording built from copyrightYear and copyrightHolder.",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2000
                  },
                  "dedicationBlocks": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "epigraphBlocks": {
                    "minItems": 1,
                    "maxItems": 800,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "paragraph"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "heading"
                              ]
                            },
                            "runs": {
                              "minItems": 1,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "The words of this run. Control characters that XML cannot hold are removed."
                                  },
                                  "bold": {
                                    "type": "boolean"
                                  },
                                  "italic": {
                                    "type": "boolean"
                                  },
                                  "underline": {
                                    "type": "boolean"
                                  },
                                  "color": {
                                    "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                    "type": "string",
                                    "pattern": "^#[0-9a-fA-F]{3,8}$"
                                  },
                                  "superscript": {
                                    "type": "boolean"
                                  },
                                  "subscript": {
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "text"
                                ],
                                "additionalProperties": false,
                                "description": "A piece of text with one style. A paragraph is a list of runs."
                              }
                            },
                            "level": {
                              "anyOf": [
                                {
                                  "type": "number",
                                  "enum": [
                                    1
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    2
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    3
                                  ]
                                },
                                {
                                  "type": "number",
                                  "enum": [
                                    4
                                  ]
                                }
                              ],
                              "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                            },
                            "align": {
                              "type": "string",
                              "enum": [
                                "left",
                                "center",
                                "right",
                                "justify"
                              ]
                            },
                            "lineHeight": {
                              "type": "string",
                              "pattern": "^[0-9](\\.[0-9]+)?$",
                              "description": "Line height as a multiplier written as text, for example 1.5."
                            }
                          },
                          "required": [
                            "type",
                            "runs",
                            "level"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "image"
                              ]
                            },
                            "dataUri": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 15000000,
                              "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                            },
                            "caption": {
                              "description": "Shown under the picture (PDF, EPUB and DOCX).",
                              "type": "string",
                              "maxLength": 500
                            },
                            "alt": {
                              "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                              "type": "string",
                              "maxLength": 500
                            },
                            "widthFrac": {
                              "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                              "type": "number",
                              "minimum": 0.1,
                              "maximum": 1
                            }
                          },
                          "required": [
                            "type",
                            "dataUri"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "list"
                              ]
                            },
                            "ordered": {
                              "type": "boolean",
                              "description": "true for a numbered list, false for bullets."
                            },
                            "items": {
                              "minItems": 1,
                              "maxItems": 300,
                              "type": "array",
                              "items": {
                                "minItems": 1,
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "text": {
                                      "type": "string",
                                      "minLength": 1,
                                      "description": "The words of this run. Control characters that XML cannot hold are removed."
                                    },
                                    "bold": {
                                      "type": "boolean"
                                    },
                                    "italic": {
                                      "type": "boolean"
                                    },
                                    "underline": {
                                      "type": "boolean"
                                    },
                                    "color": {
                                      "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                      "type": "string",
                                      "pattern": "^#[0-9a-fA-F]{3,8}$"
                                    },
                                    "superscript": {
                                      "type": "boolean"
                                    },
                                    "subscript": {
                                      "type": "boolean"
                                    }
                                  },
                                  "required": [
                                    "text"
                                  ],
                                  "additionalProperties": false,
                                  "description": "A piece of text with one style. A paragraph is a list of runs."
                                }
                              }
                            }
                          },
                          "required": [
                            "type",
                            "ordered",
                            "items"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "table"
                              ]
                            },
                            "rows": {
                              "minItems": 1,
                              "maxItems": 200,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "cells": {
                                    "minItems": 1,
                                    "maxItems": 30,
                                    "type": "array",
                                    "items": {
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    },
                                    "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                  },
                                  "header": {
                                    "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                    "type": "boolean"
                                  }
                                },
                                "required": [
                                  "cells"
                                ],
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "type",
                            "rows"
                          ],
                          "additionalProperties": false,
                          "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                        },
                        {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string",
                              "enum": [
                                "sceneBreak"
                              ]
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false,
                          "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                        }
                      ]
                    }
                  },
                  "chapters": {
                    "minItems": 1,
                    "maxItems": 100,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "title": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 300,
                          "description": "The chapter title, printed as the chapter heading and used in the table of contents."
                        },
                        "blocks": {
                          "minItems": 1,
                          "maxItems": 800,
                          "type": "array",
                          "items": {
                            "oneOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "paragraph"
                                    ]
                                  },
                                  "runs": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "text": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The words of this run. Control characters that XML cannot hold are removed."
                                        },
                                        "bold": {
                                          "type": "boolean"
                                        },
                                        "italic": {
                                          "type": "boolean"
                                        },
                                        "underline": {
                                          "type": "boolean"
                                        },
                                        "color": {
                                          "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                          "type": "string",
                                          "pattern": "^#[0-9a-fA-F]{3,8}$"
                                        },
                                        "superscript": {
                                          "type": "boolean"
                                        },
                                        "subscript": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "text"
                                      ],
                                      "additionalProperties": false,
                                      "description": "A piece of text with one style. A paragraph is a list of runs."
                                    }
                                  },
                                  "align": {
                                    "type": "string",
                                    "enum": [
                                      "left",
                                      "center",
                                      "right",
                                      "justify"
                                    ]
                                  },
                                  "lineHeight": {
                                    "type": "string",
                                    "pattern": "^[0-9](\\.[0-9]+)?$",
                                    "description": "Line height as a multiplier written as text, for example 1.5."
                                  }
                                },
                                "required": [
                                  "type",
                                  "runs"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "heading"
                                    ]
                                  },
                                  "runs": {
                                    "minItems": 1,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "text": {
                                          "type": "string",
                                          "minLength": 1,
                                          "description": "The words of this run. Control characters that XML cannot hold are removed."
                                        },
                                        "bold": {
                                          "type": "boolean"
                                        },
                                        "italic": {
                                          "type": "boolean"
                                        },
                                        "underline": {
                                          "type": "boolean"
                                        },
                                        "color": {
                                          "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                          "type": "string",
                                          "pattern": "^#[0-9a-fA-F]{3,8}$"
                                        },
                                        "superscript": {
                                          "type": "boolean"
                                        },
                                        "subscript": {
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "text"
                                      ],
                                      "additionalProperties": false,
                                      "description": "A piece of text with one style. A paragraph is a list of runs."
                                    }
                                  },
                                  "level": {
                                    "anyOf": [
                                      {
                                        "type": "number",
                                        "enum": [
                                          1
                                        ]
                                      },
                                      {
                                        "type": "number",
                                        "enum": [
                                          2
                                        ]
                                      },
                                      {
                                        "type": "number",
                                        "enum": [
                                          3
                                        ]
                                      },
                                      {
                                        "type": "number",
                                        "enum": [
                                          4
                                        ]
                                      }
                                    ],
                                    "description": "Heading level 1 (largest) to 4. Level 1 is shown as a sub-heading inside a chapter, because the chapter title is the page heading."
                                  },
                                  "align": {
                                    "type": "string",
                                    "enum": [
                                      "left",
                                      "center",
                                      "right",
                                      "justify"
                                    ]
                                  },
                                  "lineHeight": {
                                    "type": "string",
                                    "pattern": "^[0-9](\\.[0-9]+)?$",
                                    "description": "Line height as a multiplier written as text, for example 1.5."
                                  }
                                },
                                "required": [
                                  "type",
                                  "runs",
                                  "level"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "image"
                                    ]
                                  },
                                  "dataUri": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 15000000,
                                    "description": "The picture as a base64 data URI, for example data:image/png;base64,iVBOR... Allowed types: image/jpeg, image/png, image/gif, image/webp, image/svg+xml. The bytes are decoded and checked; a wrong label, HTML, or a damaged image is a 400. Web addresses are never fetched. Up to about 10 MB of image."
                                  },
                                  "caption": {
                                    "description": "Shown under the picture (PDF, EPUB and DOCX).",
                                    "type": "string",
                                    "maxLength": 500
                                  },
                                  "alt": {
                                    "description": "Alternative text for screen readers (EPUB and DOCX). Without it the EPUB accessibility summary says some images lack a text alternative.",
                                    "type": "string",
                                    "maxLength": 500
                                  },
                                  "widthFrac": {
                                    "description": "Picture width as a fraction of the text width, 0.1 to 1. Default 1 (full width, never enlarged beyond its own size).",
                                    "type": "number",
                                    "minimum": 0.1,
                                    "maximum": 1
                                  }
                                },
                                "required": [
                                  "type",
                                  "dataUri"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "list"
                                    ]
                                  },
                                  "ordered": {
                                    "type": "boolean",
                                    "description": "true for a numbered list, false for bullets."
                                  },
                                  "items": {
                                    "minItems": 1,
                                    "maxItems": 300,
                                    "type": "array",
                                    "items": {
                                      "minItems": 1,
                                      "type": "array",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "text": {
                                            "type": "string",
                                            "minLength": 1,
                                            "description": "The words of this run. Control characters that XML cannot hold are removed."
                                          },
                                          "bold": {
                                            "type": "boolean"
                                          },
                                          "italic": {
                                            "type": "boolean"
                                          },
                                          "underline": {
                                            "type": "boolean"
                                          },
                                          "color": {
                                            "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                            "type": "string",
                                            "pattern": "^#[0-9a-fA-F]{3,8}$"
                                          },
                                          "superscript": {
                                            "type": "boolean"
                                          },
                                          "subscript": {
                                            "type": "boolean"
                                          }
                                        },
                                        "required": [
                                          "text"
                                        ],
                                        "additionalProperties": false,
                                        "description": "A piece of text with one style. A paragraph is a list of runs."
                                      }
                                    }
                                  }
                                },
                                "required": [
                                  "type",
                                  "ordered",
                                  "items"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "table"
                                    ]
                                  },
                                  "rows": {
                                    "minItems": 1,
                                    "maxItems": 200,
                                    "type": "array",
                                    "items": {
                                      "type": "object",
                                      "properties": {
                                        "cells": {
                                          "minItems": 1,
                                          "maxItems": 30,
                                          "type": "array",
                                          "items": {
                                            "type": "array",
                                            "items": {
                                              "type": "object",
                                              "properties": {
                                                "text": {
                                                  "type": "string",
                                                  "minLength": 1,
                                                  "description": "The words of this run. Control characters that XML cannot hold are removed."
                                                },
                                                "bold": {
                                                  "type": "boolean"
                                                },
                                                "italic": {
                                                  "type": "boolean"
                                                },
                                                "underline": {
                                                  "type": "boolean"
                                                },
                                                "color": {
                                                  "description": "Text colour as a hex code such as #aa0000 (PDF and EPUB; the DOCX manuscript is always black).",
                                                  "type": "string",
                                                  "pattern": "^#[0-9a-fA-F]{3,8}$"
                                                },
                                                "superscript": {
                                                  "type": "boolean"
                                                },
                                                "subscript": {
                                                  "type": "boolean"
                                                }
                                              },
                                              "required": [
                                                "text"
                                              ],
                                              "additionalProperties": false,
                                              "description": "A piece of text with one style. A paragraph is a list of runs."
                                            }
                                          },
                                          "description": "One entry per column; each is a list of runs. An empty list is a blank cell. Short rows are padded to the widest row."
                                        },
                                        "header": {
                                          "description": "true makes this a header row (bold; repeats on each page in DOCX).",
                                          "type": "boolean"
                                        }
                                      },
                                      "required": [
                                        "cells"
                                      ],
                                      "additionalProperties": false
                                    }
                                  }
                                },
                                "required": [
                                  "type",
                                  "rows"
                                ],
                                "additionalProperties": false,
                                "description": "A table. Rendered in the PDF, the EPUB and the DOCX."
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "type": {
                                    "type": "string",
                                    "enum": [
                                      "sceneBreak"
                                    ]
                                  }
                                },
                                "required": [
                                  "type"
                                ],
                                "additionalProperties": false,
                                "description": "A break between scenes: a centred ornament in the PDF and EPUB, a # line in the DOCX manuscript."
                              }
                            ]
                          },
                          "description": "The chapter content in reading order, up to 800 blocks."
                        },
                        "partTitle": {
                          "description": "Groups this chapter and the following ones with the same partTitle under a Part divider page, such as Part One.",
                          "type": "string",
                          "maxLength": 300
                        }
                      },
                      "required": [
                        "title",
                        "blocks"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "direction": {
                    "description": "Reading direction: auto (the default), ltr or rtl. With auto, a book whose text is mostly Arabic or Hebrew is laid out right to left and anything else left to right; ltr or rtl overrides that. Right to left means the first page is a left-hand page with the binding on its right, mirrored margins, text, lists, tables and the table of contents running from the right, correct mixing of English words and numbers inside Arabic or Hebrew lines, and a PDF marked right-to-left (page 1 on the right of the spine in two-page view). EPUB: every page is dir=rtl and the spine has page-progression-direction=rtl. DOCX: right-to-left paragraphs and sections, Arabic and Hebrew runs marked right-to-left.",
                    "type": "string",
                    "enum": [
                      "auto",
                      "ltr",
                      "rtl"
                    ]
                  },
                  "bodyFontFamily": {
                    "description": "Body font, embedded in the EPUB (its Latin files, about 50 KB). Default: none, the reading app's own font is used. Eight OFL fonts: literata, eb-garamond, merriweather, lora, tinos (serif), inter, arimo (sans), playfair-display (display). Script fonts for Greek, Cyrillic, Hebrew, Arabic, Devanagari, Bengali, Tamil, Telugu, Gujarati, Kannada, Malayalam and Thai are embedded whenever the text uses those scripts.",
                    "type": "string",
                    "enum": [
                      "literata",
                      "eb-garamond",
                      "merriweather",
                      "lora",
                      "tinos",
                      "inter",
                      "arimo",
                      "playfair-display"
                    ]
                  },
                  "stableId": {
                    "description": "Used for the book identifier (urn:uuid:...) when there is no isbn or eisbn. A bare UUID (3f2504e0-4f89-41d3-9a0c-0305e82c3301) is used as it is, and the same UUID written with the prefix (urn:uuid:3f2504e0-...) gives exactly the same identifier, because the prefix is removed first. Any other text gives a UUID derived from it, so the same value always gives the same identifier. Default: a random UUID.",
                    "type": "string",
                    "maxLength": 200
                  },
                  "watermark": {
                    "description": "Opt-in preview watermark. Default false: the file is clean, with no promotional text. true adds a visible PREVIEW marking: in the PDF a light diagonal PREVIEW tiled across every page, in the EPUB and DOCX a banner line reading PREVIEW COPY on the cover and every chapter (EPUB) or in the page header (DOCX). The X-Watermark response header says whether it was applied.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "bookTitle",
                  "authorNames",
                  "language",
                  "chapters"
                ],
                "additionalProperties": false
              },
              "example": {
                "bookTitle": "The Lantern Harbor",
                "authorNames": [
                  "Maria Lopez"
                ],
                "language": "en",
                "chapters": [
                  {
                    "title": "Chapter One",
                    "blocks": [
                      {
                        "type": "paragraph",
                        "runs": [
                          {
                            "text": "The harbor woke slowly, one lantern at a time."
                          }
                        ]
                      }
                    ]
                  }
                ],
                "watermark": false
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The EPUB file Real example: 200, application/epub+zip, 6,790 bytes.",
            "content": {
              "application/epub+zip": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "Content-Disposition": {
                "schema": {
                  "type": "string"
                },
                "description": "attachment; filename=book.epub"
              },
              "X-Watermark": {
                "schema": {
                  "type": "string"
                },
                "description": "true when the preview watermark was applied, otherwise false",
                "example": "false"
              }
            }
          },
          "400": {
            "description": "A field is missing, has the wrong type, language is not a language tag, a picture is not a real image of an allowed type, or a field is unknown; the body names the problem"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          },
          "500": {
            "description": "The book could not be built. The body is {error, code} with a generic message."
          }
        }
      }
    },
    "/v1/publishing/cover-wrap": {
      "post": {
        "summary": "Documents: cover-wrap",
        "operationId": "publishingCoverWrap",
        "description": ". Every field is optional; an empty JSON object works. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/jwt-decode": {
      "post": {
        "summary": "Decode a JWT and check its time claims (signature NOT verified)",
        "operationId": "securityJwtDecode",
        "description": "Decodes the header and payload of a JSON Web Token and tells you, in plain words, whether its own time claims make it usable right now. IMPORTANT: this endpoint DECODES ONLY. It never verifies the signature (that needs the issuer's secret or public key), so a token that decodes cleanly is not proof the token is genuine. A leading 'Bearer ' (any case) is removed, so you can paste an Authorization header value. 'valid' is true only when ALL of these hold: the token is well formed; the header has an 'alg' that is not 'none'; 'exp' (if present) is in the future; 'nbf' (if present) is not in the future. Otherwise 'valid' is false and 'status' says why: 'expired', 'not_yet_valid', 'unsigned' (alg none, or an empty signature) or 'malformed' (HTTP 400). 'expired', 'notYetValid' and 'unsigned' are also returned as separate flags, 'issues' lists the reasons in plain words, and 'signatureVerified' is always false. Optional 'now' checks the claims as of another time and 'clockToleranceSeconds' allows for clock drift. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text",
          "Security & Developer Utilities"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "token": {
                    "type": "string",
                    "minLength": 1,
                    "description": "The JWT. A leading 'Bearer ' (as copied from an Authorization header) is removed for you."
                  },
                  "now": {
                    "description": "Optional. Check exp/nbf as of this time instead of now: epoch seconds or an ISO date.",
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "number"
                      }
                    ]
                  },
                  "clockToleranceSeconds": {
                    "description": "Optional. Seconds of clock difference allowed when checking exp and nbf (default 0).",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 86400
                  }
                },
                "required": [
                  "token"
                ],
                "additionalProperties": false
              },
              "example": {
                "token": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwiZXhwIjoxNTc3ODM2ODAwfQ.c2lnbmF0dXJl"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Jwt decoder",
                  "valid": false,
                  "wellFormed": true,
                  "status": "expired",
                  "signatureVerified": false,
                  "issues": [
                    "The token expired at 2020-01-01T00:00:00.000Z (exp), 215534435 seconds before the time checked."
                  ],
                  "header": {
                    "alg": "HS256",
                    "typ": "JWT"
                  },
                  "payload": {
                    "sub": "1234567890",
                    "exp": 1577836800
                  },
                  "signature": "c2lnbmF0dXJl",
                  "evaluatedAt": "2026-10-30T14:40:35.000Z",
                  "algorithm": "HS256",
                  "expiresAt": "2020-01-01T00:00:00.000Z",
                  "secondsUntilExpiry": -215534435,
                  "expired": true
                }
              }
            }
          },
          "400": {
            "description": "Missing token, or the token is malformed (not three parts, or the header/payload is not base64url JSON); the body has valid:false and a plain-words error"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/seo/schema": {
      "post": {
        "summary": "Build schema.org JSON-LD for an Article, FAQ page or Organization",
        "operationId": "seoSchema",
        "description": "Builds a JSON-LD block you can paste into a page's <script type=\"application/ld+json\">. Types: 'article' (required: headline; optional: description, author, publisher, datePublished, dateModified, image, url, keywords, articleSection, inLanguage), 'faq' (required: items, each with a question and an answer) and 'organization' (required: name; optional: legalName, alternateName, description, url, logo, email, telephone, foundingDate, sameAs, address, contactPoint). Required fields are checked: a missing or empty one returns 400 naming the exact field (for example 'data.items[1].answer' is required). Dates must be ISO 8601, web addresses must start with http:// or https://, and emails and phone numbers are format-checked. author and publisher accept a name or an object (name, url, logo). Nothing is invented: only what you send is output. Fields that are not supported for the type are not dropped silently, they are listed in 'warnings' together with fields Google recommends for rich results. This builds markup only; it does not validate it against Google's Rich Results test. Stateless: the request is processed in memory and nothing is stored. HTML entities: common entities in the text you send (&amp; &lt; &gt; &quot; &#39; &nbsp; and numeric forms such as &#233; or &#xE9;) are decoded once before processing, so 'Tom &amp; Jerry' is read as 'Tom & Jerry' and is not escaped twice, and keyword counts never include the word 'amp'; other named entities are left as typed. Errors: 400 with the same body on every SEO endpoint, {error, code, details: {fieldErrors, formErrors, issues}}.",
        "tags": [
          "Text",
          "SEO & Web Markup"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "enum": [
                      "article",
                      "faq",
                      "organization"
                    ],
                    "description": "Which schema.org type to build."
                  },
                  "data": {
                    "type": "object",
                    "additionalProperties": {},
                    "description": "The fields for that type. article: headline (required), description, author, publisher, datePublished, dateModified, image, url, keywords, articleSection, inLanguage. faq: items (required), a list of {question, answer}. organization: name (required), legalName, alternateName, description, url, logo, email, telephone, foundingDate, sameAs, address, contactPoint."
                  }
                },
                "required": [
                  "type",
                  "data"
                ],
                "additionalProperties": false
              },
              "example": {
                "type": "article",
                "data": {
                  "headline": "How to brew pour-over coffee",
                  "author": "Maria Lopez",
                  "publisher": {
                    "name": "Harbor Coffee Co.",
                    "logo": "https://example.com/logo.png"
                  },
                  "datePublished": "2026-10-01",
                  "dateModified": "2026-10-20",
                  "image": "https://example.com/pour-over.jpg",
                  "url": "https://example.com/pour-over"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "@context": {
                          "type": "string",
                          "description": "Always https://schema.org"
                        },
                        "@type": {
                          "type": "string",
                          "description": "Article, FAQPage or Organization"
                        }
                      },
                      "required": [
                        "@context",
                        "@type"
                      ],
                      "description": "The JSON-LD object, ready to place in a script tag of type application/ld+json. More properties follow the type; see the example.",
                      "example": {
                        "@context": "https://schema.org",
                        "@type": "Article",
                        "headline": "How to brew pour-over coffee"
                      }
                    },
                    "warnings": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "description": "A recommended field that is missing, or an input field that was not used"
                      },
                      "description": "Plain-words notes; empty when there is nothing to say",
                      "example": [
                        "Google recommends these for Article rich results and they were not provided: image."
                      ]
                    }
                  },
                  "required": [
                    "result",
                    "warnings"
                  ]
                },
                "example": {
                  "result": {
                    "@context": "https://schema.org",
                    "@type": "Article",
                    "headline": "How to brew pour-over coffee",
                    "author": {
                      "@type": "Person",
                      "name": "Maria Lopez"
                    },
                    "publisher": {
                      "@type": "Organization",
                      "name": "Harbor Coffee Co.",
                      "logo": "https://example.com/logo.png"
                    },
                    "datePublished": "2026-10-01",
                    "dateModified": "2026-10-20",
                    "image": "https://example.com/pour-over.jpg",
                    "mainEntityOfPage": {
                      "@type": "WebPage",
                      "@id": "https://example.com/pour-over"
                    },
                    "url": "https://example.com/pour-over"
                  },
                  "warnings": []
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input. Body: {error, code, details: {fieldErrors, formErrors, issues}}; error is a plain sentence naming the field, code is invalid_input or a specific code, issues lists each problem as {path, message, code}."
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/roman": {
      "post": {
        "summary": "Convert numbers to Roman numerals and back",
        "operationId": "convertersRoman",
        "description": "Send 'direction' (toRoman or fromRoman) and 'value'. toRoman takes a whole number from 1 to 3,999,999. Up to 3,999 the 'result' is the plain numeral it always was (1994 gives MCMXCIV). Above 3,999 the thousands are written with a bar over every letter, as the Unicode combining overline U+0305 after each letter (5000 is V followed by U+0305; 4000 is I and V, each followed by U+0305), and 'vinculum' is true; before this change those numbers were a 400. The response also adds 'breakdown' (the pieces joined with plus signs, such as M + CM + XC + IV) and 'steps', an ordered list of { label, formula, inputs, result } that ends on the numeral. fromRoman reads plain numerals with the strict rule it always had (IIII and other non-standard forms are rejected here; the website page accepts IIII as the clock-face 4 with a note), and now also barred numerals: type the bar as U+0305 or write the barred group in brackets, so (V) is 5,000 and (XII)CCCXLV is 12,345. The barred group is read as a numeral from 1 to 3,999 and multiplied by 1,000; the plain letters after it must be below 1,000 and written without M. Who calls it: school and homework tools, certificate and document generators, tattoo and wedding-invitation date designers, film and event copyright-year footers, and MCP agents. Worked example: {\"direction\":\"toRoman\",\"value\":1994000} returns the barred form of MCMXCIV with vinculum true and breakdown M + CM + XC + IV (each piece barred). Integration scenario: a certificate builder prints the issue year in numerals and uses the barred form for large counts such as a 1,994,000-copy print run. There is no zero and no negative number in Roman numerals. The bar is a typographic convention and some fonts place the combining overline slightly off, so draw it with CSS overline if the look matters. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Unit Conversion"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "direction": {
                    "type": "string",
                    "enum": [
                      "toRoman",
                      "fromRoman"
                    ]
                  },
                  "value": {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "string"
                      }
                    ],
                    "description": "toRoman: a whole number from 1 to 3,999,999 (above 3,999 the thousands get a bar over every letter, written with the Unicode combining overline U+0305). fromRoman: a numeral; barred letters may be typed with U+0305 or as a bracketed group such as (V) for 5,000."
                  }
                },
                "required": [
                  "direction",
                  "value"
                ],
                "additionalProperties": false
              },
              "example": {
                "direction": "toRoman",
                "value": 1994
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Roman numeral converter client and server side from freedailypro",
                  "result": "MCMXCIV"
                }
              }
            }
          },
          "400": {
            "description": "A value that is not a whole number from 1 to 3,999,999 (including 0, negatives and decimals) for toRoman; for fromRoman, letters other than I V X L C D M, a numeral not written in the standard form, barred letters that do not form a numeral from I to MMMCMXCIX, plain letters after a bar that are 1,000 or more, or barred letters after plain ones; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/units": {
      "post": {
        "summary": "Convert between units in 14 categories (length, weight, temperature, volume, area, speed, pressure, energy, power, time, data transfer, angle, fuel economy, cooking)",
        "operationId": "convertersUnits",
        "description": "Send 'category', 'value', 'from' and 'to' (unit ids). Returns 'result', the unit names, the 'factor' (one 'from' in 'to', for categories where that is a single number), and for volume, cooking and fuel economy a 'note' when a US or imperial unit is involved. Categories: length, weight (alias mass), temperature (C, F, K, R), volume, area, speed, pressure, energy, power, time, data_transfer, angle, fuel_economy and cooking. Over 130 units; POST /v1/converters/units-list returns every id, symbol, alias and a us, imperial or metric tag. Ids and aliases are case-insensitive (gal_us, GAL, kph, km/h). Exact factors: US customary and metric units use the exact international definitions (1 in = 0.0254 m, 1 lb = 0.45359237 kg, 1 US gallon = 3.785411784 L, 1 imperial gallon = 4.54609 L, 1 atm = 101325 Pa, 1 kcal = 4184 J, 1 Btu(IT) = 1055.05585262 J); each factor is cited in the source (NIST SP 811 and Handbook 44). Results are rounded to 12 significant digits to remove floating-point noise. US vs metric: US gallons, pints, cups and fluid ounces differ from imperial (UK) ones and from metric kitchen measures (a US cup is 236.588 mL, a metric cup 250 mL, a US tablespoon 14.787 mL, a metric one 15 mL, an Australian one 20 mL); the unit id says which one is used. Limits: cooking converts volume only (cups to grams depends on the ingredient and is not offered); time months and years are calendar averages (Gregorian year = 365.2425 days); Mach is not offered because it depends on temperature; temperatures below absolute zero and fuel economy values of 0 or less are refused; the older /length, /weight and /temperature endpoints still work and return a bare number. Pure arithmetic from the request: nothing is stored. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Unit Conversion"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "category": {
                    "type": "string",
                    "description": "length, weight, temperature, volume, area, speed, pressure, energy, power, time, data_transfer, angle, fuel_economy or cooking. List the units of each with /v1/converters/units-list."
                  },
                  "value": {
                    "type": "number",
                    "description": "The number to convert."
                  },
                  "from": {
                    "type": "string",
                    "description": "Unit id to convert from, for example gal_us, km_h, psi, kwh (see units-list for the ids and aliases)."
                  },
                  "to": {
                    "type": "string",
                    "description": "Unit id to convert to."
                  }
                },
                "required": [
                  "category",
                  "value",
                  "from",
                  "to"
                ],
                "additionalProperties": false
              },
              "example": {
                "category": "volume",
                "value": 2,
                "from": "gal_us",
                "to": "l"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Unit converter: 14 categories and over 130 units with exact factors",
                  "result": {
                    "category": "volume",
                    "value": 2,
                    "from": "gal_us",
                    "fromName": "US gallon",
                    "to": "l",
                    "toName": "Litre",
                    "result": 7.570823568,
                    "factor": 3.785411784,
                    "categoryNote": "US and imperial (UK) gallons, pints and fluid ounces differ: 1 US gallon is 3.785411784 L, 1 imperial gallon is 4.54609 L. Units are tagged us, imperial or metric.",
                    "note": "US customary and imperial (UK) units share names but not sizes (US gallon 3.785411784 L, imperial gallon 4.54609 L); the unit id says which one was used."
                  }
                }
              }
            }
          },
          "400": {
            "description": "An unknown category or unit id (the message lists the valid ones), a missing or non-numeric value, a temperature below absolute zero, or a fuel economy value of 0 or less"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/units-list": {
      "post": {
        "summary": "List the units of each category with ids, symbols, aliases and a US, imperial or metric tag",
        "operationId": "convertersUnitsList",
        "description": "Returns every category with its base unit, notes and units; each unit has an 'id' to send to /v1/converters/units, a name, a symbol, optional aliases and a 'system' tag (us, imperial or metric) where that applies. Send 'category' to list just one. Use it to build a unit picker or to let an agent look up the valid ids before converting. Static reference data: nothing is stored. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Unit Conversion"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "category": {
                    "description": "Only this category (for example volume). Leave out for every category.",
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "category": "speed"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Unit converter: the units of each category, with ids, symbols, aliases and a US, imperial or metric tag",
                  "result": {
                    "categoryCount": 1,
                    "unitCount": 5,
                    "categories": [
                      {
                        "category": "speed",
                        "name": "Speed",
                        "baseUnit": "m_s",
                        "note": "Mach is not offered: it depends on air temperature.",
                        "units": [
                          {
                            "id": "m_s",
                            "name": "Metre per second",
                            "symbol": "m/s",
                            "system": "metric",
                            "aliases": [
                              "m/s",
                              "mps"
                            ]
                          },
                          {
                            "id": "km_h",
                            "name": "Kilometre per hour",
                            "symbol": "km/h",
                            "system": "metric",
                            "aliases": [
                              "km/h",
                              "kph",
                              "kmh"
                            ]
                          },
                          {
                            "id": "mph",
                            "name": "Mile per hour",
                            "symbol": "mph",
                            "system": "us",
                            "aliases": [
                              "mi/h"
                            ]
                          },
                          "..."
                        ]
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "The category is not one of the 14 supported categories; the message lists them"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/file-size": {
      "post": {
        "summary": "Convert a file size between bytes, KB, MB, GB, TB and PB",
        "operationId": "convertersFileSize",
        "description": "Convert a file size between bytes, KB, MB, GB, TB and PB. Send JSON with value, from, to (required). Returns JSON with bytes, converted, from, to, formatted (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Unit Conversion"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "value": {
                    "type": "number"
                  },
                  "from": {
                    "type": "string",
                    "enum": [
                      "B",
                      "KB",
                      "MB",
                      "GB",
                      "TB",
                      "PB"
                    ]
                  },
                  "to": {
                    "type": "string",
                    "enum": [
                      "B",
                      "KB",
                      "MB",
                      "GB",
                      "TB",
                      "PB"
                    ]
                  }
                },
                "required": [
                  "value",
                  "from",
                  "to"
                ],
                "additionalProperties": false
              },
              "example": {
                "value": 1.5,
                "from": "GB",
                "to": "MB"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "File size converter client and server side from freedailypro",
                  "result": {
                    "bytes": 1610612736,
                    "converted": 1536,
                    "from": "GB",
                    "to": "MB",
                    "formatted": "1536.00 MB"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/job-experience": {
      "post": {
        "summary": "Calculate the years and months between a start and end date",
        "operationId": "convertersJobExperience",
        "description": "Calculate the years and months between a start and end date. Send JSON with startIso (required); optional: endIso, otherJobs, countEndDate. Returns JSON with years, months, totalMonths, label (inside result). Limits: otherJobs: up to 50 items. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Time Zones & Dates"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "startIso": {
                    "type": "string"
                  },
                  "endIso": {
                    "type": "string"
                  },
                  "otherJobs": {
                    "description": "More jobs. When given, the top-level years, months and label are the TOTAL across all jobs (overlapping periods counted once; the first job alone is in `firstJob`), and the response also has a `history` object: each job's length, the total, and the gaps between jobs.",
                    "maxItems": 50,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "startIso": {
                          "type": "string"
                        },
                        "endIso": {
                          "description": "YYYY-MM-DD. Leave out for a job that is still going on (today is used).",
                          "type": "string"
                        }
                      },
                      "required": [
                        "startIso"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "countEndDate": {
                    "description": "Only used with otherJobs. true (default) counts the end date as a full day, so 1 Jan to 31 Dec is one year.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "startIso"
                ],
                "additionalProperties": false
              },
              "example": {
                "startIso": "2018-03-01",
                "endIso": "2026-10-20"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Job experience calculator client and server side from freedailypro",
                  "result": {
                    "years": 8,
                    "months": 7,
                    "totalMonths": 103,
                    "label": "8 years 7 months"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/paycheck": {
      "post": {
        "summary": "Estimate take-home pay from salary: 2026 federal tax, FICA, state tax and pre-tax deductions",
        "operationId": "convertersPaycheck",
        "description": "Estimates take-home pay per pay period from yearly gross pay. Federal income tax uses the 2026 brackets and standard deduction for 'filingStatus' (single by default); FICA is the employee share (Social Security 6.2% up to the $184,500 wage base, Medicare 1.45%, Additional Medicare 0.9% above $200,000 single / $250,000 joint / $125,000 separate); 'state' (code or name) adds that state's 2026 income tax from the same table as the website; 'retirementPct' (traditional 401(k)) lowers income tax but not FICA; 'section125Annual' (health premiums, HSA/FSA) lowers both. 'federalRatePct' and 'stateRatePct' from the first version still work: when sent they replace the table lookup with a flat rate. If neither 'state' nor 'stateRatePct' is sent, no state income tax is included. California SDI: when 'state' is CA the response adds 'stateDisabilityInsurance' (per check, with 'stateDisabilityInsuranceName' and an annual figure) of 1.3% of all gross wages with no wage cap, deducted from net pay exactly as on the website's Paycheck and Income Tax calculators and the us-income-tax endpoint (a 401(k) deferral does not lower it; it is taken also when a flat 'stateRatePct' replaces the income-tax lookup). The 1.3% rate comes from the owner's brief citing the California EDD and could not be re-read on edd.ca.gov from the build environment (dataStatus for that line: unverified); NY, NJ, HI, RI, WA and MA payroll contributions are not modelled and a note says so. Returns per-check amounts, an 'annual' block, taxYear, sources, notes and a disclaimer. US federal figures are the IRS 2026 tax-year amounts from Revenue Procedure 2025-32 (brackets, standard deduction) and the SSA 2026 Social Security wage base of $184,500. Update process: all figures live in one table file that FreeDailyPro also uses for its website calculators (so the API and the website always agree) and are updated by FreeDailyPro each tax year; next review: November 2026, when the IRS and SSA publish the 2027 figures. No tax credits, local taxes or W-4 adjustments. Estimate, not tax advice. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Payroll & Paycheck"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "grossAnnual": {
                    "type": "number",
                    "description": "Gross pay for the year, in US dollars."
                  },
                  "payPeriodsPerYear": {
                    "description": "Pay periods per year: 52, 26, 24 or 12. Default 24.",
                    "type": "number"
                  },
                  "filingStatus": {
                    "description": "Federal filing status. Default single.",
                    "type": "string",
                    "enum": [
                      "single",
                      "married-joint",
                      "married-separate",
                      "head-of-household"
                    ]
                  },
                  "state": {
                    "description": "US state (two-letter code such as NY, or the full name; DC included). Adds that state's 2026 income tax from the same table as the website. Without it, no state income tax is included.",
                    "type": "string"
                  },
                  "retirementPct": {
                    "description": "Traditional 401(k)/403(b) deferral as a percent of gross pay. Lowers income tax but not FICA.",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "section125Annual": {
                    "description": "Yearly pre-tax health, dental, HSA or FSA deductions. Lowers income tax and FICA.",
                    "type": "number",
                    "minimum": 0
                  },
                  "federalRatePct": {
                    "description": "Optional flat federal rate in percent. When sent it replaces the 2026 bracket calculation (first-version behaviour).",
                    "type": "number",
                    "minimum": 0
                  },
                  "stateRatePct": {
                    "description": "Optional flat state rate in percent. When sent it replaces the state lookup (first-version behaviour).",
                    "type": "number",
                    "minimum": 0
                  },
                  "otherDeductionPerCheck": {
                    "description": "Other after-tax deduction taken from each paycheck, in dollars.",
                    "type": "number",
                    "minimum": 0
                  }
                },
                "required": [
                  "grossAnnual"
                ],
                "additionalProperties": false
              },
              "example": {
                "grossAnnual": 85000,
                "payPeriodsPerYear": 26,
                "filingStatus": "single",
                "state": "NY",
                "retirementPct": 5
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Paycheck estimator: 2026 US federal tax, FICA, state tax and pre-tax deductions",
                  "result": {
                    "taxYear": 2026,
                    "filingStatus": "single",
                    "payPeriodsPerYear": 26,
                    "grossPerCheck": 3269.23,
                    "federal": 343.65,
                    "state": 144.75,
                    "other": 0,
                    "socialSecurity": 202.69,
                    "medicare": 47.4,
                    "additionalMedicare": 0,
                    "fica": 250.1,
                    "retirement": 163.46,
                    "section125": 0,
                    "netPerCheck": 2367.27,
                    "estimatedAnnualNet": 61549,
                    "annual": {
                      "gross": 85000,
                      "federal": 8935,
                      "state": 3763.5,
                      "fica": 6502.5,
                      "retirement": 4250,
                      "section125": 0,
                      "other": 0,
                      "net": 61549,
                      "federalTaxableIncome": 64650
                    },
                    "federalSource": "2026 IRS brackets",
                    "stateSource": "New York schedule, tax year 2026 (official source); local taxes excluded",
                    "stateDetail": {
                      "code": "NY",
                      "name": "New York",
                      "taxYear": "2026",
                      "rateSource": "tax.ny.gov, NYS-50-T-NYS and NYS-50-T-Y (1/26) annual rate schedule: 3.9%, 4.4%, 5.15%, 5.4%, 5.9%",
                      "officialSource": true,
                      "localTaxNote": "New York City residents also pay city income tax of about 3.1% to 3.9%."
                    },
                    "sources": "IRS Rev. Proc. 2025-32 and SSA 2026 wage base. Tax year 2026. FreeDailyPro table last checked 2026-10-11 (compared with the official source). Next review: November, when the IRS publishes next year's figures.",
                    "dataStatus": "checked",
                    "notes": [
                      "2026 federal brackets and standard deduction for single; employee FICA with the Social Security wage base of $184,500. Figures are per pay period unless the field says annual.",
                      "Pre-tax retirement (retirementPct) lowers income tax but not FICA; section125Annual (health premiums, HSA/FSA) lowers both. No tax credits, no local income tax, no W-4 adjustments."
                    ],
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Negative or missing grossAnnual, payPeriodsPerYear of 0 or less, or an unknown filingStatus or state; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/fire": {
      "post": {
        "summary": "Estimate the savings target and years needed to reach financial independence",
        "operationId": "convertersFire",
        "description": "Estimate the savings target and years needed to reach financial independence. Send JSON with annualSpend (required); optional: currentSavings, annualContribution, expectedReturnPct, withdrawalRatePct, startDate. Returns JSON with targetNestEgg, yearsToFire, projected, withdrawalRatePct, startDate, fireDate (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Retirement & Debt Planning"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "annualSpend": {
                    "type": "number"
                  },
                  "currentSavings": {
                    "type": "number",
                    "minimum": 0
                  },
                  "annualContribution": {
                    "type": "number",
                    "minimum": 0
                  },
                  "expectedReturnPct": {
                    "type": "number"
                  },
                  "withdrawalRatePct": {
                    "type": "number",
                    "minimum": 0
                  },
                  "startDate": {
                    "description": "Optional plan start date, as YYYY-MM-DD. When the target is reached, adds startDate and fireDate (the start plus yearsToFire years). It only labels the timeline; the amounts do not change.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  }
                },
                "required": [
                  "annualSpend"
                ],
                "additionalProperties": false
              },
              "example": {
                "annualSpend": 40000,
                "currentSavings": 50000,
                "annualContribution": 20000,
                "expectedReturnPct": 7,
                "startDate": "2026-11-01"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "FIRE calculator client and server side from freedailypro",
                  "result": {
                    "targetNestEgg": 1000000,
                    "yearsToFire": 20,
                    "projected": 1013394.07,
                    "withdrawalRatePct": 4,
                    "startDate": "2026-11-01",
                    "fireDate": "2046-11-01"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/vat-gst": {
      "post": {
        "summary": "Calculate VAT or GST on an amount using a 59-entry country and province rate table",
        "operationId": "convertersVatGst",
        "description": "Adds VAT/GST to a net amount, or extracts it from a gross amount ('amountIncludesTax': true). Send 'ratePct' for any rate, or 'country' to use that country's STANDARD rate from a built-in table: the 27 EU member states, the UK, Norway, Switzerland, Iceland, Turkey, Ukraine, Canada (GST, HST, PST combined by province group), Australia, New Zealand, Singapore, India (GST; 'India' works), Japan, South Korea, Thailand, Philippines, Indonesia, UAE, Saudi Arabia, Israel, South Africa, Kenya, Nigeria, Egypt, Mexico, Chile, Colombia and Argentina. Names are case-insensitive and 'UK' works; an ambiguous or unknown name returns a 400 that lists the valid entries. The response includes the standard rate, the country's common reduced rates (send one as ratePct to use it), ratesAsOf, taxYear and sources. 'ratePct' wins if both are sent. Where the data comes from: the standard rates of the 27 EU states were compared with a published 2026 EU rate table on 30 Oct 2026; reduced rates and non-EU rates were compiled from the national tax authorities and have not all been re-verified, so dataStatus is 'estimate'. Update process: one table file shared with the FreeDailyPro website, reviewed by FreeDailyPro each January. It is not for US sales tax (use /v1/converters/sales-tax). Estimate, not tax advice. Start from a VAT amount or total an invoice: send 'vatAmount' (the VAT printed on a receipt) with ratePct or country to get net and gross (netRange gives the net amounts that would print that VAT after rounding to the cent; a rate of 0 is refused), or 'lines' (up to 200 { amount, ratePct } objects; a line without ratePct uses the top-level ratePct or the country's standard rate) to get 'byRate' subtotals, a grand total and, for Canada - Quebec, the GST and QST split. With lines, 'amountIncludesTax' says whether the amounts are gross. Tax is worked out once per rate on that rate's subtotal and rounded to the cent. Send only one of amount, vatAmount and lines. Every mode returns 'steps'. Who calls it: accounting and bookkeeping software, expense-claim and receipt-scanning tools, invoicing apps for UK and EU sole traders, and chatbots or MCP agents. Worked examples: {\"vatAmount\":20,\"ratePct\":20} returns net 100, gross 120; {\"lines\":[{\"amount\":100,\"ratePct\":20},{\"amount\":50,\"ratePct\":5}]} returns tax 22.5 and gross 172.5. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Currency & VAT"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "amount": {
                    "description": "The amount, in any currency. Send this, or vatAmount, or lines.",
                    "type": "number"
                  },
                  "vatAmount": {
                    "description": "The VAT amount shown on a receipt: returns the net and gross it implies at the rate (needs a rate above 0). Use instead of amount.",
                    "type": "number",
                    "minimum": 0
                  },
                  "lines": {
                    "description": "Invoice lines at different rates: returns a subtotal per rate (byRate) and a grand total. Use instead of amount.",
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "amount": {
                          "type": "number",
                          "minimum": 0,
                          "description": "The line amount (net, or gross when amountIncludesTax is true)."
                        },
                        "ratePct": {
                          "description": "This line's rate in percent. Defaults to the top-level ratePct or the country's standard rate.",
                          "type": "number",
                          "minimum": 0
                        }
                      },
                      "required": [
                        "amount"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "ratePct": {
                    "description": "VAT/GST rate in percent. Required unless country is sent. Takes priority over country.",
                    "type": "number"
                  },
                  "country": {
                    "description": "Country name (for example Germany, United Kingdom, Australia, Singapore, UAE). Looks up the standard VAT/GST rate. Canada has one entry per province group, e.g. 'Canada - Ontario HST'. The error for an unknown name lists every supported entry.",
                    "type": "string"
                  },
                  "amountIncludesTax": {
                    "description": "true when amount already includes the tax (the tax is taken out of it).",
                    "type": "boolean"
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "amount": 120,
                "country": "Germany",
                "amountIncludesTax": false
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "result": {
                    "net": 120,
                    "tax": 22.8,
                    "gross": 142.8,
                    "ratePct": 19,
                    "country": "Germany",
                    "standardRatePct": 19,
                    "reducedRatesPct": [
                      7
                    ],
                    "rateSource": "country standard rate",
                    "ratesAsOf": "October 2026",
                    "taxYear": 2026,
                    "sources": "Each country's tax authority. Tax year 2026. FreeDailyPro table last checked 2026-10-11 (compiled from secondary sources, confirm with the authority). Next review: January.",
                    "dataStatus": "estimate",
                    "notes": [
                      "Rate used: Germany standard rate 19%. Reduced rates also exist (7%) for some goods and services; send one as ratePct to use it.",
                      "Standard rates for the 27 EU member states were compared with a published 2026 table on 30 Oct 2026. Reduced rates and non-EU countries were compiled from memory of the national authorities and are not re-verified; confirm with the tax authority."
                    ],
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Body: {error, code, details: {fieldErrors, formErrors, issues, examples}}. code is invalid_input (wrong type, unknown field), missing_fields (none of amount, vatAmount and lines), conflicting_fields (more than one of them), missing_rate (no ratePct or country, vatAmount with a rate of 0, a line without any rate), invalid_amount, invalid_rate, invalid_lines, invalid_combination (amountIncludesTax with vatAmount) or unknown_country (unknown name or one that matches several entries; the message lists the supported names). details.examples shows the four accepted forms: net amount with country, gross amount with ratePct, vatAmount with ratePct, and lines"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/countdown": {
      "post": {
        "summary": "Count the days, hours and minutes until or since a date",
        "operationId": "convertersCountdown",
        "description": "Count the days, hours and minutes until or since a date. Send JSON with isoTarget (required); optional: fromIso. Returns JSON with past, days, hours, minutes, seconds, totalMs, label (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Time Zones & Dates"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "isoTarget": {
                    "type": "string"
                  },
                  "fromIso": {
                    "type": "string"
                  }
                },
                "required": [
                  "isoTarget"
                ],
                "additionalProperties": false
              },
              "example": {
                "isoTarget": "2026-12-25",
                "fromIso": "2026-10-20"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Countdown calculator client and server side from freedailypro",
                  "result": {
                    "past": false,
                    "days": 66,
                    "hours": 0,
                    "minutes": 0,
                    "seconds": 0,
                    "totalMs": 5702400000,
                    "label": "66d 0h 0m"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/401k": {
      "post": {
        "summary": "Project a 401(k) balance with the 2026 IRS contribution limits",
        "operationId": "converters401k",
        "description": "Projects a 401(k) balance from the current balance, a yearly employee contribution, an optional employer match (a percent of your own contribution), an expected return and a number of years. The response now includes the 2026 IRS employee deferral limit ($24,500; plus $8,000 catch-up from age 50, or $11,250 at ages 60 to 63) in 'irsLimits', the limit that applies to the 'age' you send (base limit without it), 'contributionExceedsIrsLimit' and a note. The contribution is used as sent unless you set 'applyIrsLimit': true, which caps it at the limit. 'startDate' still only labels the plan. Where the data comes from: IRS Notice 2025-67 for tax year 2026. Update process: limits live in one table file shared with the FreeDailyPro website and are updated by FreeDailyPro every November when the IRS announces next year's limits. Not modelled: the overall section 415(c) limit, future limit increases, salary growth. Estimate, not financial advice. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Retirement & Debt Planning"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "currentBalance": {
                    "type": "number",
                    "minimum": 0
                  },
                  "annualContribution": {
                    "type": "number",
                    "minimum": 0
                  },
                  "employerMatchPct": {
                    "description": "Employer match as a percent of your own contribution (50 = 50 cents per dollar).",
                    "type": "number",
                    "minimum": 0
                  },
                  "expectedReturnPct": {
                    "type": "number"
                  },
                  "years": {
                    "type": "number"
                  },
                  "age": {
                    "description": "Your age. Used to pick the 2026 IRS employee limit ($24,500; plus $8,000 catch-up at 50-59 and 64+, $11,250 at 60-63). Without it the base limit is used.",
                    "type": "number"
                  },
                  "applyIrsLimit": {
                    "description": "true caps annualContribution at the IRS limit for your age. Default false: the contribution is used as sent and a warning is returned if it is over the limit.",
                    "type": "boolean"
                  },
                  "startDate": {
                    "description": "Optional date the first contribution year starts, as YYYY-MM-DD. Adds startDate and endDate (when the projection ends). It only labels the plan; the amounts do not change.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  }
                },
                "required": [
                  "currentBalance",
                  "annualContribution",
                  "years"
                ],
                "additionalProperties": false
              },
              "example": {
                "currentBalance": 20000,
                "annualContribution": 7500,
                "employerMatchPct": 50,
                "expectedReturnPct": 7,
                "years": 30,
                "age": 45,
                "startDate": "2026-11-01"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "401(k) projection with the 2026 IRS contribution limits",
                  "result": {
                    "projectedBalance": 1214928.95,
                    "years": 30,
                    "totalContributed": 357500,
                    "taxYear": 2026,
                    "annualContributionUsed": 7500,
                    "irsLimits": {
                      "employeeDeferral": 24500,
                      "catchUpAge50": 8000,
                      "catchUpAge60to63": 11250,
                      "limitForAge": 24500,
                      "ageUsed": 45
                    },
                    "contributionExceedsIrsLimit": false,
                    "sources": "IRS Notice 2025-67 (2026 401(k) elective deferral limit $24,500; catch-up $8,000 at 50+, $11,250 at 60-63). FreeDailyPro updates these tables once a year, in November, when the IRS and SSA publish next year's figures.",
                    "dataStatus": "checked",
                    "notes": [
                      "annualContribution is within the 2026 employee limit of $24,500 for age 45.",
                      "annualContribution is the employee's own yearly deferral; employerMatchPct is the employer's extra percent of that deferral (50 means 50 cents per dollar), with no match cap. The same amount is assumed every year and the limit is not indexed for future years. The overall 415(c) limit on employee plu..."
                    ],
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser.",
                    "startDate": "2026-11-01",
                    "endDate": "2056-11-01"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing balance, contribution or years, a negative value, an invalid startDate, or an age outside 0 to 120"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/rmd": {
      "post": {
        "summary": "Calculate a required minimum distribution from the IRS Uniform Lifetime Table",
        "operationId": "convertersRmd",
        "description": "Divides the prior year-end 'accountBalance' by the IRS Uniform Lifetime Table divisor for the 'age' you reach this year (72 to 120, for example 75 gives 24.6). Optional 'birthYear' adds the SECURE 2.0 start age (73 if born 1951 to 1959, 75 if born 1960 or later, 72 before) and 'rmdRequiredThisYear'. The first version used a straight-line approximation of the table; this version uses the real table. The table is for account owners; it is not right for an owner whose only beneficiary is a spouse more than 10 years younger (Joint and Last Survivor table) or for inherited accounts (Single Life table). Where the data comes from: IRS Publication 590-B (Uniform Lifetime Table, in force since 2022); the table has not changed for 2026. Update process: one table file shared with the FreeDailyPro website; FreeDailyPro re-checks it every November and whenever the IRS publishes a new table. Estimate, not tax advice. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Retirement & Debt Planning"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "accountBalance": {
                    "type": "number",
                    "description": "Account balance on 31 December of the previous year."
                  },
                  "age": {
                    "type": "number",
                    "description": "Age you reach this year (72 to 120). The IRS Uniform Lifetime Table divisor for that age is used."
                  },
                  "birthYear": {
                    "description": "Birth year. Adds the SECURE 2.0 RMD start age (73 for 1951-1959, 75 for 1960 or later) and whether an RMD is required yet.",
                    "type": "number"
                  }
                },
                "required": [
                  "accountBalance",
                  "age"
                ],
                "additionalProperties": false
              },
              "example": {
                "accountBalance": 500000,
                "age": 75,
                "birthYear": 1951
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "RMD estimator using the IRS Uniform Lifetime Table",
                  "result": {
                    "factor": 24.6,
                    "rmd": 20325.2,
                    "age": 75,
                    "accountBalance": 500000,
                    "table": "IRS Uniform Lifetime Table (2022 onward)",
                    "taxYear": 2026,
                    "rmdStartAge": 73,
                    "rmdRequiredThisYear": true,
                    "sources": "IRS Publication 590-B Uniform Lifetime Table (in force since 2022) and SECURE 2.0 start ages (73 if born 1951-1959, 75 if born 1960 or later). FreeDailyPro updates these tables once a year, in November, when the IRS and SSA publish next year's figures.",
                    "dataStatus": "checked",
                    "notes": [
                      "Divisor 24.6 is the IRS Uniform Lifetime Table (in force since 2022) for the age you reach this year. The table is for account owners; it is not for an owner whose only beneficiary is a spouse more than 10 years younger (Joint and Last Survivor table) or for inherited accounts (Single Life table).",
                      "Use the account balance on 31 December of the previous year. Several IRAs are added together; each 401(k) is calculated on its own.",
                      "SECURE 2.0: RMDs start at age 73 for someone born in 1951."
                    ],
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Negative balance, an age that is not a whole number from 72 to 120, or an invalid birthYear"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/csv": {
      "post": {
        "summary": "Parse CSV text, convert it to JSON, or build CSV from headers and rows",
        "operationId": "textCsv",
        "description": "Three operations, each with its own required fields. 'parse': send 'text' (CSV); returns { headers, rows } (rows are arrays of strings). 'toJson': send EITHER 'text' (CSV; the first line is the header) OR 'headers' + 'rows'; returns an array of objects keyed by header, every value a string, short rows padded with empty strings. 'stringify': send 'headers' + 'rows'; returns CSV text (cells with the delimiter, quotes or line breaks are quoted). 'delimiter' is one character, default comma. Fields that do not belong to the chosen operation are rejected with a 400 and a plain message (for example 'rows' with 'parse', or 'text' with 'stringify') instead of being ignored. Quoted cells, escaped quotes and line breaks inside quotes are handled. All values stay strings: no number or date detection. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "operation": {
                    "type": "string",
                    "enum": [
                      "parse",
                      "stringify",
                      "toJson"
                    ]
                  },
                  "text": {
                    "type": "string"
                  },
                  "headers": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "rows": {
                    "type": "array",
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "delimiter": {
                    "type": "string"
                  }
                },
                "required": [
                  "operation"
                ],
                "additionalProperties": false
              },
              "example": {
                "operation": "toJson",
                "text": "name,qty\nPen,3\nBook,1"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "description": "toJson: an array of row objects; toCsv: a CSV string",
                      "oneOf": [
                        {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true
                          },
                          "description": "Rows as objects keyed by header"
                        },
                        {
                          "type": "string",
                          "description": "CSV text"
                        }
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "CSV converter client and server side from freedailypro",
                  "result": [
                    {
                      "name": "Pen",
                      "qty": "3"
                    },
                    {
                      "name": "Book",
                      "qty": "1"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or inapplicable field for the chosen operation, a row with more cells than headers, or a bad delimiter; the body has a plain-words error"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/similarity": {
      "post": {
        "summary": "Compare two texts and return the edit distance and a similarity percentage",
        "operationId": "textSimilarity",
        "description": "Compare two texts and return the edit distance and a similarity percentage. Send JSON with a, b (required); optional: phraseWords. Returns JSON with distance, ratio, percent (inside result). Limits: phraseWords: at most 8, at least 3. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "a": {
                    "type": "string",
                    "description": "First text, up to 10,000 characters (longer is a 422)."
                  },
                  "b": {
                    "type": "string",
                    "description": "Second text, up to 10,000 characters (longer is a 422)."
                  },
                  "phraseWords": {
                    "description": "When given (3 to 8), the response also has a `phrases` object: how much of each text sits inside phrases of this many words that both texts share (case and punctuation ignored). Shorter texts use shorter phrases. Compares the two texts with each other only; it is not a web plagiarism check.",
                    "type": "integer",
                    "minimum": 3,
                    "maximum": 8
                  }
                },
                "required": [
                  "a",
                  "b"
                ],
                "additionalProperties": false
              },
              "example": {
                "a": "The quick brown fox",
                "b": "A quick brown dog"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "distance": {
                          "type": "number",
                          "description": "Levenshtein edit distance"
                        },
                        "ratio": {
                          "type": "number",
                          "description": "Similarity from 0 to 1"
                        },
                        "percent": {
                          "type": "number",
                          "description": "Similarity as a percentage"
                        }
                      },
                      "required": [
                        "distance",
                        "ratio",
                        "percent"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Text similarity client and server side from freedailypro",
                  "result": {
                    "distance": 5,
                    "ratio": 0.7368,
                    "percent": 73.68
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/planning/packing-list": {
      "post": {
        "summary": "Build a packing list from trip length, climate and trip type",
        "operationId": "planningPackingList",
        "description": "Build a packing list from trip length, climate and trip type. Send JSON with nights, climate (required); optional: tripType. Returns JSON with nights, climate, items (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "nights": {
                    "type": "number",
                    "minimum": 0
                  },
                  "climate": {
                    "type": "string",
                    "enum": [
                      "hot",
                      "mild",
                      "cold"
                    ]
                  },
                  "tripType": {
                    "type": "string",
                    "enum": [
                      "leisure",
                      "business"
                    ]
                  }
                },
                "required": [
                  "nights",
                  "climate"
                ],
                "additionalProperties": false
              },
              "example": {
                "nights": 5,
                "climate": "cold",
                "tripType": "business"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Packing list generator client and server side from freedailypro",
                  "result": {
                    "nights": 5,
                    "climate": "cold",
                    "items": [
                      "6 tops",
                      "4 bottoms",
                      "5 underwear",
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/planning/event-budget": {
      "post": {
        "summary": "Total an event budget and the cost per guest",
        "operationId": "planningEventBudget",
        "description": "Total an event budget and the cost per guest. Send JSON with guests (required); optional: costPerGuest, venue, catering, extras. Returns JSON with guests, venue, catering, extras, total, perGuest (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "guests": {
                    "type": "number",
                    "minimum": 0
                  },
                  "costPerGuest": {
                    "type": "number",
                    "minimum": 0
                  },
                  "venue": {
                    "type": "number",
                    "minimum": 0
                  },
                  "catering": {
                    "type": "number",
                    "minimum": 0
                  },
                  "extras": {
                    "type": "number",
                    "minimum": 0
                  }
                },
                "required": [
                  "guests"
                ],
                "additionalProperties": false
              },
              "example": {
                "guests": 80,
                "costPerGuest": 45,
                "venue": 2500,
                "catering": 3600,
                "extras": 600
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Event budget planner client and server side from freedailypro",
                  "result": {
                    "guests": 80,
                    "venue": 2500,
                    "catering": 3600,
                    "extras": 600,
                    "total": 6700,
                    "perGuest": 83.75
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/planning/itinerary": {
      "post": {
        "summary": "Spread a list of activities across the days of a trip and return a day-by-day itinerary",
        "operationId": "planningItinerary",
        "description": "Spread a list of activities across the days of a trip and return a day-by-day itinerary. Send JSON with days, activities (required); optional: startDate. Returns JSON: a list. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "days": {
                    "type": "number",
                    "minimum": 0
                  },
                  "activities": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "startDate": {
                    "description": "Optional first day of the trip, as YYYY-MM-DD. Adds a calendar date to every day of the result.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  }
                },
                "required": [
                  "days",
                  "activities"
                ],
                "additionalProperties": false
              },
              "example": {
                "days": 3,
                "activities": [
                  "Old town walk",
                  "Museum",
                  "Harbour cruise",
                  "Market lunch"
                ],
                "startDate": "2027-03-14"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Travel itinerary splitter client and server side from freedailypro",
                  "result": [
                    {
                      "day": 1,
                      "items": [
                        "Old town walk",
                        "Market lunch"
                      ],
                      "date": "2027-03-14"
                    },
                    {
                      "day": 2,
                      "items": [
                        "Museum"
                      ],
                      "date": "2027-03-15"
                    },
                    {
                      "day": 3,
                      "items": [
                        "Harbour cruise"
                      ],
                      "date": "2027-03-16"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/tdee": {
      "post": {
        "summary": "Calculate total daily energy expenditure with cut and bulk calorie targets",
        "operationId": "convertersTdee",
        "description": "Send 'sex', 'age', 'weightKg', 'heightCm' and optionally 'activity'. The response is 'bmr' (Mifflin-St Jeor, Am J Clin Nutr 1990;51:241-247), 'tdee' (BMR x the activity factor), 'cut' (tdee - 500) and 'bulk' (tdee + 300), in calories a day; these are unchanged. Optional weekly cycling: send 'highDays' (1 to 3 higher days a week), and optionally 'swingPct' (how far above the daily target the higher days sit, 1 to 30, default 15) and 'cycleGoal' (maintain, cut or bulk; default maintain). The response then adds 'cycle' (dailyTarget, highKcal, lowKcal, the seven days, weeklyTotal, appliedSwingPct, limitedByFloor and safeMinimum) and a 'steps' array that shows the working. The weekly total is always the daily target x 7, so cycling changes when the calories are eaten, not how many. A lower day is never set under the safe minimum (1500 men, 1200 women; this app's long-standing floor, not re-checked against a published guideline); when the swing would break it the swing is reduced and limitedByFloor is true, and a target too close to the minimum is rejected with a 400. Note that 'cut' here is a plain 500 under maintenance with no 25 percent cap; the website calculator applies the cap and merges loss tiers that read the same. Who calls it: fitness and meal-planning apps, coaching dashboards, wellness chatbots and MCP agents. Worked example: {\"sex\":\"male\",\"age\":30,\"weightKg\":75,\"heightCm\":175,\"activity\":\"light\",\"highDays\":2,\"swingPct\":15} returns tdee 2336, two days at 2686 and five at 2196, week total 16352. Integration scenario: a meal-planning app turns one daily number into a seven-day plan with the same weekly calories. An estimate for healthy adults, not medical advice. Macros: send 'macroGoal' (lose, maintain or gain) to add 'macros': grams of protein, carbohydrate and fat for the matching calorie target (lose = cut, maintain = TDEE, gain = bulk), using the website's 35/35/30, 30/40/30 and 30/45/25 protein/carb/fat splits at 4, 4 and 9 kcal per gram, with 'withinAmdr' flags against the Institute of Medicine ranges (protein 10-35%, carbohydrate 45-65%, fat 20-35% of calories, DRI 2005). A 2,759 kcal maintenance target gives 207 g protein, 276 g carbohydrate and 92 g fat. The response also carries 'method' naming the formula, the activity factors and the cut and bulk rules. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Fitness & Health"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "sex": {
                    "type": "string",
                    "enum": [
                      "male",
                      "female"
                    ]
                  },
                  "age": {
                    "type": "number"
                  },
                  "weightKg": {
                    "type": "number"
                  },
                  "heightCm": {
                    "type": "number"
                  },
                  "activity": {
                    "type": "string",
                    "enum": [
                      "sedentary",
                      "light",
                      "moderate",
                      "active",
                      "veryActive"
                    ]
                  },
                  "highDays": {
                    "description": "Weekly calorie cycling: how many higher-calorie days a week (1 to 3).",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 3
                  },
                  "swingPct": {
                    "description": "How far above the daily target the higher days sit, in percent. Default 15.",
                    "type": "number",
                    "minimum": 1,
                    "maximum": 30
                  },
                  "cycleGoal": {
                    "description": "Which daily target to spread over the week. Default maintain.",
                    "type": "string",
                    "enum": [
                      "maintain",
                      "cut",
                      "bulk"
                    ]
                  },
                  "macroGoal": {
                    "description": "Adds a macros block: grams of protein, carbohydrate and fat for the matching calorie target (lose = cut, maintain = TDEE, gain = bulk), the percentage split, and whether each share sits inside the Institute of Medicine AMDR ranges.",
                    "type": "string",
                    "enum": [
                      "lose",
                      "maintain",
                      "gain"
                    ]
                  }
                },
                "required": [
                  "sex",
                  "age",
                  "weightKg",
                  "heightCm"
                ],
                "additionalProperties": false
              },
              "example": {
                "sex": "female",
                "age": 32,
                "weightKg": 62,
                "heightCm": 168,
                "activity": "light"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Calorie TDEE calculator client and server side from freedailypro",
                  "result": {
                    "bmr": 1349,
                    "tdee": 1855,
                    "cut": 1355,
                    "bulk": 2155
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or non-positive body measurements, highDays outside 1 to 3, a swingPct outside 1 to 30, or a target too close to the safe minimum for a cycling plan; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/self-employment-tax": {
      "post": {
        "summary": "Calculate US self-employment tax for 2026: Social Security wage base, Medicare and Additional Medicare",
        "operationId": "convertersSelfEmploymentTax",
        "description": "Self-employment tax on net profit for tax year 2026: net earnings are 92.35% of profit; Social Security 12.4% up to the $184,500 wage base (less any 'w2Wages' you send), Medicare 2.9% on everything, plus the 0.9% Additional Medicare Tax above $200,000 single / $250,000 joint / $125,000 separate ('filingStatus'). No tax is due under $400 of net earnings. 'seTax' (Social Security plus Medicare) keeps its first-version meaning; the Additional Medicare Tax is shown separately, and 'deductibleHalf' is the half you deduct from income. US federal figures are the IRS 2026 tax-year amounts from Revenue Procedure 2025-32 (brackets, standard deduction) and the SSA 2026 Social Security wage base of $184,500. Update process: all figures live in one table file that FreeDailyPro also uses for its website calculators (so the API and the website always agree) and are updated by FreeDailyPro each tax year; next review: November 2026, when the IRS and SSA publish the 2027 figures. Estimate, not tax advice. One quarterly payment: the response always includes 'quarterlySeTax', 'quarterlyPayment', 'schedule' (the four IRS due dates, 2026-04-15, 2026-06-15, 2026-09-15 and 2027-01-15, with each part) and 'steps'. With 'includeIncomeTax': true, quarterlyPayment is self-employment tax plus federal income tax (2026 brackets and standard deduction, after the deduction for half of the self-employment tax; with W-2 wages it is the extra tax the profit adds, assuming the wages' own tax is withheld); 'state' adds that state's income tax, and 'priorYearTax' (with optional 'priorYearAgi') returns the IRS safe-harbour alternative: the smaller of 100% of last year's tax (110% when last year's AGI was above $150,000, or $75,000 if married filing separately) and 90% of this year's self-employment plus federal income tax (IRS, 'Estimated tax', irs.gov/faqs/estimated-tax, read 30 Oct 2026). It is tested against the federal figure only; with 'state' the state gets its own test (safeHarbour.state: 90% of this year's state tax, or the smaller of last year's state tax and that when 'priorYearStateTax' is sent) and safeHarbour.annualPayment adds the two. 'method':'annualized' with 'cumulativeProfit' (profit through Mar 31, May 31, Aug 31) works each payment from income earned so far; 'ytdWithholding', 'paymentsMade' and 'asOf' return a 'remaining' block with what is still to pay and when. A negative netProfit is still a 400. Who calls it: accounting and invoicing apps for freelancers, gig-platform tax tools, bookkeeping dashboards, and chatbots or MCP agents. Worked example: {\"netProfit\":60000,\"includeIncomeTax\":true} returns seTax 8477.73 (2119.43 a quarter), federalIncomeTax 3559.47 (after the 7,932.23 qualified business income deduction, qbiDeduction), annualPayment 12037.2 and quarterlyPayment 3009.3; without includeIncomeTax quarterlyPayment is 2119.43. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Payroll & Paycheck"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "netProfit": {
                    "type": "number",
                    "description": "Net self-employment profit for the year, in US dollars."
                  },
                  "filingStatus": {
                    "description": "Federal filing status. Default single.",
                    "type": "string",
                    "enum": [
                      "single",
                      "married-joint",
                      "married-separate",
                      "head-of-household"
                    ]
                  },
                  "w2Wages": {
                    "description": "W-2 wages from a job in the same year. They use up part of the Social Security wage base and count toward the Additional Medicare threshold.",
                    "type": "number",
                    "minimum": 0
                  },
                  "includeIncomeTax": {
                    "description": "true adds federal income tax (2026 brackets, standard deduction, after the half self-employment tax deduction) so quarterlyPayment is the whole estimated payment. Default false: quarterlyPayment is the self-employment tax divided by 4.",
                    "type": "boolean"
                  },
                  "state": {
                    "description": "With includeIncomeTax: a US state (two-letter code or name) to add that state's income tax on the profit.",
                    "type": "string"
                  },
                  "priorYearTax": {
                    "description": "With includeIncomeTax: last year's federal total tax (self-employment plus income tax), for the IRS safe-harbour test on the federal part (100% of last year's tax, or 110% if priorYearAgi is above the threshold).",
                    "type": "number",
                    "minimum": 0
                  },
                  "priorYearAgi": {
                    "description": "With priorYearTax: last year's adjusted gross income; above $150,000 ($75,000 married filing separately) the safe harbour is 110% of last year's tax.",
                    "type": "number",
                    "minimum": 0
                  },
                  "priorYearStateTax": {
                    "description": "With includeIncomeTax and state: last year's state income tax, for the state's own safe-harbour test. Without it the state test is 90% of this year's state tax. priorYearTax is last year's federal total (self-employment plus income tax) and is tested against the federal figure only.",
                    "type": "number",
                    "minimum": 0
                  },
                  "method": {
                    "description": "'even' (default): four equal payments. 'annualized': each payment follows the income earned so far (needs cumulativeProfit); good for seasonal income.",
                    "type": "string",
                    "enum": [
                      "even",
                      "annualized"
                    ]
                  },
                  "cumulativeProfit": {
                    "description": "With method 'annualized': net profit earned so far through Mar 31, May 31 and Aug 31 (cumulative, rising, not above netProfit). netProfit is the full-year figure.",
                    "minItems": 3,
                    "maxItems": 3,
                    "type": "array",
                    "items": {
                      "type": "number",
                      "minimum": 0
                    }
                  },
                  "ytdWithholding": {
                    "description": "With includeIncomeTax: federal income tax already withheld this year (for example from a W-2 job). Counts against the yearly total in the 'remaining' block and the safe harbour.",
                    "type": "number",
                    "minimum": 0
                  },
                  "paymentsMade": {
                    "description": "Estimated payments already made this year. Counts against the yearly total in the 'remaining' block and the safe harbour.",
                    "type": "number",
                    "minimum": 0
                  },
                  "asOf": {
                    "description": "YYYY-MM-DD. Payments due on or before this date are treated as past when spreading what is still to pay. Default: all four are still ahead.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  }
                },
                "required": [
                  "netProfit"
                ],
                "additionalProperties": false
              },
              "example": {
                "netProfit": 90000,
                "filingStatus": "single"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Self-employment tax: 2026 wage base, Medicare and Additional Medicare",
                  "result": {
                    "quarterlySeTax": 3179.15,
                    "quarterlyPayment": 3179.15,
                    "includesIncomeTax": false,
                    "method": "even",
                    "schedule": [
                      {
                        "payment": "Q1",
                        "incomeEarned": "Jan 1 - Mar 31",
                        "due": "2026-04-15",
                        "seTax": 3179.15,
                        "federalIncomeTax": 0,
                        "stateIncomeTax": 0,
                        "total": 3179.15
                      },
                      {
                        "payment": "Q2",
                        "incomeEarned": "Apr 1 - May 31",
                        "due": "2026-06-15",
                        "seTax": 3179.15,
                        "federalIncomeTax": 0,
                        "stateIncomeTax": 0,
                        "total": 3179.15
                      },
                      {
                        "payment": "Q3",
                        "incomeEarned": "Jun 1 - Aug 31",
                        "due": "2026-09-15",
                        "seTax": 3179.15,
                        "federalIncomeTax": 0,
                        "stateIncomeTax": 0,
                        "total": 3179.15
                      },
                      "..."
                    ],
                    "steps": [
                      {
                        "label": "Net earnings",
                        "formula": "Net profit x 92.35%",
                        "inputs": {
                          "Net profit": 90000
                        },
                        "result": 83115
                      },
                      {
                        "label": "Self-employment tax",
                        "formula": "Social Security 12.4% (up to the wage base, less W-2 wages) + Medicare 2.9% + Additional Medicare 0.9% above the threshold",
                        "inputs": {
                          "Social Security": 10306.26,
                          "Medicare": 2410.34,
                          "Additional Medicare": 0
                        },
                        "result": 12716.6
                      },
                      {
                        "label": "Per quarter (self-employment tax only)",
                        "formula": "Self-employment tax / 4",
                        "inputs": {
                          "Self-employment tax": 12716.6
                        },
                        "result": 3179.15
                      }
                    ],
                    "taxYear": 2026,
                    "filingStatus": "single",
                    "taxableBase": 83115,
                    "seTax": 12716.6,
                    "socialSecurity": 10306.26,
                    "medicare": 2410.34,
                    "additionalMedicare": 0,
                    "totalWithAdditionalMedicare": 12716.6,
                    "deductibleHalf": 6358.3,
                    "socialSecurityWageBase": 184500,
                    "sources": "IRS Rev. Proc. 2025-32 and SSA 2026 wage base. Tax year 2026. FreeDailyPro table last checked 2026-10-11 (compared with the official source). Next review: November, when the IRS publishes next year's figures.",
                    "dataStatus": "checked",
                    "notes": [
                      "Net earnings = profit x 92.35%. Social Security 12.4% applies up to the 2026 wage base of $184,500 (less any w2Wages you send); Medicare 2.9% on everything; Additional Medicare 0.9% above $200,000 (single/head of household), $250,000 (joint) or $125,000 (separate). No self-employment tax is due when...",
                      "Half of seTax is deductible when working out income tax (deductibleHalf)."
                    ],
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Negative or missing netProfit (a loss is not accepted: there is no self-employment tax on a loss), a negative w2Wages, an unknown filingStatus or state, or state, priorYearTax or priorYearAgi sent without includeIncomeTax"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/529": {
      "post": {
        "summary": "Project the balance of a 529 college savings plan from monthly contributions",
        "operationId": "converters529",
        "description": "Project the balance of a 529 college savings plan from monthly contributions. Send JSON with currentBalance, monthlyContribution, years (required); optional: expectedReturnPct, firstContributionDate. Returns JSON with projected, months, totalContributed, firstContributionDate, lastContributionDate, targetDate (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Retirement & Debt Planning"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "currentBalance": {
                    "type": "number",
                    "minimum": 0
                  },
                  "monthlyContribution": {
                    "type": "number",
                    "minimum": 0
                  },
                  "years": {
                    "type": "number"
                  },
                  "expectedReturnPct": {
                    "type": "number"
                  },
                  "firstContributionDate": {
                    "description": "Optional date of the first monthly contribution, as YYYY-MM-DD. Adds firstContributionDate, lastContributionDate and targetDate (when the projected balance is reached). It only labels the plan; the amounts do not change. A day of 29 to 31 moves to the last day of shorter months.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  }
                },
                "required": [
                  "currentBalance",
                  "monthlyContribution",
                  "years"
                ],
                "additionalProperties": false
              },
              "example": {
                "currentBalance": 5000,
                "monthlyContribution": 300,
                "years": 15,
                "expectedReturnPct": 6,
                "firstContributionDate": "2026-11-01"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "529 calculator client and server side from freedailypro",
                  "result": {
                    "projected": 99516.08,
                    "months": 180,
                    "totalContributed": 59000,
                    "firstContributionDate": "2026-11-01",
                    "lastContributionDate": "2041-10-01",
                    "targetDate": "2041-11-01"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/planning/event-checklist": {
      "post": {
        "summary": "Return an event planning checklist for a wedding, birthday or conference",
        "operationId": "planningEventChecklist",
        "description": "Return an event planning checklist for a wedding, birthday or conference. Send JSON with no required fields; optional: eventType. Returns JSON with eventType, items (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "eventType": {
                    "type": "string",
                    "enum": [
                      "wedding",
                      "birthday",
                      "conference",
                      "other"
                    ]
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "eventType": "conference"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Event checklist planner client and server side from freedailypro",
                  "result": {
                    "eventType": "conference",
                    "items": [
                      "Set date",
                      "Set budget",
                      "Create guest list",
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/planning/event-schedule": {
      "post": {
        "summary": "Turn a list of sessions and durations into a timed event schedule",
        "operationId": "planningEventSchedule",
        "description": "Turn a list of sessions and durations into a timed event schedule. Send JSON with startHour, items (required). Returns JSON: a list. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "startHour": {
                    "type": "number"
                  },
                  "items": {
                    "minItems": 1,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "title": {
                          "type": "string"
                        },
                        "minutes": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "title",
                        "minutes"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "startHour",
                  "items"
                ],
                "additionalProperties": false
              },
              "example": {
                "startHour": 9,
                "items": [
                  {
                    "title": "Doors open and coffee",
                    "minutes": 30
                  },
                  {
                    "title": "Keynote",
                    "minutes": 45
                  },
                  {
                    "title": "Workshops",
                    "minutes": 90
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Event day schedule client and server side from freedailypro",
                  "result": [
                    {
                      "title": "Doors open and coffee",
                      "start": "09:00",
                      "end": "09:30",
                      "minutes": 30
                    },
                    {
                      "title": "Keynote",
                      "start": "09:30",
                      "end": "10:15",
                      "minutes": 45
                    },
                    {
                      "title": "Workshops",
                      "start": "10:15",
                      "end": "11:45",
                      "minutes": 90
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/planning/guest-list": {
      "post": {
        "summary": "Summarise a guest list: invited, yes, no, maybe and total heads",
        "operationId": "planningGuestList",
        "description": "Summarise a guest list: invited, yes, no, maybe and total heads. Send JSON with guests (required). Returns JSON with total, invited, yes, no, maybe, heads (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "guests": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "invited",
                            "yes",
                            "no",
                            "maybe"
                          ]
                        },
                        "plusOne": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "name",
                        "status"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "guests"
                ],
                "additionalProperties": false
              },
              "example": {
                "guests": [
                  {
                    "name": "Maria Lopez",
                    "status": "yes",
                    "plusOne": true
                  },
                  {
                    "name": "Dev Patel",
                    "status": "maybe"
                  },
                  {
                    "name": "Sam Chen",
                    "status": "no"
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Guest list tracker client and server side from freedailypro",
                  "result": {
                    "total": 3,
                    "invited": 0,
                    "yes": 1,
                    "no": 1,
                    "maybe": 1,
                    "heads": 2
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/planning/relocation-checklist": {
      "post": {
        "summary": "Return a moving and relocation checklist",
        "operationId": "planningRelocationChecklist",
        "description": "Return a moving and relocation checklist. Every field is optional; an empty JSON object works. Returns JSON with items (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "additionalProperties": false
              },
              "example": {}
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Relocation checklist planner client and server side from freedailypro",
                  "result": {
                    "items": [
                      "Notify landlord / list home",
                      "Get moving quotes",
                      "Change address (USPS / bank / employer)",
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/planning/cost-of-living": {
      "post": {
        "summary": "Cost of living: salary needed in another U.S. city from a city or ZIP lookup (127 metros, BEA 2023) or your own indexes",
        "operationId": "planningCostOfLiving",
        "description": "Send 'salary' and either 'from' and 'to' (a U.S. city such as 'Austin' or 'Austin, TX', or a 5-digit ZIP, matched on its first 3 digits) or 'fromIndex' and 'toIndex' (any cost-of-living index, 100 = average; you can mix a place on one side with an index on the other). Returns 'ratio' (new index / current index), 'equivalentSalary' (salary x ratio), 'percentChange', and 'from' and 'to' blocks that give each index, the metro and where the index came from. Place lookups use the table the FreeDailyPro cost-of-living tool uses: the U.S. Bureau of Economic Analysis Regional Price Parities for 2023, covering 127 U.S. metros, republished by the Tax Foundation. It is a 2023 index of overall price levels, not live data and not a price survey, and it covers the United States only: a place not in the table is a 400 that says so rather than a guess (send your own indexes instead). Who calls it: relocation and job-offer comparison tools, HR compensation and remote-pay tools, moving and real-estate sites, chatbots and MCP agents. Worked example: {\"from\":\"Austin, TX\",\"to\":\"Seattle\",\"salary\":100000} uses indexes 97.6 and 113.0 and returns ratio 1.158, an equivalent salary of 115,778.69 and +15.78% (113.0 / 97.6 checked independently). Integration scenario: a job-offer page shows what an offer in another city is worth in the candidate's current city. Update process: the BEA publishes the Regional Price Parities each year; the table file is shared with the website. Pure arithmetic over a static table; no customer data is stored. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fromIndex": {
                    "description": "Cost-of-living index of the current place (100 = average). Leave out when you send 'from'.",
                    "type": "number",
                    "minimum": 0
                  },
                  "toIndex": {
                    "description": "Cost-of-living index of the new place. Leave out when you send 'to'.",
                    "type": "number",
                    "minimum": 0
                  },
                  "salary": {
                    "type": "number",
                    "description": "Current salary."
                  },
                  "from": {
                    "description": "Current place as a U.S. city ('Austin' or 'Austin, TX') or 5-digit ZIP; looked up in the built-in table of 127 U.S. metros (BEA Regional Price Parities, 2023).",
                    "type": "string"
                  },
                  "to": {
                    "description": "New place, same format as 'from'.",
                    "type": "string"
                  }
                },
                "required": [
                  "salary"
                ],
                "additionalProperties": false
              },
              "example": {
                "from": "Austin, TX",
                "to": "Seattle",
                "salary": 100000
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Cost of living comparison client and server side from freedailypro",
                  "result": {
                    "ratio": 1.24,
                    "equivalentSalary": 86800,
                    "percentChange": 24
                  }
                }
              }
            }
          },
          "400": {
            "description": "A missing salary, a place that is not one of the 127 covered metros, or neither a place nor an index for one side; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/invoice-totals": {
      "post": {
        "summary": "Calculate invoice subtotal, discount, tax and total from line items",
        "operationId": "businessInvoiceTotals",
        "description": "Calculate invoice subtotal, discount, tax and total from line items. Send JSON with lines (required); optional: taxPct, discountPct, businessName, clientName, invoiceNumber, invoiceDate, dueDate, terms, notes, currencySymbol, includeDocx. Returns JSON with subtotal, discount, tax, total (inside result). Limits: businessName: up to 200 characters; clientName: up to 200 characters; invoiceNumber: up to 60 characters; terms: up to 1000 characters; notes: up to 2000 characters; currencySymbol: up to 4 characters. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "lines": {
                    "minItems": 1,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "description": {
                          "type": "string"
                        },
                        "qty": {
                          "type": "number"
                        },
                        "unitPrice": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "qty",
                        "unitPrice"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "taxPct": {
                    "type": "number",
                    "minimum": 0
                  },
                  "discountPct": {
                    "type": "number",
                    "minimum": 0
                  },
                  "businessName": {
                    "description": "Your business name. Sending businessName and clientName also returns the invoice as a document: result.document, result.text and, with includeDocx, a Word file.",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "clientName": {
                    "description": "Who the invoice is for. Needed with businessName for the document.",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "invoiceNumber": {
                    "description": "Invoice number printed on the document.",
                    "type": "string",
                    "maxLength": 60
                  },
                  "invoiceDate": {
                    "description": "YYYY-MM-DD, a real date (422 otherwise).",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  "dueDate": {
                    "description": "YYYY-MM-DD, a real date on or after invoiceDate (422 otherwise).",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  "terms": {
                    "description": "Payment terms line, for example 'Net 30. Pay by bank transfer.'",
                    "type": "string",
                    "maxLength": 1000
                  },
                  "notes": {
                    "description": "Notes printed at the bottom of the document.",
                    "type": "string",
                    "maxLength": 2000
                  },
                  "currencySymbol": {
                    "description": "Symbol printed before amounts in the document. Default $. The totals themselves are plain numbers.",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 4
                  },
                  "includeDocx": {
                    "description": "true also returns the invoice as a Word file in result.docx (filename, contentType, base64). Needs businessName and clientName.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "lines"
                ],
                "additionalProperties": false
              },
              "example": {
                "lines": [
                  {
                    "description": "Design",
                    "qty": 1,
                    "unitPrice": 2400
                  },
                  {
                    "description": "Build",
                    "qty": 1,
                    "unitPrice": 3600
                  }
                ],
                "taxPct": 8.25,
                "discountPct": 5
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Invoice totals client and server side from freedailypro",
                  "result": {
                    "subtotal": 6000,
                    "discount": 300,
                    "tax": 470.25,
                    "total": 6170.25
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/expenses": {
      "post": {
        "summary": "Total expenses and break them down by category, month and share",
        "operationId": "businessExpenses",
        "description": "Send items, each { category, amount } with an optional date (YYYY-MM-DD) and description. Returns total, byCategory (the original answer: the sum per category exactly as sent), count, categories (a list sorted by total with count and sharePct of the net total), a CSV of the category table, and, when any item has a date, byMonth totals (YYYY-MM) and undatedItems. A refund is a negative amount and reduces its category. mergeCategories:true treats categories that differ only in case or surrounding spaces as one (the first spelling is kept); by default categories are used exactly as sent. Limits: it totals what you send; it does not read receipts, convert currencies, keep a ledger or categorise by itself (use bank-statement-to-csv with categorize or categoryRules for that). Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Documents",
          "Bookkeeping"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "category": {
                          "type": "string"
                        },
                        "amount": {
                          "type": "number"
                        },
                        "date": {
                          "description": "Optional date, YYYY-MM-DD. When any item has one, the response adds byMonth totals.",
                          "type": "string",
                          "pattern": "^\\d{4}-\\d{2}-\\d{2}"
                        },
                        "description": {
                          "description": "Optional note; not used in the totals.",
                          "type": "string",
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "category",
                        "amount"
                      ],
                      "additionalProperties": false
                    },
                    "description": "The expenses to total. A refund is a negative amount."
                  },
                  "mergeCategories": {
                    "description": "true treats categories that differ only in case or surrounding spaces as one. Default false (exactly as sent).",
                    "type": "boolean"
                  }
                },
                "required": [
                  "items"
                ],
                "additionalProperties": false
              },
              "example": {
                "items": [
                  {
                    "category": "Software",
                    "amount": 129,
                    "date": "2026-09-02"
                  },
                  {
                    "category": "Travel",
                    "amount": 480.5,
                    "date": "2026-10-11"
                  },
                  {
                    "category": "Software",
                    "amount": 49,
                    "date": "2026-10-20"
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Expense tracker client and server side from freedailypro",
                  "result": {
                    "total": 658.5,
                    "byCategory": {
                      "Software": 178,
                      "Travel": 480.5
                    },
                    "count": 3,
                    "categories": [
                      {
                        "category": "Travel",
                        "total": 480.5,
                        "count": 1,
                        "sharePct": 72.97
                      },
                      {
                        "category": "Software",
                        "total": 178,
                        "count": 2,
                        "sharePct": 27.03
                      }
                    ],
                    "csv": "Category,Count,Total,Share %\nTravel,1,480.50,72.97\nSoftware,2,178.00,27.03"
                  }
                }
              }
            }
          },
          "400": {
            "description": "items is missing or an item has no category or a non-numeric amount; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/barcode-code128": {
      "post": {
        "summary": "Generate a Code 128 barcode as valid SVG",
        "operationId": "securityBarcodeCode128",
        "description": "Encodes 'text' as a Code 128 (subset B) barcode. 'text' must be 1 to 80 printable ASCII characters (codes 32 to 126); anything else is rejected with a 400. 'height' is the bar height in px (default 80). The JSON response holds 'svg' (a complete, valid SVG with width and height and single-quoted attributes, no escaped quotes, no trailing newline), 'dataUrl' (data:image/svg+xml URL), 'width' and 'height'. Send 'format': 'svg' to get the raw image/svg+xml document as the response body instead of JSON. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text",
          "Security & Developer Utilities"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 80,
                    "pattern": "^[\\x20-\\x7E]+$"
                  },
                  "height": {
                    "type": "number",
                    "minimum": 10,
                    "maximum": 400
                  },
                  "format": {
                    "type": "string",
                    "enum": [
                      "json",
                      "svg"
                    ]
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "FDP-2026-0042",
                "height": 60,
                "format": "svg"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Code 128 barcode",
                  "result": {
                    "svg": "<svg xmlns='http://www.w3.org/2000/svg' width='203' height='108' viewBox='0 0 203 108'>...</svg>",
                    "dataUrl": "data:image/svg+xml;charset=utf-8,%3Csvg...",
                    "width": 203,
                    "height": 108
                  }
                }
              }
            }
          },
          "400": {
            "description": "Text empty, longer than 80 characters or containing non-ASCII characters; height out of range; or an unsupported 'format'"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/social-security": {
      "post": {
        "summary": "Estimate a Social Security retirement benefit with the 2026 bend points",
        "operationId": "convertersSocialSecurity",
        "description": "Estimates the monthly retirement benefit. Send your AIME as 'averageIndexedMonthlyEarnings' (from your SSA statement), or 'annualEarnings' with optional 'yearsWorked' to have AIME estimated. The primary insurance amount (PIA) uses the 2026 bend points: 90% of AIME up to $1,286, 32% up to $7,749 and 15% above. 'birthYear' sets full retirement age (67 for 1960 or later; default 1960) and 'claimAge' (62 to 70, default 67) applies the early-claim reduction (5/9 of 1% a month for the first 36 months, 5/12 of 1% after) or the delayed-retirement credit (8% a year). First-version fields estimatedPIA, monthlyAtClaimAge and claimAge are unchanged; exact values are in piaExact and monthlyExact. Where the data comes from: SSA 2026 bend points and contribution and benefit base ($184,500). Bend points are those for people first eligible in 2026; other eligibility years use other bend points. Update process: one table file shared with the FreeDailyPro website, updated by FreeDailyPro every November when the SSA announces the next year's figures. Not an SSA statement: earnings are not indexed, and cost-of-living adjustments, spousal benefits, the earnings test and benefit taxation are not modelled. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Retirement & Debt Planning"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "averageIndexedMonthlyEarnings": {
                    "description": "Your AIME (average indexed monthly earnings) from your SSA statement. Send this or annualEarnings.",
                    "type": "number"
                  },
                  "annualEarnings": {
                    "description": "Alternative to AIME: current yearly earnings (capped at the 2026 wage base of $184,500). AIME is estimated from it.",
                    "type": "number",
                    "minimum": 0
                  },
                  "yearsWorked": {
                    "description": "With annualEarnings: years of work, up to 35 (default 35).",
                    "type": "number",
                    "minimum": 0
                  },
                  "claimAge": {
                    "description": "Age you start benefits, 62 to 70 (decimals such as 62.5 are rounded to whole months). Default 67.",
                    "type": "number"
                  },
                  "birthYear": {
                    "description": "Birth year, which sets full retirement age (67 if born 1960 or later). Default 1960.",
                    "type": "number"
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "averageIndexedMonthlyEarnings": 6000,
                "claimAge": 67,
                "birthYear": 1962
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Social Security retirement benefit estimate with 2026 bend points",
                  "result": {
                    "aime": 6000,
                    "estimatedPIA": 2666,
                    "piaExact": 2665.8,
                    "monthlyAtClaimAge": 2666,
                    "monthlyExact": 2665.8,
                    "annualAtClaimAge": 31989.6,
                    "claimAge": 67,
                    "birthYear": 1962,
                    "fullRetirementAge": "67",
                    "fullRetirementAgeMonths": 804,
                    "bendPoints": {
                      "first": 1286,
                      "second": 7749
                    },
                    "wageBase": 184500,
                    "taxYear": 2026,
                    "sources": "SSA 2026 PIA bend points ($1,286 and $7,749) and 2026 contribution and benefit base ($184,500); SSA full-retirement-age and delayed-credit rules. FreeDailyPro updates these tables once a year, in November, when the IRS and SSA publish next year's figures.",
                    "dataStatus": "checked",
                    "notes": [
                      "PIA = 90% of AIME up to $1,286, 32% from there to $7,749, 15% above (2026 bend points, which apply to people first eligible, at 62, in 2026; other years use different bend points). Full retirement age 67.",
                      "Before full retirement age the benefit is cut by 5/9 of 1% per month for the first 36 months and 5/12 of 1% after that; after it, it grows 8% a year (to age 70). Cost-of-living adjustments, spousal benefits, the earnings test and taxation of benefits are not modelled."
                    ],
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser. This is not an SSA estimate; see your my Social Security statement for official figures."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Neither averageIndexedMonthlyEarnings nor annualEarnings, a negative value, a claimAge outside 62 to 70, or an invalid birthYear"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/planning/chores": {
      "post": {
        "summary": "Split chores fairly between people and return who does what",
        "operationId": "planningChores",
        "description": "Split chores fairly between people and return who does what. Send JSON with people, chores (required). Returns JSON: a list. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "people": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "chores": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "required": [
                  "people",
                  "chores"
                ],
                "additionalProperties": false
              },
              "example": {
                "people": [
                  "Ana",
                  "Ben",
                  "Chloe"
                ],
                "chores": [
                  "Dishes",
                  "Laundry",
                  "Vacuum",
                  "Trash",
                  "Groceries"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Household chore splitter client and server side from freedailypro",
                  "result": [
                    {
                      "chore": "Dishes",
                      "assignee": "Ana"
                    },
                    {
                      "chore": "Laundry",
                      "assignee": "Ben"
                    },
                    {
                      "chore": "Vacuum",
                      "assignee": "Chloe"
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/nda-draft": {
      "post": {
        "summary": "Draft a mutual non-disclosure agreement from the parties and purpose",
        "operationId": "businessNdaDraft",
        "description": "Draft a mutual non-disclosure agreement from the parties and purpose. Send JSON with disclosingParty, receivingParty, purpose (required); optional: termYears, governingLaw, date. Returns JSON with title, parties, purpose, termYears, clauses (inside result). Limits: governingLaw: up to 120 characters. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "disclosingParty": {
                    "type": "string",
                    "minLength": 1
                  },
                  "receivingParty": {
                    "type": "string",
                    "minLength": 1
                  },
                  "purpose": {
                    "type": "string",
                    "minLength": 1,
                    "description": "What the information is shared for, finishing the sentence \"to ...\", for example \"evaluate a software partnership\"."
                  },
                  "termYears": {
                    "description": "Years the duty lasts. Default 2.",
                    "type": "number",
                    "minimum": 0
                  },
                  "governingLaw": {
                    "description": "Whose law governs, for example \"the State of Texas\" or \"England and Wales\". Default: the place where the property or the parties are.",
                    "type": "string",
                    "maxLength": 120
                  },
                  "date": {
                    "description": "Effective date, any readable form.",
                    "type": "string"
                  }
                },
                "required": [
                  "disclosingParty",
                  "receivingParty",
                  "purpose"
                ],
                "additionalProperties": false
              },
              "example": {
                "disclosingParty": "Northwind Design LLC",
                "receivingParty": "Harbor Coffee Co.",
                "purpose": "Evaluating a website project",
                "termYears": 2
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "NDA draft client and server side from freedailypro",
                  "result": {
                    "title": "Mutual Non-Disclosure Agreement (draft)",
                    "parties": [
                      "Northwind Design LLC",
                      "Harbor Coffee Co."
                    ],
                    "purpose": "Evaluating a website project",
                    "termYears": 2,
                    "clauses": [
                      "Confidential information is any non-public business, technical, or financial information.",
                      "Recipient will use information only for the stated purpose and not disclose it to third parties.",
                      "Obligations last 2 years from the date of disclosure.",
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/bill-of-sale-draft": {
      "post": {
        "summary": "Draft a bill of sale from the seller, buyer, item and price",
        "operationId": "businessBillOfSaleDraft",
        "description": "Draft a bill of sale from the seller, buyer, item and price. Send JSON with seller, buyer, item, price, date (required); optional: identifier, condition, warranty, paymentMethod, odometer, governingLaw. Returns JSON with title, body (inside result). Limits: governingLaw: up to 120 characters. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "seller": {
                    "type": "string",
                    "minLength": 1
                  },
                  "buyer": {
                    "type": "string",
                    "minLength": 1
                  },
                  "item": {
                    "type": "string",
                    "minLength": 1
                  },
                  "price": {
                    "type": "string",
                    "minLength": 1
                  },
                  "date": {
                    "type": "string",
                    "minLength": 1
                  },
                  "identifier": {
                    "description": "Make, model, serial number or VIN.",
                    "type": "string"
                  },
                  "condition": {
                    "type": "string"
                  },
                  "warranty": {
                    "description": "as-is (default) or the seller states it works as described.",
                    "type": "string",
                    "enum": [
                      "as-is",
                      "warranty"
                    ]
                  },
                  "paymentMethod": {
                    "type": "string"
                  },
                  "odometer": {
                    "description": "Odometer reading for a vehicle.",
                    "type": "string"
                  },
                  "governingLaw": {
                    "description": "Whose law governs, for example \"the State of Texas\" or \"England and Wales\". Default: the place where the property or the parties are.",
                    "type": "string",
                    "maxLength": 120
                  }
                },
                "required": [
                  "seller",
                  "buyer",
                  "item",
                  "price",
                  "date"
                ],
                "additionalProperties": false
              },
              "example": {
                "seller": "Jordan Reyes",
                "buyer": "Taylor Kim",
                "item": "2018 Honda Civic, VIN 2HGFC2F59JH000000",
                "price": "$14,500",
                "date": "2026-10-30"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Bill of sale draft client and server side from freedailypro",
                  "result": {
                    "title": "Bill of sale (draft)",
                    "body": "On 2026-10-30, Jordan Reyes sells 2018 Honda Civic, VIN 2HGFC2F59JH000000 to Taylor Kim for $14,500. Item is sold as-is unless otherwise agreed. Draft only — not legal advice."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/product-margin": {
      "post": {
        "summary": "Calculate profit, margin and markup from cost and price",
        "operationId": "businessProductMargin",
        "description": "Calculate profit, margin and markup from cost and price. Send JSON with cost, price (required); optional: quantity, fixedCosts, targetMarginPct. Returns JSON with profit, marginPct, markupPct (inside result). Limits: targetMarginPct: at most 99.9. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "cost": {
                    "type": "number",
                    "minimum": 0,
                    "description": "What one unit costs you."
                  },
                  "price": {
                    "type": "number",
                    "minimum": 0,
                    "description": "What you sell one unit for."
                  },
                  "quantity": {
                    "description": "Units, for totals.",
                    "type": "number",
                    "minimum": 0
                  },
                  "fixedCosts": {
                    "description": "One-off costs (tooling, setup, launch) for the break-even quantity.",
                    "type": "number",
                    "minimum": 0
                  },
                  "targetMarginPct": {
                    "description": "A margin you want; its price is added to the price ladder.",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 99.9
                  }
                },
                "required": [
                  "cost",
                  "price"
                ],
                "additionalProperties": false
              },
              "example": {
                "cost": 18.4,
                "price": 39.99,
                "quantity": 500,
                "fixedCosts": 2500,
                "targetMarginPct": 60
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Product margin calculator client and server side from freedailypro",
                  "result": {
                    "profit": 21.59,
                    "marginPct": 53.99,
                    "markupPct": 117.34
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/planning/monthly-budget": {
      "post": {
        "summary": "Total a monthly budget and return spending, savings and remaining money",
        "operationId": "planningMonthlyBudget",
        "description": "Send 'income' (monthly) and 'expenses', each { name, amount }. As in the first version, 'spent' is the sum of the expenses, 'remaining' is income less spent and 'savingsRatePct' is remaining as a share of income. B-0136 adds two optional fields on each expense. 'kind' is need, want, savings or debt (a REQUIRED debt payment such as a card or loan minimum, which counts in the needs bucket of the 50/30/20 view; send only the minimum as debt and any extra as savings). 'period' is month (default) or year: a yearly amount counts as amount / 12 a month, which is how a sinking fund for an annual bill (insurance, gifts, car repairs) shows up in a monthly budget. When any expense uses kind or period, 'spent' is the sum of the monthly amounts and the response adds 'plan': needs (debt included), wants, saved, debt, yearlySetAside, spending (needs + wants), leftOver, 'lines' (each with its kind, the bucket it counts in, entered amount and monthly amount) and a 'steps' array that shows the working. Without kind or period the response is exactly the first version. Who calls it: budgeting and personal-finance apps, bank and fintech onboarding flows, financial-wellness programmes, and chatbots or MCP agents. Worked example: {\"income\":3500,\"expenses\":[{\"name\":\"Rent\",\"amount\":1200,\"kind\":\"need\"},{\"name\":\"Car insurance\",\"amount\":1200,\"kind\":\"need\",\"period\":\"year\"},{\"name\":\"Card minimum\",\"amount\":250,\"kind\":\"debt\"},{\"name\":\"Streaming\",\"amount\":50,\"kind\":\"want\"},{\"name\":\"Savings\",\"amount\":300,\"kind\":\"savings\"}]} returns plan.needs 1550 (1200 + 100 for the yearly insurance + 250 debt), wants 50, saved 300, debt 250, yearlySetAside 100 and leftOver 1600. Integration scenario: an app lists a user's bills, flags the annual ones as per year and shows how much to set aside each month and what is really left over. The 50/30/20 rule (about 50% needs, 30% wants, 20% savings) is a common rule of thumb, not advice; nothing is stored. A kind other than need, want, savings or debt, a period other than month or year, or a negative or non-numeric amount when kind or period is used is rejected with a 400. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Bookkeeping"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "income": {
                    "type": "number"
                  },
                  "expenses": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "amount": {
                          "type": "number"
                        },
                        "kind": {
                          "description": "50/30/20 bucket: need, want, savings, or debt (a required debt payment, counted in needs). When no expense has a kind the site's name-based guess is used for plan, and without kind or period on any expense the response is the first version.",
                          "type": "string",
                          "enum": [
                            "need",
                            "want",
                            "savings",
                            "debt"
                          ]
                        },
                        "period": {
                          "description": "month (default) or year: a yearly amount counts as amount / 12 a month (a sinking fund for an annual bill).",
                          "type": "string",
                          "enum": [
                            "month",
                            "year"
                          ]
                        }
                      },
                      "required": [
                        "name",
                        "amount"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "income",
                  "expenses"
                ],
                "additionalProperties": false
              },
              "example": {
                "income": 5200,
                "expenses": [
                  {
                    "name": "Rent",
                    "amount": 1850
                  },
                  {
                    "name": "Groceries",
                    "amount": 520
                  },
                  {
                    "name": "Transport",
                    "amount": 210
                  },
                  {
                    "name": "Subscriptions",
                    "amount": 65
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Monthly budget planner client and server side from freedailypro",
                  "result": {
                    "income": 5200,
                    "spent": 2645,
                    "remaining": 2555,
                    "savingsRatePct": 49.13,
                    "expenses": [
                      {
                        "name": "Rent",
                        "amount": 1850
                      },
                      {
                        "name": "Groceries",
                        "amount": 520
                      },
                      {
                        "name": "Transport",
                        "amount": 210
                      },
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "A missing income, an unknown kind or period, or a negative or non-numeric expense amount (when kind or period is used); the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/planning/grocery-list": {
      "post": {
        "summary": "Group a grocery list by aisle and count the items",
        "operationId": "planningGroceryList",
        "description": "Group a grocery list by aisle and count the items. Send JSON with items (required). Returns JSON with count, items, byAisle (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "qty": {
                          "type": "number"
                        },
                        "unit": {
                          "type": "string"
                        },
                        "aisle": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "name"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "items"
                ],
                "additionalProperties": false
              },
              "example": {
                "items": [
                  {
                    "name": "Milk",
                    "qty": 2,
                    "unit": "l",
                    "aisle": "Dairy"
                  },
                  {
                    "name": "Apples",
                    "qty": 6,
                    "aisle": "Produce"
                  },
                  {
                    "name": "Yogurt",
                    "qty": 4,
                    "aisle": "Dairy"
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Grocery list planner client and server side from freedailypro",
                  "result": {
                    "count": 3,
                    "items": [
                      {
                        "name": "Milk",
                        "qty": 2,
                        "unit": "l",
                        "aisle": "Dairy"
                      },
                      {
                        "name": "Apples",
                        "qty": 6,
                        "unit": "",
                        "aisle": "Produce"
                      },
                      {
                        "name": "Yogurt",
                        "qty": 4,
                        "unit": "",
                        "aisle": "Dairy"
                      }
                    ],
                    "byAisle": {
                      "Dairy": [
                        {
                          "name": "Milk",
                          "qty": 2,
                          "unit": "l",
                          "aisle": "Dairy"
                        },
                        {
                          "name": "Yogurt",
                          "qty": 4,
                          "unit": "",
                          "aisle": "Dairy"
                        }
                      ],
                      "Produce": [
                        {
                          "name": "Apples",
                          "qty": 6,
                          "unit": "",
                          "aisle": "Produce"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/planning/inventory": {
      "post": {
        "summary": "Summarise stock levels and flag items below their reorder point",
        "operationId": "planningInventory",
        "description": "Summarise stock levels and flag items below their reorder point. Send JSON with items (required). Returns JSON with skuCount, totalUnits, lowStock (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "sku": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "qty": {
                          "type": "number"
                        },
                        "reorderAt": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "name",
                        "qty"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "items"
                ],
                "additionalProperties": false
              },
              "example": {
                "items": [
                  {
                    "sku": "TS-BLK-M",
                    "name": "T-shirt black M",
                    "qty": 12,
                    "reorderAt": 20
                  },
                  {
                    "sku": "MG-WHT",
                    "name": "Mug white",
                    "qty": 85,
                    "reorderAt": 30
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Inventory tracker client and server side from freedailypro",
                  "result": {
                    "skuCount": 2,
                    "totalUnits": 97,
                    "lowStock": [
                      {
                        "sku": "TS-BLK-M",
                        "name": "T-shirt black M",
                        "qty": 12,
                        "reorderAt": 20
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/student-loan": {
      "post": {
        "summary": "Calculate the payoff time and total interest of a student loan",
        "operationId": "convertersStudentLoan",
        "description": "Send 'principal', 'annualRatePct' and EITHER 'monthlyPayment' (the payment you make) or 'standardTermYears' (use the standard payment for that term). Returns the payoff 'months', 'years', 'totalInterest' and 'totalPaid' as before, and 'payoffDate' with 'firstPaymentDate'. Additive fields (B-0135): 'income' (yearly adjusted gross income) adds 'incomeDriven': the Repayment Assistance Plan (RAP) payment, and with 'ibr' (10 or 15) the Income-Based Repayment payment, beside the standard plan, each with months paying, total paid, interest paid and the balance forgiven at the end; 'dependents' (RAP takes $50 a month off for each), 'householdSize' and 'state' (AK and HI use their own poverty guideline for IBR) refine it. 'refinance' { annualRatePct, years } adds 'refinance': the new payment, total interest and 'interestSaved' (negative when a longer term costs more), with a warning that refinancing federal loans with a private lender ends federal protections. Plan rules, read 30 Oct 2026: RAP payment = the share of AGI for its $10,000 band (1% for $10,001 to $20,000 rising 1 point per band to 9%, 10% above $100,000) / 12, less $50 per dependent, minimum $10 a month, forgiveness after 30 years, unpaid interest not charged; IBR is 10% or 15% of discretionary income (AGI less 150% of the 2026 HHS poverty guideline: 48 states and DC 15,960 plus 5,680 per extra person, Alaska 19,950 plus 7,100, Hawaii 18,360 plus 6,530) never above the 10-year standard payment, forgiven after 20 or 25 years. Plan lineup: SAVE ended by court order on 10 March 2026; PAYE and ICR close on 1 July 2028; a borrower with a new federal loan on or after 1 July 2026 can choose only RAP or the Tiered Standard plan, so ibr is only for borrowers whose loans were all made before that date. Sources: the FSA servicer page edfinancial.studentaid.gov, the Illinois Attorney General's RAP handout, NerdWallet's RAP guide and Federal Register 2026-00755; studentaid.gov itself could not be fetched, so check it for your own loans. Not modelled: the RAP principal match (sources differ on how it works, so a real RAP payoff can be slightly faster), income growth, annual recalculation, subsidised-loan interest benefits, spouse income, the Tiered Standard plan's tiers. Unpaid IBR interest is modelled as accruing without compounding, with payments going to interest first. Who calls it: student-finance and loan-comparison sites, university financial-aid offices, budgeting and net-worth apps, and chatbots or MCP agents. Worked example: {\"principal\":30000,\"annualRatePct\":5.5,\"standardTermYears\":10,\"income\":45000,\"householdSize\":1,\"ibr\":10,\"refinance\":{\"annualRatePct\":4,\"years\":10}} returns RAP 150.00 a month (4% band) with 54,000 paid over 360 months and 18,579.85 forgiven, IBR 175.50 a month (discretionary income 21,060), and a refinance payment of 303.74 that saves 2,620.61 in interest. Integration scenario: a graduate-aid site shows a recent graduate their standard payment, the RAP payment from their salary and what a refinance would change, with the federal-protections warning beside it. The plan figures change by law and by year: update the table file and the poverty guideline each January. Illustration, not advice. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Retirement & Debt Planning"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "principal": {
                    "type": "number"
                  },
                  "annualRatePct": {
                    "type": "number"
                  },
                  "monthlyPayment": {
                    "description": "The payment you make. Send this or standardTermYears.",
                    "type": "number"
                  },
                  "standardTermYears": {
                    "description": "Use the standard payment for this many years instead of sending monthlyPayment.",
                    "type": "number"
                  },
                  "income": {
                    "description": "Yearly adjusted gross income. Adds incomeDriven: the Repayment Assistance Plan payment (and IBR with ibr) beside the standard plan, with total paid, term and forgiven balance.",
                    "type": "number",
                    "minimum": 0
                  },
                  "dependents": {
                    "description": "Dependents claimed on the tax return (RAP takes $50 a month off for each). With income.",
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "householdSize": {
                    "description": "Household size for the IBR poverty guideline. With income. Default 1.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 9007199254740991
                  },
                  "state": {
                    "description": "Two-letter state code. AK and HI use their own poverty guideline for IBR; anything else the 48-state figure.",
                    "type": "string"
                  },
                  "ibr": {
                    "description": "Also show IBR at 10% (loans from 1 July 2014, 20 years) or 15% (older loans, 25 years) of discretionary income. Only for borrowers whose loans were all made before 1 July 2026.",
                    "anyOf": [
                      {
                        "type": "number",
                        "enum": [
                          10
                        ]
                      },
                      {
                        "type": "number",
                        "enum": [
                          15
                        ]
                      }
                    ]
                  },
                  "refinance": {
                    "description": "A private refinance on the same balance: returns the new payment and the interest saved or added.",
                    "type": "object",
                    "properties": {
                      "annualRatePct": {
                        "type": "number",
                        "minimum": 0,
                        "maximum": 100
                      },
                      "years": {
                        "type": "number",
                        "minimum": 1,
                        "maximum": 40
                      }
                    },
                    "required": [
                      "annualRatePct",
                      "years"
                    ],
                    "additionalProperties": false
                  },
                  "firstPaymentDate": {
                    "description": "Optional date the first payment is due, as YYYY-MM-DD. Adds firstPaymentDate, lastPaymentDate and payoffDate to the result. It only labels the result; the months, interest and totals do not change. A payment day of 29 to 31 moves to the last day of shorter months.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  }
                },
                "required": [
                  "principal",
                  "annualRatePct"
                ],
                "additionalProperties": false
              },
              "example": {
                "principal": 30000,
                "annualRatePct": 5.5,
                "monthlyPayment": 400,
                "firstPaymentDate": "2027-05-01"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Student loan calculator client and server side from freedailypro",
                  "result": {
                    "months": 93,
                    "years": 7.8,
                    "totalInterest": 6844.72,
                    "totalPaid": 36844.72,
                    "firstPaymentDate": "2027-05-01",
                    "lastPaymentDate": "2035-01-01",
                    "payoffDate": "2035-01"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing both monthlyPayment and standardTermYears, or both sent; a payment that does not cover the interest; ibr, dependents, householdSize or state without income; a household size or dependents out of range; a refinance rate or term out of range; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/lease-draft": {
      "post": {
        "summary": "Draft a residential lease from the landlord, tenant, address and rent",
        "operationId": "businessLeaseDraft",
        "description": "Draft a residential lease from the landlord, tenant, address and rent. Send JSON with landlord, tenant, address, rent, start, end (required); optional: rentDueDay, securityDeposit, lateFee, lateFeeAfterDays, utilities, pets, smoking, holdoverNoticeDays, governingLaw. Returns JSON with title, body (inside result). Limits: rentDueDay: at most 28, at least 1; lateFeeAfterDays: at most 60; holdoverNoticeDays: at most 180, at least 1; governingLaw: up to 120 characters. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "landlord": {
                    "type": "string",
                    "minLength": 1
                  },
                  "tenant": {
                    "type": "string",
                    "minLength": 1
                  },
                  "address": {
                    "type": "string",
                    "minLength": 1
                  },
                  "rent": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Rent with currency and period, for example \"$1,850 per month\"."
                  },
                  "start": {
                    "type": "string",
                    "minLength": 1
                  },
                  "end": {
                    "type": "string",
                    "minLength": 1
                  },
                  "rentDueDay": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 28
                  },
                  "securityDeposit": {
                    "type": "string"
                  },
                  "lateFee": {
                    "type": "string"
                  },
                  "lateFeeAfterDays": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 60
                  },
                  "utilities": {
                    "type": "string",
                    "enum": [
                      "tenant",
                      "landlord",
                      "shared"
                    ]
                  },
                  "pets": {
                    "type": "string",
                    "enum": [
                      "none",
                      "allowed",
                      "with-permission"
                    ]
                  },
                  "smoking": {
                    "type": "string",
                    "enum": [
                      "not-allowed",
                      "outside-only",
                      "allowed"
                    ]
                  },
                  "holdoverNoticeDays": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 180
                  },
                  "governingLaw": {
                    "description": "Whose law governs, for example \"the State of Texas\" or \"England and Wales\". Default: the place where the property or the parties are.",
                    "type": "string",
                    "maxLength": 120
                  }
                },
                "required": [
                  "landlord",
                  "tenant",
                  "address",
                  "rent",
                  "start",
                  "end"
                ],
                "additionalProperties": false
              },
              "example": {
                "landlord": "Harbor Properties LLC",
                "tenant": "Chris Walker",
                "address": "14 Elm Street, Unit 3B, Portland, OR 97205",
                "rent": "$1,850 per month",
                "start": "2026-12-01",
                "end": "2027-11-30"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Lease agreement draft client and server side from freedailypro",
                  "result": {
                    "title": "Residential lease (draft)",
                    "body": "Harbor Properties LLC leases 14 Elm Street, Unit 3B, Portland, OR 97205 to Chris Walker from 2026-12-01 to 2027-11-30 for rent of $1,850 per month per period. Draft only — not legal advice."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/promissory-note-draft": {
      "post": {
        "summary": "Draft a promissory note from the borrower, lender, amount and due date",
        "operationId": "businessPromissoryNoteDraft",
        "description": "Draft a promissory note from the borrower, lender, amount and due date. Send JSON with borrower, lender, amount, due (required); optional: interestRatePct, repayment, installmentTerms, lateFee, collateral, date, governingLaw. Returns JSON with title, body (inside result). Limits: interestRatePct: at most 100; governingLaw: up to 120 characters. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "borrower": {
                    "type": "string",
                    "minLength": 1
                  },
                  "lender": {
                    "type": "string",
                    "minLength": 1
                  },
                  "amount": {
                    "type": "string",
                    "minLength": 1
                  },
                  "due": {
                    "type": "string",
                    "minLength": 1
                  },
                  "interestRatePct": {
                    "description": "Yearly simple interest in percent. 0 or leave out for no interest.",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "repayment": {
                    "type": "string",
                    "enum": [
                      "lump-sum",
                      "installments"
                    ]
                  },
                  "installmentTerms": {
                    "description": "For installments, for example \"$500 on the 1st of each month\".",
                    "type": "string"
                  },
                  "lateFee": {
                    "type": "string"
                  },
                  "collateral": {
                    "type": "string"
                  },
                  "date": {
                    "type": "string"
                  },
                  "governingLaw": {
                    "description": "Whose law governs, for example \"the State of Texas\" or \"England and Wales\". Default: the place where the property or the parties are.",
                    "type": "string",
                    "maxLength": 120
                  }
                },
                "required": [
                  "borrower",
                  "lender",
                  "amount",
                  "due"
                ],
                "additionalProperties": false
              },
              "example": {
                "borrower": "Alex Morgan",
                "lender": "Sam Rivera",
                "amount": "$5,000",
                "due": "2027-06-30"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Promissory note draft client and server side from freedailypro",
                  "result": {
                    "title": "Promissory note (draft)",
                    "body": "Alex Morgan promises to pay Sam Rivera $5,000 by 2027-06-30. Draft only — not legal advice."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/eviction-notice-draft": {
      "post": {
        "summary": "Draft a notice to vacate from the landlord, tenant, address and notice days",
        "operationId": "businessEvictionNoticeDraft",
        "description": "Draft a notice to vacate from the landlord, tenant, address and notice days. Send JSON with landlord, tenant, address, date, days (required); optional: reason, amountOwed, violation, allowCure, governingLaw. Returns JSON with title, body (inside result). Limits: governingLaw: up to 120 characters. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "landlord": {
                    "type": "string",
                    "minLength": 1
                  },
                  "tenant": {
                    "type": "string",
                    "minLength": 1
                  },
                  "address": {
                    "type": "string",
                    "minLength": 1
                  },
                  "date": {
                    "type": "string",
                    "minLength": 1
                  },
                  "days": {
                    "type": "number",
                    "minimum": 0,
                    "description": "Days the tenant has to leave (or to fix the problem)."
                  },
                  "reason": {
                    "description": "Default end-of-term.",
                    "type": "string",
                    "enum": [
                      "nonpayment",
                      "lease-violation",
                      "end-of-term",
                      "no-cause"
                    ]
                  },
                  "amountOwed": {
                    "type": "string"
                  },
                  "violation": {
                    "type": "string"
                  },
                  "allowCure": {
                    "description": "The tenant may stay by fixing the problem in time. Default true for nonpayment and lease-violation.",
                    "type": "boolean"
                  },
                  "governingLaw": {
                    "description": "Whose law governs, for example \"the State of Texas\" or \"England and Wales\". Default: the place where the property or the parties are.",
                    "type": "string",
                    "maxLength": 120
                  }
                },
                "required": [
                  "landlord",
                  "tenant",
                  "address",
                  "date",
                  "days"
                ],
                "additionalProperties": false
              },
              "example": {
                "landlord": "Harbor Properties LLC",
                "tenant": "Chris Walker",
                "address": "14 Elm Street, Unit 3B, Portland, OR 97205",
                "date": "2026-10-30",
                "days": 14
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Eviction notice draft client and server side from freedailypro",
                  "result": {
                    "title": "Notice to vacate (draft)",
                    "body": "2026-10-30: Harbor Properties LLC notifies Chris Walker to vacate 14 Elm Street, Unit 3B, Portland, OR 97205 within 14 days. Draft only — not legal advice; follow local law."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/poa-draft": {
      "post": {
        "summary": "Draft a power of attorney from the principal, agent and powers",
        "operationId": "businessPoaDraft",
        "description": "Draft a power of attorney from the principal, agent and powers. Send JSON with principal, agent, powers (required); optional: effective, durable, successorAgent, limits, governingLaw. Returns JSON with title, body (inside result). Limits: governingLaw: up to 120 characters. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "principal": {
                    "type": "string",
                    "minLength": 1
                  },
                  "agent": {
                    "type": "string",
                    "minLength": 1
                  },
                  "powers": {
                    "type": "string",
                    "minLength": 1,
                    "description": "What the agent may handle, for example \"banking, paying bills and filing taxes\"."
                  },
                  "effective": {
                    "type": "string",
                    "enum": [
                      "immediately",
                      "upon-incapacity"
                    ]
                  },
                  "durable": {
                    "description": "Continues if the principal becomes incapacitated. Default true.",
                    "type": "boolean"
                  },
                  "successorAgent": {
                    "type": "string"
                  },
                  "limits": {
                    "description": "What the agent may not do.",
                    "type": "string"
                  },
                  "governingLaw": {
                    "description": "Whose law governs, for example \"the State of Texas\" or \"England and Wales\". Default: the place where the property or the parties are.",
                    "type": "string",
                    "maxLength": 120
                  }
                },
                "required": [
                  "principal",
                  "agent",
                  "powers"
                ],
                "additionalProperties": false
              },
              "example": {
                "principal": "Maria Lopez",
                "agent": "Diego Lopez",
                "powers": "Manage bank accounts and pay bills while I am abroad"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Power of attorney draft client and server side from freedailypro",
                  "result": {
                    "title": "Power of attorney (draft)",
                    "body": "Maria Lopez appoints Diego Lopez to act for: Manage bank accounts and pay bills while I am abroad. Draft only — not legal advice."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/security/qr": {
      "post": {
        "summary": "Generate a QR code as valid SVG",
        "operationId": "securityQr",
        "description": "Encodes 'text' (any text or URL) as a QR code (error correction level M, version chosen automatically). The JSON response holds 'svg' (a complete, valid SVG with width and height of 256 px and single-quoted attributes, so it contains no escaped quotes and can be saved straight to a .svg file, with no trailing newline), 'dataUrl' (the same SVG as a data:image/svg+xml URL for an <img src>), 'width' and 'height'. Send 'format': 'svg' to get the raw image/svg+xml document as the response body instead of JSON. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Text",
          "Security & Developer Utilities"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1
                  },
                  "format": {
                    "type": "string",
                    "enum": [
                      "json",
                      "svg"
                    ]
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "https://www.freedailypro.com/developers",
                "format": "svg"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "QR code generator",
                  "result": {
                    "svg": "<svg xmlns='http://www.w3.org/2000/svg' width='256' height='256' viewBox='0 0 29 29' shape-rendering='crispEdges'>...</svg>",
                    "dataUrl": "data:image/svg+xml;charset=utf-8,%3Csvg...",
                    "width": 256,
                    "height": 256
                  }
                }
              }
            }
          },
          "400": {
            "description": "Empty text, text too long for a QR code, or an unsupported 'format'"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/emoji-unicode": {
      "post": {
        "summary": "Convert emoji to Unicode code points and back",
        "operationId": "textEmojiUnicode",
        "description": "Convert emoji to Unicode code points and back. Send JSON with operation, value (required). Returns JSON: a list. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "operation": {
                    "type": "string",
                    "enum": [
                      "toUnicode",
                      "fromUnicode"
                    ]
                  },
                  "value": {
                    "type": "string"
                  }
                },
                "required": [
                  "operation",
                  "value"
                ],
                "additionalProperties": false
              },
              "example": {
                "operation": "toUnicode",
                "value": "😀"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "description": "toUnicode: one entry per code point (nothing merged or dropped); fromUnicode: the text built from the code points",
                      "oneOf": [
                        {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "char": {
                                "type": "string",
                                "description": "The character"
                              },
                              "codePoint": {
                                "type": "number",
                                "description": "Code point as a number"
                              },
                              "hex": {
                                "type": "string",
                                "description": "U+ notation"
                              },
                              "utf16": {
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "description": "UTF-16 code unit in hex"
                                },
                                "description": "UTF-16 code units"
                              },
                              "role": {
                                "type": "string",
                                "description": "base, zwj, variation-selector, skin-tone-modifier, regional-indicator, tag, combining-mark or lone-surrogate"
                              }
                            },
                            "required": [
                              "char",
                              "codePoint",
                              "hex",
                              "utf16",
                              "role"
                            ]
                          },
                          "description": "Code points"
                        },
                        {
                          "type": "string",
                          "description": "The text"
                        }
                      ]
                    },
                    "codes": {
                      "type": "string",
                      "description": "toUnicode only: all code points as one string you can send back as fromUnicode, for example 'U+1F468 U+200D U+1F469'"
                    },
                    "codePointCount": {
                      "type": "number",
                      "description": "toUnicode only: number of code points"
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Emoji unicode converter client and server side from freedailypro",
                  "result": [
                    {
                      "char": "😀",
                      "codePoint": 128512,
                      "hex": "U+1F600"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/amortization": {
      "post": {
        "summary": "Build a loan amortization schedule with payment dates and step-by-step working",
        "operationId": "convertersAmortization",
        "description": "Build a loan amortization schedule with payment dates and step-by-step working. Send JSON with principal, annualRatePct, months (required); optional: firstPaymentDate. Returns JSON with monthlyPayment, totalPaid, totalInterest, schedule, steps, firstPaymentDate, lastPaymentDate, payoffDate (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Mortgage & Loans"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "principal": {
                    "type": "number"
                  },
                  "annualRatePct": {
                    "type": "number",
                    "minimum": 0
                  },
                  "months": {
                    "type": "number"
                  },
                  "firstPaymentDate": {
                    "description": "Optional date the first payment is due, as YYYY-MM-DD. Adds a date to every schedule row and returns firstPaymentDate, lastPaymentDate and payoffDate. It only labels the schedule; the amounts do not change. A payment day of 29 to 31 moves to the last day of shorter months.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  }
                },
                "required": [
                  "principal",
                  "annualRatePct",
                  "months"
                ],
                "additionalProperties": false
              },
              "example": {
                "principal": 20000,
                "annualRatePct": 7,
                "months": 36,
                "firstPaymentDate": "2026-12-01"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Loan amortization schedule with optional payment dates and step-by-step working client and server side from freedailypro",
                  "result": {
                    "monthlyPayment": 617.54,
                    "totalPaid": 22231.51,
                    "totalInterest": 2231.51,
                    "schedule": [
                      {
                        "month": 1,
                        "payment": 617.54,
                        "interest": 116.67,
                        "principal": 500.88,
                        "balance": 19499.12,
                        "date": "2026-12-01"
                      },
                      {
                        "month": 2,
                        "payment": 617.54,
                        "interest": 113.74,
                        "principal": 503.8,
                        "balance": 18995.33,
                        "date": "2027-01-01"
                      },
                      {
                        "month": 3,
                        "payment": 617.54,
                        "interest": 110.81,
                        "principal": 506.74,
                        "balance": 18488.59,
                        "date": "2027-02-01"
                      },
                      "..."
                    ],
                    "steps": [
                      {
                        "label": "Monthly interest rate",
                        "formula": "Annual rate / 100 / 12",
                        "inputs": {
                          "annualRatePct": 7
                        },
                        "result": 0.00583333
                      },
                      {
                        "label": "Monthly payment",
                        "formula": "Loan amount x rate / (1 - (1 + rate) ^ -payments)",
                        "inputs": {
                          "principal": 20000,
                          "monthlyRate": 0.00583333,
                          "payments": 36
                        },
                        "result": 617.54
                      },
                      {
                        "label": "Total paid",
                        "formula": "Monthly payment x number of payments",
                        "inputs": {
                          "monthlyPayment": 617.54,
                          "payments": 36
                        },
                        "result": 22231.51
                      },
                      {
                        "label": "Total interest",
                        "formula": "Total paid - loan amount",
                        "inputs": {
                          "totalPaid": 22231.51,
                          "principal": 20000
                        },
                        "result": 2231.51
                      },
                      {
                        "label": "Split of the first payment",
                        "formula": "Interest = balance x monthly rate; principal = payment - interest",
                        "inputs": {
                          "balance": 20000,
                          "monthlyRate": 0.00583333,
                          "monthlyPayment": 617.54
                        },
                        "result": "interest 116.67, principal 500.88"
                      },
                      {
                        "label": "Payoff date",
                        "formula": "The date of the last payment: the first payment date plus (number of payments - 1) months",
                        "inputs": {
                          "firstPaymentDate": "2026-12-01",
                          "payments": 36
                        },
                        "result": "2029-11"
                      }
                    ],
                    "firstPaymentDate": "2026-12-01",
                    "lastPaymentDate": "2029-11-01",
                    "payoffDate": "2029-11"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/us-income-tax": {
      "post": {
        "summary": "Estimate US federal income tax for 2026 with filing status, deductions, FICA and state tax",
        "operationId": "convertersUsIncomeTax",
        "description": "Estimates US federal income tax for tax year 2026. Send EITHER 'taxableIncome' (income after deductions) OR 'grossIncome' (before deductions). Optional 'filingStatus': single (default), married-joint, married-separate or head-of-household; each has its own 2026 brackets and standard deduction ($16,100 single, $32,200 joint, $16,100 separate, $24,150 head of household). With grossIncome you can also send 'deduction' ('standard' by default, or 'itemized' with 'itemizedDeductions'), 'preTaxDeductions' (treated like a traditional 401(k): lowers income tax, not FICA), 'selfEmployed' (self-employment tax instead of employee FICA) and 'state' (US state code or name, adds that state's 2026 income tax from the same table as /v1/converters/state-tax; for California on employee wages it also adds State Disability Insurance at 1.3% of all 2026 wages, no wage cap, shown as state.statePayrollTax and included in totalTax and takeHome; not applied when selfEmployed is true; other states' disability and paid-leave contributions are not included and a note says so). The response always includes taxYear, filingStatus, the bracket-by-bracket breakdown, marginal and effective rates, 'sources', 'dataStatus' and a 'disclaimer'; the first-version fields taxableIncome, tax and effectiveRatePct are unchanged in meaning. Where the data comes from: US federal figures are the IRS 2026 tax-year amounts from Revenue Procedure 2025-32 (brackets, standard deduction) and the SSA 2026 Social Security wage base of $184,500. Update process: all figures live in one table file that FreeDailyPro also uses for its website calculators (so the API and the website always agree) and are updated by FreeDailyPro each tax year; next review: November 2026, when the IRS and SSA publish the 2027 figures. Head of household and married-filing-separately thresholds were confirmed against published summaries of the Revenue Procedure. With selfEmployed true the response also takes the qualified business income (QBI) deduction (qbiDeduction: 20% of profit less half the self-employment tax, capped at 20% of taxable income before it; not taken above the 24%-bracket taxable-income threshold, where wage and property limits apply) and the state tax is worked on income after half the self-employment tax. Not modelled: tax credits, capital gains, AMT, net investment income tax, local taxes. Estimate, not tax advice. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Payroll & Paycheck"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "taxableIncome": {
                    "description": "Income after deductions. Send this OR grossIncome.",
                    "type": "number"
                  },
                  "grossIncome": {
                    "description": "Gross income before deductions (wages or profit). The standard or itemized deduction is applied for you, and FICA and optional state tax are added. Send this OR taxableIncome.",
                    "type": "number"
                  },
                  "filingStatus": {
                    "description": "Federal filing status. Default single.",
                    "type": "string",
                    "enum": [
                      "single",
                      "married-joint",
                      "married-separate",
                      "head-of-household"
                    ]
                  },
                  "deduction": {
                    "description": "With grossIncome. Default standard (2026 amount for the filing status).",
                    "type": "string",
                    "enum": [
                      "standard",
                      "itemized"
                    ]
                  },
                  "itemizedDeductions": {
                    "description": "With deduction 'itemized': the total of your itemized deductions.",
                    "type": "number",
                    "minimum": 0
                  },
                  "preTaxDeductions": {
                    "description": "With grossIncome: yearly pre-tax deductions such as traditional 401(k). Lowers income tax but not FICA.",
                    "type": "number",
                    "minimum": 0
                  },
                  "selfEmployed": {
                    "description": "With grossIncome: treat the income as self-employment profit (self-employment tax instead of employee FICA).",
                    "type": "boolean"
                  },
                  "state": {
                    "description": "With grossIncome: US state (two-letter code or name) to add that state's 2026 income tax.",
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "grossIncome": 100000,
                "filingStatus": "single",
                "state": "NY"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "US federal income tax estimate with 2026 brackets, filing status, deductions, FICA and state tax",
                  "result": {
                    "mode": "grossIncome",
                    "taxYear": 2026,
                    "filingStatus": "single",
                    "sources": "IRS Rev. Proc. 2025-32 and SSA 2026 wage base. Tax year 2026. FreeDailyPro table last checked 2026-10-11 (compared with the official source). Next review: November, when the IRS publishes next year's figures.",
                    "dataStatus": "checked",
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser.",
                    "grossIncome": 100000,
                    "preTaxDeductions": 0,
                    "adjustedGrossIncome": 100000,
                    "deduction": {
                      "type": "standard",
                      "amount": 16100
                    },
                    "taxableIncome": 83900,
                    "tax": 13170,
                    "federalIncomeTax": 13170,
                    "effectiveRatePct": 15.7,
                    "marginalRatePct": 22,
                    "brackets": [
                      {
                        "fromIncome": 0,
                        "toIncome": 12400,
                        "ratePct": 10,
                        "taxableAmount": 12400,
                        "tax": 1240
                      },
                      {
                        "fromIncome": 12400,
                        "toIncome": 50400,
                        "ratePct": 12,
                        "taxableAmount": 38000,
                        "tax": 4560
                      },
                      {
                        "fromIncome": 50400,
                        "toIncome": 83900,
                        "ratePct": 22,
                        "taxableAmount": 33500,
                        "tax": 7370
                      }
                    ],
                    "employeeFica": {
                      "total": 7650,
                      "socialSecurity": 6200,
                      "medicare": 1450,
                      "additionalMedicare": 0
                    },
                    "state": {
                      "code": "NY",
                      "name": "New York",
                      "kind": "progressive",
                      "stateIncomeTax": 4859.75,
                      "stateTaxableIncome": 92000,
                      "effectiveRatePct": 4.86,
                      "taxYear": "2026",
                      "rateSource": "tax.ny.gov, NYS-50-T-NYS and NYS-50-T-Y (1/26) annual rate schedule: 3.9%, 4.4%, 5.15%, 5.4%, 5.9%",
                      "officialSource": true,
                      "localTaxNote": "New York City residents also pay city income tax of about 3.1% to 3.9%.",
                      "note": null
                    },
                    "totalTax": 25679.75,
                    "effectiveTotalRatePct": 25.68,
                    "takeHome": 74320.25,
                    "notes": [
                      "Federal tax on ordinary income only (wages or business profit). Tax credits, capital gains, AMT, the net investment income tax and other adjustments are not modelled. The qualified business income deduction is taken for selfEmployed income in the simple case only.",
                      "Brackets: 2026 IRS table for single. Social Security wage base used for FICA: $184,500 (SSA 2026).",
                      "State figure from the New York schedule (tax year 2026); local income taxes are not included (New York City residents also pay city income tax of about 3.1% to 3.9%.). Itemized deductions are applied to the federal figure only.",
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Neither or both of taxableIncome and grossIncome, a negative amount, an unknown filingStatus or state, 'itemized' without itemizedDeductions, or state/deduction fields sent with taxableIncome; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/startup-names": {
      "post": {
        "summary": "Generate startup name ideas from seed words",
        "operationId": "businessStartupNames",
        "description": "Generate startup name ideas from seed words. Send JSON with seeds (required); optional: limit. Returns JSON: a list. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "seeds": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "limit": {
                    "type": "number",
                    "minimum": 0
                  }
                },
                "required": [
                  "seeds"
                ],
                "additionalProperties": false
              },
              "example": {
                "seeds": [
                  "pdf",
                  "docs",
                  "fast"
                ],
                "limit": 5
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Startup name generator client and server side from freedailypro",
                  "result": [
                    "pdfly",
                    "pdfify",
                    "pdfable",
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/planning/split-bill": {
      "post": {
        "summary": "Split a bill, with tip, between people",
        "operationId": "planningSplitBill",
        "description": "Split a bill, with tip, between people. Send JSON with total, people (required); optional: tipPct. Returns JSON with total, withTip, people, perPerson (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "total": {
                    "type": "number"
                  },
                  "people": {
                    "type": "number"
                  },
                  "tipPct": {
                    "type": "number",
                    "minimum": 0
                  }
                },
                "required": [
                  "total",
                  "people"
                ],
                "additionalProperties": false
              },
              "example": {
                "total": 142.8,
                "people": 4,
                "tipPct": 15
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Split bill calculator client and server side from freedailypro",
                  "result": {
                    "total": 142.8,
                    "withTip": 164.22,
                    "people": 4,
                    "perPerson": 41.06
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/product-description": {
      "post": {
        "summary": "Write a product description from a name, audience, benefits and features",
        "operationId": "textProductDescription",
        "description": "Writes grammatical product-description copy from the words you send plus fixed sentence templates (rule based, not an LLM, and nothing is invented: no claims, numbers or facts beyond your input). Every benefit and feature is normalised first, so any wording reads correctly, and every one of them is worked into a sentence. Recognised forms: an action ('keeps water cold', 'to keep water cold', 'keeping water cold') becomes 'It helps you keep water cold' / 'With X, you can keep water cold' / 'X keeps water cold'; a statement about the product ('doesn't rust', 'never fogs up', 'works with Alexa', 'no batteries needed', 'comes with a strap') becomes 'It doesn't rust'; a statement about the buyer ('you stay warm', 'your feet stay dry', 'so you never get lost') becomes 'With X, you stay warm'; a quality ('Lightweight', 'is breathable', \"it's quiet\", 'easy to clean', 'BPA-free', 'designed for comfort', 'made in Italy') becomes 'It is lightweight, breathable, and easy to clean'; a thing ('long battery life', '24-hour insulation', 'a 2-year warranty', 'free shipping') becomes 'Highlights include long battery life and free shipping'; 'no hidden fees' stays a short sentence of its own. Leading filler ('so', 'which', 'and', 'with', 'it', 'is', 'has', 'includes') is dropped, 'keeps water cold and lasts all day' is split into two, bullets and trailing punctuation are cleaned, lists get commas and 'and', and a plural-looking name ('Trail Boots') gets 'are' and 'they' (send plural to override). 'paragraph' is the main version and 'alternatives' holds two more built from different sentence templates; 'bullets' is one clean line per benefit and feature. Words are recognised from built-in lists, so an unusual word may be treated as a thing and listed ('Highlights include ...'), which is still grammatical. Review the text before publishing. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "description": "Product name, used as written, for example 'FrostFlask' or 'Trail Boots'. A name ending in a plural 's' ('Trail Boots') is written with 'are' and 'they'; send plural to override."
                  },
                  "audience": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "description": "Who it is for, for example 'busy commuters'. A leading 'for' is fine."
                  },
                  "benefits": {
                    "minItems": 1,
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    },
                    "description": "What the product does for the buyer, 1 to 20 short phrases in any form; every one is rewritten into a correct sentence. Examples: 'keeps water cold', 'to keep water cold', 'Lightweight', 'is breathable', 'easy to clean', 'designed for comfort', 'long battery life', 'you stay warm', 'doesn't rust', 'no batteries needed'."
                  },
                  "features": {
                    "description": "Optional specifications or details, same flexible wording as benefits, for example '24-hour insulation', 'leak-proof lid', 'comes with a strap', 'works with Alexa'.",
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  },
                  "plural": {
                    "description": "Optional. true writes 'are' and 'they' for a product name that is plural, false forces singular. Default: guessed from the name ('Trail Boots' is plural, 'FrostFlask' is not).",
                    "type": "boolean"
                  }
                },
                "required": [
                  "name",
                  "audience",
                  "benefits"
                ],
                "additionalProperties": false
              },
              "example": {
                "name": "FrostFlask",
                "audience": "hikers",
                "benefits": [
                  "keeps water cold",
                  "lightweight",
                  "you stay hydrated"
                ],
                "features": [
                  "24-hour insulation",
                  "leak-proof lid"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "title": {
                          "type": "string",
                          "description": "Product name"
                        },
                        "paragraph": {
                          "type": "string",
                          "description": "The main description"
                        },
                        "alternatives": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "description": "An alternative wording"
                          },
                          "description": "Other versions of the paragraph"
                        },
                        "bullets": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "description": "A bullet"
                          },
                          "description": "Bullet points from your benefits and features"
                        },
                        "sentences": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "description": "A sentence"
                          },
                          "description": "The sentences used, one by one"
                        }
                      },
                      "required": [
                        "title",
                        "paragraph"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Product description writer",
                  "result": {
                    "title": "FrostFlask",
                    "paragraph": "FrostFlask is built for hikers. It helps you keep water cold. It is designed for comfort. Key features include 24-hour insulation and leak-proof lid.",
                    "alternatives": [
                      "Looking for something made for hikers? Meet FrostFlask. With FrostFlask, you can keep water cold. FrostFlask is designed for comfort. Features: 24-hour insulation and leak-proof lid.",
                      "FrostFlask was designed with hikers in mind. FrostFlask keeps water cold. Expect a product that is designed for comfort. Notable features: 24-hour insulation and leak-proof lid."
                    ],
                    "bullets": [
                      "Keeps water cold",
                      "Designed for comfort",
                      "24-hour insulation",
                      "..."
                    ],
                    "sentences": [
                      "FrostFlask is built for hikers.",
                      "It helps you keep water cold.",
                      "It is designed for comfort.",
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing name, audience or benefits (at least one non-empty benefit is needed), or a field of the wrong type or length; the body names the field"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/user-manual": {
      "post": {
        "summary": "Draft a user manual outline from a product name and its tasks",
        "operationId": "textUserManual",
        "description": "Draft a user manual outline from a product name and its tasks. Send JSON with product, tasks (required). Returns JSON with title, sections (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "product": {
                    "type": "string",
                    "minLength": 1
                  },
                  "tasks": {
                    "minItems": 1,
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "required": [
                  "product",
                  "tasks"
                ],
                "additionalProperties": false
              },
              "example": {
                "product": "Aroma Brew coffee maker",
                "tasks": [
                  "Fill the water tank",
                  "Brew a pot",
                  "Clean the filter"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "title": {
                          "type": "string",
                          "description": "Manual title"
                        },
                        "sections": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "description": "Section heading"
                          },
                          "description": "Outline of the manual"
                        }
                      },
                      "required": [
                        "title",
                        "sections"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "User manual writer client and server side from freedailypro",
                  "result": {
                    "title": "Aroma Brew coffee maker user manual (outline)",
                    "sections": [
                      "Introduction",
                      "Setup",
                      "How to Fill the water tank",
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/invention-disclosure": {
      "post": {
        "summary": "Build an invention disclosure worksheet from the problem and solution",
        "operationId": "businessInventionDisclosure",
        "description": "Build an invention disclosure worksheet from the problem and solution. Send JSON with title, inventor, problem, solution (required); optional: date. Returns JSON with title, inventor, date, problem, solution, sections, disclaimer (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "minLength": 1
                  },
                  "inventor": {
                    "type": "string",
                    "minLength": 1
                  },
                  "problem": {
                    "type": "string",
                    "minLength": 1
                  },
                  "solution": {
                    "type": "string",
                    "minLength": 1
                  },
                  "date": {
                    "type": "string"
                  }
                },
                "required": [
                  "title",
                  "inventor",
                  "problem",
                  "solution"
                ],
                "additionalProperties": false
              },
              "example": {
                "title": "Self-adjusting bike seat",
                "inventor": "Jamie Park",
                "problem": "Seat height needs manual adjustment for each rider.",
                "solution": "A spring-and-sensor mechanism that sets the height from rider weight.",
                "date": "2026-10-30"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Invention disclosure worksheet client and server side from freedailypro",
                  "result": {
                    "title": "Self-adjusting bike seat",
                    "inventor": "Jamie Park",
                    "date": "2026-10-30",
                    "problem": "Seat height needs manual adjustment for each rider.",
                    "solution": "A spring-and-sensor mechanism that sets the height from rider weight.",
                    "sections": [
                      "Background",
                      "Description",
                      "Advantages",
                      "..."
                    ],
                    "disclaimer": "Worksheet only — not a patent filing."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/contract-pack": {
      "post": {
        "summary": "Return the clause outline for a services, NDA, employment or sale contract",
        "operationId": "businessContractPack",
        "description": "Return the clause outline for a services, NDA, employment or sale contract. Send JSON with type (required). Returns JSON with type, clauses, disclaimer (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "enum": [
                      "services",
                      "nda",
                      "employment",
                      "sale"
                    ]
                  }
                },
                "required": [
                  "type"
                ],
                "additionalProperties": false
              },
              "example": {
                "type": "services"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Contract templates client and server side from freedailypro",
                  "result": {
                    "type": "services",
                    "clauses": [
                      "Parties",
                      "Effective date",
                      "Governing law",
                      "..."
                    ],
                    "disclaimer": "Outline only — not legal advice."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/receipt": {
      "post": {
        "summary": "Build a receipt from line items and a tax rate, with subtotal, tax and total",
        "operationId": "businessReceipt",
        "description": "Build a receipt from line items and a tax rate, with subtotal, tax and total. Send JSON with merchant, lines (required); optional: taxPct, date. Returns JSON with merchant, date, lines, subtotal, tax, total (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "merchant": {
                    "type": "string",
                    "minLength": 1
                  },
                  "lines": {
                    "minItems": 1,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "qty": {
                          "type": "number"
                        },
                        "unitPrice": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "name",
                        "qty",
                        "unitPrice"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "taxPct": {
                    "type": "number",
                    "minimum": 0
                  },
                  "date": {
                    "type": "string"
                  }
                },
                "required": [
                  "merchant",
                  "lines"
                ],
                "additionalProperties": false
              },
              "example": {
                "merchant": "Harbor Coffee Co.",
                "lines": [
                  {
                    "name": "Latte",
                    "qty": 2,
                    "unitPrice": 4.5
                  },
                  {
                    "name": "Croissant",
                    "qty": 1,
                    "unitPrice": 3.25
                  }
                ],
                "taxPct": 8.25,
                "date": "2026-10-20"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Receipt maker client and server side from freedailypro",
                  "result": {
                    "merchant": "Harbor Coffee Co.",
                    "date": "2026-10-20",
                    "lines": [
                      {
                        "name": "Latte",
                        "qty": 2,
                        "unitPrice": 4.5
                      },
                      {
                        "name": "Croissant",
                        "qty": 1,
                        "unitPrice": 3.25
                      }
                    ],
                    "subtotal": 12.25,
                    "tax": 1.01,
                    "total": 13.26
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/invitation-copy": {
      "post": {
        "summary": "Write invitation wording that fits the event: right article, event type, date, time and place phrasing, in four tones",
        "operationId": "textInvitationCopy",
        "description": "Writes an invitation headline and body from the event, host, when and where (rule based, not an LLM, deterministic: the same input always gives the same text, and nothing is invented: no dress code, RSVP date, price or programme). The event gets the right article ('the Annual Product Launch', 'a birthday party', none for \"Sarah's 30th Birthday\"); the event type is detected from its words (launch, wedding, webinar, birthday, conference, anniversary, graduation, workshop, meetup, opening, meal, party, fundraiser, baby shower) or set with eventType, and picks the verb ('to celebrate', 'to join us for') and the closing line; 'Friday 10 AM' becomes 'on Friday at 10 AM', '5-8pm' becomes 'from 5 to 8pm', 'Hall 3, Pune' becomes 'at Hall 3, Pune', 'Pune' becomes 'in Pune', 'Zoom' becomes 'on Zoom' and 'online' stays 'online'. 'tone' is formal ('cordially invites', polite closing), friendly (the default: warm and plain), playful ('Save the date', lighter closing) or minimal (the facts as short lines, no closing). The response also returns the tone and eventType used, and eventTypeDetected (false when you sent eventType). Limits: English only; two hosts are recognised by 'and', '&' or a comma; a place with one or two words and no venue word ('Pune', 'New York') is taken for a city; start the place with at/in/on to use your own preposition. Review the text before sending. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "event": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "description": "The event name as you would say it, for example 'Annual Product Launch', 'Priya and Dev's Wedding', 'Intro to Budgeting webinar' or 'birthday party'. The right article is added ('the Annual Product Launch', 'a birthday party') and the event type (launch, wedding, webinar, birthday, conference, ...) is detected from these words."
                  },
                  "host": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "description": "Who is inviting, for example 'Acme Corp' or 'Priya and Dev'. Two hosts joined by 'and' or '&' get 'invite', one gets 'invites'."
                  },
                  "when": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 120,
                    "description": "Date and time in your own words, for example 'Friday 10 AM', 'Saturday, 14 November 2026, 12:00' or '5-8pm tomorrow'. 'on' and 'at' are added where needed and nothing is reformatted or invented."
                  },
                  "where": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "description": "The place, for example 'Hall 3, Pune' (becomes 'at Hall 3, Pune'), 'Pune' ('in Pune'), 'Zoom' ('on Zoom') or 'online'. Start with at/in/on yourself to use your own wording."
                  },
                  "tone": {
                    "description": "formal, friendly (the default), playful or minimal. formal: 'cordially invite', a polite closing; friendly: warm and plain; playful: 'Save the date', lighter closing; minimal: just the facts as short lines.",
                    "type": "string",
                    "enum": [
                      "formal",
                      "friendly",
                      "playful",
                      "minimal"
                    ]
                  },
                  "eventType": {
                    "description": "Optional. Force the event type instead of detecting it from the event name: launch, wedding, webinar, birthday, conference, anniversary, graduation, workshop, meetup, opening, meal, party, fundraiser, baby-shower or other. It changes the verb ('to celebrate', 'to join us for') and the closing line.",
                    "type": "string",
                    "enum": [
                      "launch",
                      "wedding",
                      "webinar",
                      "birthday",
                      "conference",
                      "anniversary",
                      "graduation",
                      "workshop",
                      "meetup",
                      "opening",
                      "meal",
                      "party",
                      "fundraiser",
                      "baby-shower",
                      "other"
                    ]
                  }
                },
                "required": [
                  "event",
                  "host",
                  "when",
                  "where"
                ],
                "additionalProperties": false
              },
              "example": {
                "event": "Annual Product Launch",
                "host": "Acme Corp",
                "when": "Friday 10 AM",
                "where": "Hall 3, Pune",
                "tone": "friendly"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "headline": {
                          "type": "string",
                          "description": "Invitation headline"
                        },
                        "body": {
                          "type": "string",
                          "description": "Invitation text: who invites you to what, where and when, plus a closing line (none for the minimal tone)"
                        },
                        "tone": {
                          "type": "string",
                          "description": "The tone used: formal, friendly, playful or minimal"
                        },
                        "eventType": {
                          "type": "string",
                          "description": "The event type used: launch, wedding, webinar, birthday, conference, anniversary, graduation, workshop, meetup, opening, meal, party, fundraiser, baby-shower or other"
                        },
                        "eventTypeDetected": {
                          "type": "boolean",
                          "description": "true when eventType was detected from the event name, false when you sent it"
                        }
                      },
                      "required": [
                        "headline",
                        "body"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Invitation copy client and server side from freedailypro",
                  "result": {
                    "headline": "You're invited: Annual team picnic",
                    "body": "The FreeDailyPro team invites you to Annual team picnic on Saturday, 14 November 2026, 12:00 at Riverside Park, Pavilion 2."
                  }
                }
              }
            }
          },
          "400": {
            "description": "A missing or empty event, host, when or where, a tone or eventType that is not in the list, or an unknown field; the body names the field"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/menu-outline": {
      "post": {
        "summary": "Turn menu sections and dish names into an ordered menu with a short description per item",
        "operationId": "textMenuOutline",
        "description": "Takes a venue and sections of dishes and returns a menu outline: sections in the usual menu order (breakfast, starters, soups and salads, mains, sides, desserts, drinks; sections it does not recognise keep their relative order among the mains; set keepOrder: true to keep your own order), a heading with the item count per section, and one entry per item with name (Title Case), description and optional price. An item can be a plain string or {name, description, price}. A plain string may carry its own description ('Margherita pizza with basil', 'Soup (tomato, basil)', 'Soup - tomato and basil', 'Bruschetta, tomato, basil, olive oil') or a trailing price ('Burger $12'); those words are used exactly as given (descriptionSource: input). An item with no description of its own gets one short generic line such as 'Ask your server about the pad thai.' (descriptionSource: template). Prices appear only when you send them. Rule based, not an AI model: ingredients, prices, dietary claims and flavours are never invented, so add them to the item for richer descriptions. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "venue": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 120,
                    "description": "Restaurant or cafe name."
                  },
                  "sections": {
                    "minItems": 1,
                    "maxItems": 30,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 80,
                          "description": "Section name, for example Starters, Mains, Desserts, Drinks."
                        },
                        "items": {
                          "minItems": 1,
                          "maxItems": 100,
                          "type": "array",
                          "items": {
                            "anyOf": [
                              {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 200
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "name": {
                                    "type": "string",
                                    "minLength": 1,
                                    "maxLength": 200
                                  },
                                  "description": {
                                    "type": "string",
                                    "maxLength": 300
                                  },
                                  "price": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 30
                                      },
                                      {
                                        "type": "number"
                                      }
                                    ]
                                  }
                                },
                                "required": [
                                  "name"
                                ],
                                "additionalProperties": false
                              }
                            ]
                          },
                          "description": "Dish names, or {name, description, price}. A plain string may carry its own description ('Margherita pizza with basil', 'Soup (tomato, basil)', 'Soup - tomato and basil') or a trailing price ('Burger $12'); those words are used as given."
                        }
                      },
                      "required": [
                        "name",
                        "items"
                      ],
                      "additionalProperties": false
                    },
                    "description": "Menu sections."
                  },
                  "keepOrder": {
                    "description": "true keeps your section order. Default false: sections are put in the usual menu order (breakfast, starters, soups and salads, mains, sides, desserts, drinks).",
                    "type": "boolean"
                  }
                },
                "required": [
                  "venue",
                  "sections"
                ],
                "additionalProperties": false
              },
              "example": {
                "venue": "Harbor Cafe",
                "sections": [
                  {
                    "name": "Drinks",
                    "items": [
                      "Latte $4.50",
                      "Iced tea"
                    ]
                  },
                  {
                    "name": "Starters",
                    "items": [
                      "Tomato soup (basil, cream)",
                      "Garlic bread - toasted, with butter"
                    ]
                  },
                  {
                    "name": "Mains",
                    "items": [
                      {
                        "name": "Margherita pizza",
                        "price": 12
                      },
                      "Veggie burger with fries"
                    ]
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "venue": {
                          "type": "string",
                          "description": "Venue name"
                        },
                        "title": {
                          "type": "string",
                          "description": "Menu title"
                        },
                        "sections": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "description": "Section name"
                              },
                              "heading": {
                                "type": "string",
                                "description": "Section heading with the item count"
                              },
                              "items": {
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "description": "Item name"
                                },
                                "description": "Item names"
                              },
                              "entries": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "name": {
                                      "type": "string",
                                      "description": "Item name"
                                    },
                                    "description": {
                                      "type": "string",
                                      "description": "Description"
                                    },
                                    "price": {
                                      "type": "string",
                                      "description": "Price, when one was sent"
                                    },
                                    "descriptionSource": {
                                      "type": "string",
                                      "description": "input (your words) or template"
                                    }
                                  },
                                  "required": [
                                    "name",
                                    "description",
                                    "descriptionSource"
                                  ]
                                },
                                "description": "Items with descriptions"
                              }
                            },
                            "required": [
                              "name",
                              "heading",
                              "items",
                              "entries"
                            ]
                          }
                        },
                        "sectionOrder": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "description": "Section name"
                          },
                          "description": "Sections in the order used"
                        },
                        "orderChanged": {
                          "type": "boolean",
                          "description": "Whether the sections were reordered into menu order"
                        },
                        "notes": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "description": "A note"
                          },
                          "description": "Things to know"
                        }
                      },
                      "required": [
                        "venue",
                        "title",
                        "sections"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Menu card outline",
                  "result": {
                    "venue": "Harbor Cafe",
                    "title": "Harbor Cafe Menu",
                    "sections": [
                      {
                        "name": "Starters",
                        "heading": "Starters (2)",
                        "items": [
                          "Tomato Soup",
                          "Garlic Bread"
                        ],
                        "entries": [
                          {
                            "name": "Tomato Soup",
                            "description": "Basil, cream.",
                            "descriptionSource": "input"
                          },
                          {
                            "name": "Garlic Bread",
                            "description": "Toasted, with butter.",
                            "descriptionSource": "input"
                          }
                        ]
                      },
                      {
                        "name": "Mains",
                        "heading": "Mains (2)",
                        "items": [
                          "Margherita Pizza",
                          "Veggie Burger"
                        ],
                        "entries": [
                          {
                            "name": "Margherita Pizza",
                            "description": "Ask your server about the margherita pizza.",
                            "price": "12",
                            "descriptionSource": "template"
                          },
                          {
                            "name": "Veggie Burger",
                            "description": "With fries.",
                            "descriptionSource": "input"
                          }
                        ]
                      },
                      {
                        "name": "Drinks",
                        "heading": "Drinks (2)",
                        "items": [
                          "Latte",
                          "Iced Tea"
                        ],
                        "entries": [
                          {
                            "name": "Latte",
                            "description": "Try the latte.",
                            "price": "$4.50",
                            "descriptionSource": "template"
                          },
                          {
                            "name": "Iced Tea",
                            "description": "Ask your server about the iced tea.",
                            "descriptionSource": "template"
                          }
                        ]
                      }
                    ],
                    "sectionOrder": [
                      "Starters",
                      "Mains",
                      "Drinks"
                    ],
                    "orderChanged": true,
                    "notes": [
                      "Sections were put in the usual menu order (breakfast, starters, soups and salads, mains, sides, desserts, drinks); sections not recognised keep their relative order among the mains. Send keepOrder: true to keep your own order.",
                      "Items without a description of their own get a short generic line (descriptionSource: template). Ingredients, prices and claims are never invented: add them in the item's description and price."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing venue, no sections, a section without a name or items, or an empty item; the body names the field"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/flyer-outline": {
      "post": {
        "summary": "Build a flyer outline (headline, intro, details, offer, audience, CTA, contact) from your inputs",
        "operationId": "textFlyerOutline",
        "description": "Returns seven flyer sections in print order: headline, intro, details, offer, audience, cta and contact, each with ready-to-use copy and a 'source' (input = your words, template = a fixed generic sentence such as 'This one is for new students.', placeholder = something you did not provide). Required: offer, audience, cta. Optional: title (replaces the offer as the headline), details (bullet points), date, time, location and contact; they are used exactly as given. If no details, date or location are given the details section is a placeholder, and the same for contact, so nothing is ever invented: no prices, dates, terms or claims. Rule based, not an AI model: it organises and re-cases your words and adds a few generic template sentences, so write the offer and details as you want them to read. The legacy fields 'headline', 'sub' and 'cta' are still returned. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "offer": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "description": "What is offered, for example 'First lesson half price'."
                  },
                  "audience": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 120,
                    "description": "Who it is for, for example 'new students'."
                  },
                  "cta": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 80,
                    "description": "The action you want, for example 'Book your spot'."
                  },
                  "title": {
                    "description": "Optional headline. Default: the offer.",
                    "type": "string",
                    "maxLength": 120
                  },
                  "details": {
                    "description": "Optional bullet points, used as given.",
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 200
                    }
                  },
                  "date": {
                    "description": "Optional date, used as given.",
                    "type": "string",
                    "maxLength": 60
                  },
                  "time": {
                    "description": "Optional time, used as given.",
                    "type": "string",
                    "maxLength": 60
                  },
                  "location": {
                    "description": "Optional place, used as given.",
                    "type": "string",
                    "maxLength": 160
                  },
                  "contact": {
                    "description": "Optional phone, email or website, used as given.",
                    "type": "string",
                    "maxLength": 160
                  }
                },
                "required": [
                  "offer",
                  "audience",
                  "cta"
                ],
                "additionalProperties": false
              },
              "example": {
                "offer": "First lesson half price",
                "audience": "new students",
                "cta": "Book your spot",
                "details": [
                  "small groups",
                  "all levels welcome"
                ],
                "date": "Nov 12",
                "time": "6 pm",
                "location": "14 Elm Street",
                "contact": "hello@example.com"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "headline": {
                          "type": "string",
                          "description": "Flyer headline"
                        },
                        "sub": {
                          "type": "string",
                          "description": "Sub-headline"
                        },
                        "cta": {
                          "type": "string",
                          "description": "Call to action"
                        },
                        "sections": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "section": {
                                "type": "string",
                                "description": "Section name"
                              },
                              "copy": {
                                "type": "string",
                                "description": "The copy"
                              },
                              "items": {
                                "type": "array",
                                "items": {
                                  "type": "string",
                                  "description": "An item"
                                },
                                "description": "List items, when the section is a list"
                              },
                              "source": {
                                "type": "string",
                                "description": "input (your words) or template"
                              }
                            },
                            "required": [
                              "section",
                              "copy",
                              "source"
                            ]
                          },
                          "description": "Flyer sections in order"
                        },
                        "notes": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "description": "A note"
                          },
                          "description": "Things to know"
                        }
                      },
                      "required": [
                        "headline",
                        "cta",
                        "sections"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Brochure flyer outline",
                  "result": {
                    "headline": "First Lesson Half Price",
                    "sub": "For new students",
                    "cta": "Book your spot",
                    "sections": [
                      {
                        "section": "headline",
                        "copy": "First Lesson Half Price",
                        "source": "input"
                      },
                      {
                        "section": "intro",
                        "copy": "First lesson half price. This one is for new students.",
                        "source": "template"
                      },
                      {
                        "section": "details",
                        "copy": "Small groups; All levels welcome; When: Nov 12 at 6 pm; Where: 14 Elm Street.",
                        "items": [
                          "Small groups",
                          "All levels welcome",
                          "When: Nov 12 at 6 pm",
                          "..."
                        ],
                        "source": "input"
                      },
                      "..."
                    ],
                    "notes": [
                      "No prices, dates or terms are added for you: only the words you supplied appear."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing offer, audience or cta (or one without any letters); the body names the field"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/banner-copy": {
      "post": {
        "summary": "Turn a message into banner headline, subheadline and CTA variants",
        "operationId": "textBannerCopy",
        "description": "Builds banner copy from the words you send. 'headlines' has four variants of the headline (sentence case, Title Case, UPPERCASE and sentence case with an exclamation mark), each with its character count, word count and whether it is within 'maxHeadlineChars' (default 40). A message longer than one banner line is split: the first clause (or first 7 words) becomes the headline and the rest becomes the first 'subheadlines' entry (source: input); every response also lists three short generic lines (source: template: 'Details inside.', 'Ask us for details.', 'Find out more.'). 'ctas' has four variants of your 'cta' (default 'Learn more' when none is given) with trailing punctuation removed, an arrow variant, and a length limit 'maxCtaChars' (default 25) that shortens a call to action that is too long. 'notes' explains any shortening or defaulting. Rule based: it rearranges and re-cases your words and adds the generic lines above. It does not write new selling points, so the copy is only as good as the message you send. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "message": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 300,
                    "description": "What the banner should say, for example 'Grand opening this Saturday'. A long message is split into a headline and a subheadline."
                  },
                  "cta": {
                    "description": "Optional call to action, for example 'Visit us today'. Default: Learn more.",
                    "type": "string",
                    "maxLength": 80
                  },
                  "maxHeadlineChars": {
                    "description": "Headline length limit in characters (default 40).",
                    "type": "integer",
                    "minimum": 10,
                    "maximum": 200
                  },
                  "maxCtaChars": {
                    "description": "Call to action length limit in characters (default 25).",
                    "type": "integer",
                    "minimum": 5,
                    "maximum": 60
                  }
                },
                "required": [
                  "message"
                ],
                "additionalProperties": false
              },
              "example": {
                "message": "Grand opening this Saturday",
                "cta": "Visit us today"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "message": {
                          "type": "string",
                          "description": "Your message"
                        },
                        "cta": {
                          "type": "string",
                          "description": "Your call to action"
                        },
                        "headlines": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "style": {
                                "type": "string",
                                "description": "Name of the variant"
                              },
                              "text": {
                                "type": "string",
                                "description": "The copy"
                              },
                              "chars": {
                                "type": "number",
                                "description": "Characters"
                              },
                              "words": {
                                "type": "number",
                                "description": "Words"
                              },
                              "withinLimit": {
                                "type": "boolean",
                                "description": "Fits the limit for this kind of line"
                              }
                            },
                            "required": [
                              "style",
                              "text",
                              "chars",
                              "words",
                              "withinLimit"
                            ]
                          },
                          "description": "Headline variants"
                        },
                        "subheadlines": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "style": {
                                "type": "string",
                                "description": "Name of the variant"
                              },
                              "text": {
                                "type": "string",
                                "description": "The copy"
                              },
                              "chars": {
                                "type": "number",
                                "description": "Characters"
                              },
                              "words": {
                                "type": "number",
                                "description": "Words"
                              },
                              "withinLimit": {
                                "type": "boolean",
                                "description": "Fits the limit for this kind of line"
                              },
                              "source": {
                                "type": "string",
                                "description": "input or template"
                              }
                            },
                            "required": [
                              "style",
                              "text",
                              "chars",
                              "words",
                              "withinLimit"
                            ]
                          },
                          "description": "Sub-headline variants"
                        },
                        "ctas": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "style": {
                                "type": "string",
                                "description": "Name of the variant"
                              },
                              "text": {
                                "type": "string",
                                "description": "The copy"
                              },
                              "chars": {
                                "type": "number",
                                "description": "Characters"
                              },
                              "words": {
                                "type": "number",
                                "description": "Words"
                              },
                              "withinLimit": {
                                "type": "boolean",
                                "description": "Fits the limit for this kind of line"
                              }
                            },
                            "required": [
                              "style",
                              "text",
                              "chars",
                              "words",
                              "withinLimit"
                            ]
                          },
                          "description": "Call-to-action variants"
                        },
                        "limits": {
                          "type": "object",
                          "properties": {
                            "headlineChars": {
                              "type": "number",
                              "description": "Headline limit"
                            },
                            "ctaChars": {
                              "type": "number",
                              "description": "Call-to-action limit"
                            }
                          },
                          "required": [
                            "headlineChars",
                            "ctaChars"
                          ]
                        },
                        "notes": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "description": "A note"
                          },
                          "description": "Things to know"
                        }
                      },
                      "required": [
                        "message",
                        "headlines",
                        "subheadlines",
                        "ctas",
                        "limits"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Banner sign copy",
                  "result": {
                    "message": "Grand opening this Saturday",
                    "cta": "Visit us today",
                    "headlines": [
                      {
                        "style": "sentence case",
                        "text": "Grand opening this Saturday",
                        "chars": 27,
                        "words": 4,
                        "withinLimit": true
                      },
                      {
                        "style": "title case",
                        "text": "Grand Opening This Saturday",
                        "chars": 27,
                        "words": 4,
                        "withinLimit": true
                      },
                      {
                        "style": "uppercase",
                        "text": "GRAND OPENING THIS SATURDAY",
                        "chars": 27,
                        "words": 4,
                        "withinLimit": true
                      },
                      "..."
                    ],
                    "subheadlines": [
                      {
                        "style": "generic line",
                        "text": "Details inside.",
                        "chars": 15,
                        "words": 2,
                        "withinLimit": true,
                        "source": "template"
                      },
                      {
                        "style": "generic line",
                        "text": "Ask us for details.",
                        "chars": 19,
                        "words": 4,
                        "withinLimit": true,
                        "source": "template"
                      },
                      {
                        "style": "generic line",
                        "text": "Find out more.",
                        "chars": 14,
                        "words": 3,
                        "withinLimit": true,
                        "source": "template"
                      }
                    ],
                    "ctas": [
                      {
                        "style": "sentence case",
                        "text": "Visit us today",
                        "chars": 14,
                        "words": 3,
                        "withinLimit": true
                      },
                      {
                        "style": "title case",
                        "text": "Visit Us Today",
                        "chars": 14,
                        "words": 3,
                        "withinLimit": true
                      },
                      {
                        "style": "uppercase",
                        "text": "VISIT US TODAY",
                        "chars": 14,
                        "words": 3,
                        "withinLimit": true
                      },
                      "..."
                    ],
                    "limits": {
                      "headlineChars": 40,
                      "ctaChars": 25
                    },
                    "notes": []
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or empty message, a message without any letters or digits, or a limit out of range"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/planning/travel-countdown": {
      "post": {
        "summary": "Count down to a trip departure and return a packing list for the climate",
        "operationId": "planningTravelCountdown",
        "description": "Count down to a trip departure and return a packing list for the climate. Send JSON with departIso, nights, climate (required). Returns JSON with countdown, packing (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "departIso": {
                    "type": "string"
                  },
                  "nights": {
                    "type": "number",
                    "minimum": 0
                  },
                  "climate": {
                    "type": "string",
                    "enum": [
                      "hot",
                      "mild",
                      "cold"
                    ]
                  }
                },
                "required": [
                  "departIso",
                  "nights",
                  "climate"
                ],
                "additionalProperties": false
              },
              "example": {
                "departIso": "2026-12-20",
                "nights": 7,
                "climate": "mild"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Travel countdown planner client and server side from freedailypro",
                  "result": {
                    "countdown": {
                      "past": false,
                      "days": 50,
                      "hours": 9,
                      "minutes": 19,
                      "seconds": 23,
                      "totalMs": 4353563811,
                      "label": "50d 9h 19m"
                    },
                    "packing": {
                      "nights": 7,
                      "climate": "mild",
                      "items": [
                        "8 tops",
                        "5 bottoms",
                        "7 underwear",
                        "..."
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/ascii-art": {
      "post": {
        "summary": "Turn text into ASCII art (block letters)",
        "operationId": "textAsciiArt",
        "description": "Draws text as large block letters using a font built into the API (no network, no AI). Fonts: 'banner' (default, 5 rows, one character per pixel), 'wide' (the same letters twice as wide) and 'box' (one line of plain text inside a box). 'fill' sets the drawing character (default #). Several lines: separate them with \\n (up to 6 lines, 20 characters each); each line becomes its own block of art. Lowercase letters are drawn as capitals. Supported characters: letters, digits, space and . , ! ? - _ : ; ' \" + = / \\ ( ) @ # & * < >. Non-ASCII input (emoji, accented or non-Latin letters) is NOT transliterated or dropped: it returns 400 with a plain message that names the characters, so you decide what to replace them with. The art is returned as one string with \\n line breaks; use a monospaced font to display it. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 400,
                    "description": "Text to draw. banner and wide: letters A-Z (lowercase is drawn as capitals), digits, space and . , ! ? - _ : ; ' \" + = / \\ ( ) @ # & * < >; accented Latin letters are drawn as the plain letter and listed in 'notes'; emoji and other scripts return 400 (use font box for those). Up to 6 lines of 20 characters, separated by \\n. box: any text, emoji and every language included, up to 6 lines of 60 columns, kept in one box."
                  },
                  "font": {
                    "description": "banner (default): 5-row block letters. wide: the same letters twice as wide. box: your text as typed (any language or emoji, several lines) inside one box.",
                    "type": "string",
                    "enum": [
                      "banner",
                      "wide",
                      "box"
                    ]
                  },
                  "fill": {
                    "description": "Optional single visible ASCII character used to draw the letters (default #).",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Hello",
                "font": "banner"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "font": {
                      "type": "string",
                      "description": "banner, wide or box"
                    },
                    "fill": {
                      "type": "string",
                      "description": "Fill character"
                    },
                    "lines": {
                      "type": "number",
                      "description": "Lines of text drawn"
                    },
                    "widthColumns": {
                      "type": "number",
                      "description": "Width in columns"
                    },
                    "notes": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "description": "A note"
                      },
                      "description": "Letters that were replaced, for example accented letters"
                    },
                    "result": {
                      "type": "string",
                      "description": "The drawing, rows separated by newlines"
                    }
                  },
                  "required": [
                    "result",
                    "font",
                    "fill",
                    "lines",
                    "widthColumns",
                    "notes"
                  ]
                },
                "example": {
                  "tool": "ASCII art generator",
                  "result": "#   # ##### #     #      ###\n#   # #     #     #     #   #\n##### ####  #     #     #   #\n#   # #     #     #     #   #\n#   # ##### ##### #####  ###",
                  "font": "banner",
                  "fill": "#",
                  "lines": 1,
                  "widthColumns": 29,
                  "notes": []
                }
              }
            }
          },
          "400": {
            "description": "Empty text, too many lines or characters, an unsupported character (emoji and non-ASCII are named in the message), or a bad font/fill"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/diff": {
      "post": {
        "summary": "Compare two texts line by line and return the added, removed and unchanged lines",
        "operationId": "textDiff",
        "description": "Compare two texts line by line and return the added, removed and unchanged lines. Send JSON with a, b (required). Returns JSON with lines, added, removed, equal, changes, identical (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "a": {
                    "type": "string",
                    "description": "Original text."
                  },
                  "b": {
                    "type": "string",
                    "description": "Changed text."
                  }
                },
                "required": [
                  "a",
                  "b"
                ],
                "additionalProperties": false
              },
              "example": {
                "a": "one\ntwo\nthree",
                "b": "one\n2\nthree\nfour"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "lines": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "type": {
                                "type": "string",
                                "description": "equal, add or remove"
                              },
                              "line": {
                                "type": "string",
                                "description": "The line"
                              },
                              "lineNumberA": {
                                "type": "number",
                                "description": "Line number in a (not for add)"
                              },
                              "lineNumberB": {
                                "type": "number",
                                "description": "Line number in b (not for remove)"
                              }
                            },
                            "required": [
                              "type",
                              "line"
                            ]
                          },
                          "description": "Line-by-line difference"
                        },
                        "added": {
                          "type": "number",
                          "description": "Lines added"
                        },
                        "removed": {
                          "type": "number",
                          "description": "Lines removed"
                        },
                        "equal": {
                          "type": "number",
                          "description": "Lines unchanged"
                        },
                        "changes": {
                          "type": "number",
                          "description": "Added plus removed"
                        },
                        "identical": {
                          "type": "boolean",
                          "description": "True when a and b are the same"
                        }
                      },
                      "required": [
                        "lines",
                        "added",
                        "removed",
                        "equal",
                        "changes",
                        "identical"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Diff checker client and server side from freedailypro",
                  "result": {
                    "lines": [
                      {
                        "type": "equal",
                        "line": "one",
                        "lineNumberA": 1,
                        "lineNumberB": 1
                      },
                      {
                        "type": "remove",
                        "line": "two",
                        "lineNumberA": 2
                      },
                      {
                        "type": "add",
                        "line": "2",
                        "lineNumberB": 2
                      },
                      "..."
                    ],
                    "added": 2,
                    "removed": 1,
                    "equal": 2,
                    "changes": 3,
                    "identical": false
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/india-income-tax": {
      "post": {
        "summary": "Calculate India income tax for FY 2026-27 under the old or new regime",
        "operationId": "convertersIndiaIncomeTax",
        "description": "Send annual salary or pension income as 'income' (rupees). Both regimes are always calculated and returned in 'regimes' (old and new), with 'lowerTaxRegime' and the saving. New regime (section 115BAC): slabs 0% to ₹4 lakh, then 5%, 10%, 15%, 20%, 25% and 30% above ₹24 lakh; ₹75,000 standard deduction; section 87A rebate up to ₹60,000 (no tax up to ₹12 lakh taxable income, with marginal relief just above); surcharge capped at 25%. Old regime: age-based slabs ('age' below60, 60to80, above80), ₹50,000 standard deduction, deductions you send in 'deductions' (80C, 80D, HRA and so on, one total), 87A rebate up to ₹12,500 for income up to ₹5 lakh, surcharge up to 37%. Employer NPS (80CCD(2)) is capped at 14% of salary (new) or 10% (old). Health and education cess is 4% on both. 'otherIncome' is taxed without a standard deduction. The top-level 'tax' and 'effectiveRatePct' follow the 'regime' field (default old, as in the first version of this endpoint). Where the data comes from: Income Tax Department of India (slabs, rebate, surcharge rates) and Union Budget 2026 coverage, FY 2026-27 (AY 2027-28); slabs, standard deduction, rebate, surcharge and cess were compared with the department's surcharge page and published FY 2026-27 slab tables on 30 Oct 2026. Update process: one table file shared with the website, updated by FreeDailyPro every February after the Union Budget. Not modelled: capital gains and special-rate income, HUF, NRIs' special rules. Estimate, not tax advice. HRA and itemised deductions (B-0134): instead of the single 'deductions' total you can send 'itemised' (not both): { hra: { basicPlusDa, hraReceived, rentPaid, metro }, section80C, health80D: { self, selfSenior, parents, parentsSenior }, homeLoanInterest, nps80CCD1B, other }. The HRA exemption is the least of HRA received, rent paid less 10% of basic + DA, and 50% of basic + DA in a metro (40% elsewhere); the metro list under the Income-tax Rules 2026 is Delhi, Mumbai, Chennai, Kolkata, Bengaluru, Pune, Hyderabad and Ahmedabad (as reported by ClearTax and Moneylife, not read from the official text). Caps: 80C 1,50,000; 80CCD(1B) 50,000; 80D 25,000 for self and family and 25,000 for parents, each 50,000 for a senior citizen; home-loan interest on a self-occupied home 2,00,000. The response adds deductionBreakdown (every line with entered, cap, allowed and capped, the HRA workings and the total used in the old regime), deductionSteps, and a steps array inside each regime that shows the working to the tax. The slab, rebate, surcharge and cess logic is unchanged. Who calls it: payroll and HR tools answering regime-choice questions, salary-tax and take-home apps, tax-filing assistants, and chatbots or MCP agents. Worked example: {\"income\":1200000,\"regime\":\"old\",\"itemised\":{\"hra\":{\"basicPlusDa\":600000,\"hraReceived\":240000,\"rentPaid\":240000,\"metro\":true},\"section80C\":200000}} returns an HRA exemption of 180000 (rent less 10% of basic decides), 80C allowed 150000 (capped, 200000 entered), deductions of 330000 and old-regime taxable income of 820000. Integration scenario: an HR portal collects rent, HRA and the employee's investments at the start of the year and shows which regime is cheaper with the caps visible. The section amounts above are the long-standing limits; the Income-tax Act 2025 renumbered the sections from 1 April 2026 (80C became section 123, 80D section 126, HRA section 11) and the amounts were read from secondary sources on 30 Oct 2026, not from the Act's own text. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Payroll & Paycheck"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "income": {
                    "type": "number",
                    "description": "Annual salary or pension income in rupees. The standard deduction is taken off it."
                  },
                  "otherIncome": {
                    "description": "Other annual income in rupees (business, interest, rent). No standard deduction.",
                    "type": "number",
                    "minimum": 0
                  },
                  "regime": {
                    "description": "Which regime the top-level tax and effectiveRatePct report. Default old. Both regimes are always returned in 'regimes'.",
                    "type": "string",
                    "enum": [
                      "old",
                      "new"
                    ]
                  },
                  "age": {
                    "description": "Age group (old regime slabs). Default below60.",
                    "type": "string",
                    "enum": [
                      "below60",
                      "60to80",
                      "above80"
                    ]
                  },
                  "deductions": {
                    "description": "Old regime only: total of 80C, 80D, HRA, home-loan interest and other deductions.",
                    "type": "number",
                    "minimum": 0
                  },
                  "employerNps": {
                    "description": "Employer NPS contribution, section 80CCD(2), capped at 14% of salary (new) or 10% (old).",
                    "type": "number",
                    "minimum": 0
                  },
                  "itemised": {
                    "description": "Old-regime deductions itemised, with the caps applied and returned in deductionBreakdown. Use instead of deductions.",
                    "type": "object",
                    "properties": {
                      "hra": {
                        "description": "HRA exemption inputs (per year). metro true uses 50% of basic + DA, false 40%.",
                        "type": "object",
                        "properties": {
                          "basicPlusDa": {
                            "type": "number",
                            "minimum": 0
                          },
                          "hraReceived": {
                            "type": "number",
                            "minimum": 0
                          },
                          "rentPaid": {
                            "type": "number",
                            "minimum": 0
                          },
                          "metro": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "basicPlusDa",
                          "hraReceived",
                          "rentPaid",
                          "metro"
                        ],
                        "additionalProperties": false
                      },
                      "section80C": {
                        "description": "80C investments and payments; capped at 1,50,000.",
                        "type": "number",
                        "minimum": 0
                      },
                      "health80D": {
                        "description": "80D premiums for self and family and for parents; each capped at 25,000, or 50,000 for a senior citizen.",
                        "type": "object",
                        "properties": {
                          "self": {
                            "type": "number",
                            "minimum": 0
                          },
                          "selfSenior": {
                            "type": "boolean"
                          },
                          "parents": {
                            "type": "number",
                            "minimum": 0
                          },
                          "parentsSenior": {
                            "type": "boolean"
                          }
                        },
                        "additionalProperties": false
                      },
                      "homeLoanInterest": {
                        "description": "Interest on a self-occupied home loan; capped at 2,00,000.",
                        "type": "number",
                        "minimum": 0
                      },
                      "nps80CCD1B": {
                        "description": "Own NPS contribution, 80CCD(1B); capped at 50,000.",
                        "type": "number",
                        "minimum": 0
                      },
                      "other": {
                        "description": "Other deductions, added as entered (not capped here).",
                        "type": "number",
                        "minimum": 0
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "required": [
                  "income"
                ],
                "additionalProperties": false
              },
              "example": {
                "income": 1500000,
                "regime": "new"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "India income tax FY 2026-27: old and new regime, standard deduction, rebate, surcharge and cess",
                  "result": {
                    "income": 1500000,
                    "otherIncome": 0,
                    "currency": "INR",
                    "taxYear": "FY 2026-27",
                    "regime": "new",
                    "age": "below60",
                    "tax": 97500,
                    "effectiveRatePct": 6.5,
                    "regimes": {
                      "old": {
                        "taxableIncome": 1450000,
                        "standardDeduction": 50000,
                        "employerNpsDeducted": 0,
                        "slabTax": 247500,
                        "rebate87A": 0,
                        "marginalRelief": 0,
                        "surcharge": 0,
                        "cess": 9900,
                        "totalTax": 257400,
                        "effectiveRatePct": 17.16,
                        "monthlyTax": 21450,
                        "slabs": [
                          {
                            "fromIncome": 0,
                            "toIncome": 250000,
                            "ratePct": 0,
                            "amount": 250000,
                            "tax": 0
                          },
                          {
                            "fromIncome": 250000,
                            "toIncome": 500000,
                            "ratePct": 5,
                            "amount": 250000,
                            "tax": 12500
                          },
                          {
                            "fromIncome": 500000,
                            "toIncome": 1000000,
                            "ratePct": 20,
                            "amount": 500000,
                            "tax": 100000
                          },
                          "..."
                        ]
                      },
                      "new": {
                        "taxableIncome": 1425000,
                        "standardDeduction": 75000,
                        "employerNpsDeducted": 0,
                        "slabTax": 93750,
                        "rebate87A": 0,
                        "marginalRelief": 0,
                        "surcharge": 0,
                        "cess": 3750,
                        "totalTax": 97500,
                        "effectiveRatePct": 6.5,
                        "monthlyTax": 8125,
                        "slabs": [
                          {
                            "fromIncome": 0,
                            "toIncome": 400000,
                            "ratePct": 0,
                            "amount": 400000,
                            "tax": 0
                          },
                          {
                            "fromIncome": 400000,
                            "toIncome": 800000,
                            "ratePct": 5,
                            "amount": 400000,
                            "tax": 20000
                          },
                          {
                            "fromIncome": 800000,
                            "toIncome": 1200000,
                            "ratePct": 10,
                            "amount": 400000,
                            "tax": 40000
                          },
                          "..."
                        ]
                      }
                    },
                    "lowerTaxRegime": "new",
                    "taxSavingWithLowerRegime": 159900,
                    "sources": "Income Tax Department of India and Union Budget 2026. Tax year FY 2026-27 (AY 2027-28). FreeDailyPro table last checked 2026-10-11 (compared with the official source). Next review: February, after the Union Budget.",
                    "dataStatus": "checked",
                    "notes": [
                      "income is salary or pension income: the standard deduction (₹75,000 new regime, ₹50,000 old regime) is taken off it. Send business or other income as otherIncome (no standard deduction). Both regimes are always calculated; 'tax' and 'effectiveRatePct' follow the regime field (default old, as in the ...",
                      "New regime (section 115BAC, the default for most taxpayers): 0 / 5 / 10 / 15 / 20 / 25 / 30% slabs at ₹4 / 8 / 12 / 16 / 20 / 24 lakh, 87A rebate up to ₹60,000 for taxable income up to ₹12 lakh with marginal relief, surcharge capped at 25%. Old regime: age-based slabs, 87A rebate up to ₹12,500 for i...",
                      "deductions (80C, 80D, HRA, home-loan interest and so on, entered as one total) apply to the old regime only. employerNps (80CCD(2)) is capped at 14% of salary (new) or 10% (old). Health and education cess is 4%. Capital gains and special-rate income are not modelled."
                    ],
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Negative or missing income, a negative otherIncome, deductions or employerNps, or an unknown regime or age group; itemised sent together with deductions, or a negative itemised amount"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/uk-tax": {
      "post": {
        "summary": "Calculate UK income tax and Class 1 National Insurance for 2026/27, with Scottish rates",
        "operationId": "convertersUkTax",
        "description": "Send gross annual salary as 'income' (pounds). Returns income tax, Class 1 employee National Insurance, take-home pay and the band-by-band breakdown for the 2026/27 tax year. England, Wales and Northern Ireland use 20%, 40% and 45% above the £12,570 personal allowance (tapered away between £100,000 and £125,140); send 'scotland': true for the Scottish bands (starter 19%, basic 20%, intermediate 21%, higher 42%, advanced 45%, top 48%, from the Scottish Budget of January 2026). National Insurance is the same everywhere in the UK: 8% between £12,570 and £50,270 and 2% above; employer NI (15% above £5,000) is returned for information. Optional 'pensionPct' and 'pensionType' (sacrifice, netpay, ras) model workplace pension tax relief. First-version fields income, tax (income tax) and effectiveRatePct are unchanged in meaning; 'tax' is income tax only, National Insurance is in 'nationalInsurance'. Where the data comes from: HMRC rates and thresholds and gov.scot / mygov.scot, which FreeDailyPro compared with the official pages (Scottish bands, NI thresholds and rates re-checked 30 Oct 2026). Update process: one table file shared with the website, updated by FreeDailyPro every April for the new tax year. Not covered: student loans, Class 2 and 4 NI (self-employed), savings and dividend income, Welsh-specific variations (rates match England). Estimate, not tax advice. Payslip matching (all optional): 'taxCode' (1257L, 1383M, 0T, BR, D0, D1, NT, K475, S1257L, C1257L, SBR, SD0 to SD3; meanings follow GOV.UK 'What the letters mean') replaces the standard allowance and its taper, and an S prefix selects the Scottish bands; 'bonus' (a one-off bonus or overtime) is taxed and charged National Insurance as pay and the response's 'bonus' block shows what it adds on its own; 'benefits' (taxable benefits in kind) add to taxable pay but not to employee National Insurance; 'marriageAllowance' (receive or give) applies when no code is sent. The response also carries 'perPeriod' (year, month, week and 4-weekly figures; a payslip uses cumulative tax, so one month can differ from a twelfth) and 'steps'. Who calls it: payroll and HR tools, job-offer and take-home comparison apps, recruitment platforms, and chatbots or MCP agents. Worked examples: {\"income\":40000,\"taxCode\":\"BR\"} returns incomeTax 8000; {\"income\":40000,\"bonus\":5000} returns bonus.extraIncomeTax 1000, extraNationalInsurance 400 and extraTakeHome 3600. Not modelled: emergency-code timing, the half-of-pay limit on K code deductions, Blind Person's Allowance, Class 1A employer NI on benefits. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Payroll & Paycheck"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "income": {
                    "type": "number",
                    "description": "Gross annual salary in pounds."
                  },
                  "scotland": {
                    "description": "true for Scottish income tax bands. Default false (England, Wales, Northern Ireland).",
                    "type": "boolean"
                  },
                  "pensionPct": {
                    "description": "Your pension contribution as a percent of salary.",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "pensionType": {
                    "description": "How the pension is taken: salary sacrifice (default, lowers tax and National Insurance), net pay arrangement (lowers tax only) or relief at source.",
                    "type": "string",
                    "enum": [
                      "sacrifice",
                      "netpay",
                      "ras"
                    ]
                  },
                  "taxCode": {
                    "description": "Optional PAYE tax code as printed on a payslip: 1257L, 1383M, 0T, BR, D0, D1, NT, K475, S1257L (Scotland), C1257L (Wales), SBR, SD0 to SD3. A code replaces the standard allowance. Omit it for the standard allowance and taper.",
                    "type": "string",
                    "maxLength": 20
                  },
                  "bonus": {
                    "description": "A one-off bonus or overtime in the year, in pounds. Returns what it adds on its own in 'bonus'.",
                    "type": "number",
                    "minimum": 0
                  },
                  "benefits": {
                    "description": "Taxable benefits in kind per year, in pounds: added to taxable pay for income tax, not charged employee National Insurance.",
                    "type": "number",
                    "minimum": 0
                  },
                  "marriageAllowance": {
                    "description": "Marriage Allowance when no taxCode is sent: receive (tax reduced by up to £252) or give (£1,260 of allowance). Ignored when taxCode is sent.",
                    "type": "string",
                    "enum": [
                      "none",
                      "receive",
                      "give"
                    ]
                  }
                },
                "required": [
                  "income"
                ],
                "additionalProperties": false
              },
              "example": {
                "income": 60000,
                "scotland": true
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "UK income tax and Class 1 National Insurance 2026/27 with Scottish rates",
                  "result": {
                    "income": 60000,
                    "region": "Scotland",
                    "currency": "GBP",
                    "taxYear": "2026/27",
                    "tax": 13182.05,
                    "effectiveRatePct": 21.97,
                    "incomeTax": 13182.05,
                    "nationalInsurance": {
                      "class1Employee": 3210.6,
                      "mainRateAmount": 3016,
                      "upperRateAmount": 194.6
                    },
                    "employerNationalInsurance": 8250,
                    "personalAllowance": 12570,
                    "taxableIncome": 47430,
                    "pensionContribution": 0,
                    "takeHome": 43607.35,
                    "takeHomeMonthly": 3633.95,
                    "effectiveTotalRatePct": 27.32,
                    "bands": [
                      {
                        "band": "Starter rate",
                        "ratePct": 19,
                        "amount": 3967,
                        "tax": 753.73
                      },
                      {
                        "band": "Basic rate",
                        "ratePct": 20,
                        "amount": 12989,
                        "tax": 2597.8
                      },
                      {
                        "band": "Intermediate rate",
                        "ratePct": 21,
                        "amount": 14136,
                        "tax": 2968.56
                      },
                      "..."
                    ],
                    "sources": "HMRC, gov.scot and Student Loans Company threshold tables. Tax year 2026/27. FreeDailyPro table last checked 2026-10-11 (compared with the official source). Next review: April.",
                    "dataStatus": "checked",
                    "notes": [
                      "Scottish income tax bands (starter 19%, basic 20%, intermediate 21%, higher 42%, advanced 45%, top 48%) from the Scottish Budget of January 2026, with the UK personal allowance. National Insurance is the same in Scotland as in the rest of the UK.",
                      "National Insurance is Class 1 employee (employed earner): 8% between £12,570 and £50,270 and 2% above, on salary. Employer National Insurance (15% above £5,000) is shown for information and is not deducted from take-home pay. Class 2 and 4 (self-employed) are not covered.",
                      "Personal allowance tapers away between £100,000 and £125,140. Student loans, Gift Aid, benefits in kind, savings and dividend income are not modelled."
                    ],
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Negative or missing income, an unknown pensionType, a taxCode that is not a valid PAYE code (the message gives examples), or a negative bonus or benefits"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/state-tax": {
      "post": {
        "summary": "Calculate US state income tax from any state's 2026 schedule or a flat rate",
        "operationId": "convertersStateTax",
        "description": "Send 'income' and 'state' (two-letter code such as NY, or the full name; all 50 states and DC) to calculate that state's income tax from its bracket schedule, with the state standard deduction and personal exemptions for 'filingStatus' (single by default; married-joint uses the joint schedule). Example: New York, $100,000, single = $4,859.75. Send 'ratePct' instead (first-version behaviour) for a flat-rate calculation; ratePct wins if both are sent. 'includeLocal' adds an average local income tax where one exists. The response shows the bracket rows, the schedule's tax year ('rateSourceYear'; most states 2026, California uses the 2025 schedule, Vermont and North Dakota use 2025 bracket widths) and whether it came from an official source ('officialSource'), plus per-state notes. Where the data comes from: each state's revenue department and enacted 2026 laws, with the Tax Foundation 'State Individual Income Tax Rates and Brackets' table as the secondary source; NY, CA, WV and SC were read from official pages, the rest are marked as secondary-source estimates (dataStatus 'estimate'). Update process: one table file shared with the website, re-audited by FreeDailyPro every January (last audit 29 Oct 2026). Not modelled: federal-tax deductions (AL, MO, OR), phased-out exemptions, credits, local taxes unless includeLocal. Estimate, not tax advice. Local income tax: the response always includes 'stateTaxBeforeLocal', 'localTax' (0 unless includeLocal is true and the state has a typical average), 'localRatePct' and 'localTaxNotice' ({ status: included or excluded, averageRatePct, text }), a ready-to-show warning for Maryland, New York, Ohio, Pennsylvania, Indiana and Michigan when local tax is not included; 'steps' is the working. Who calls it: payroll, HR and relocation tools, take-home and job-offer comparison apps, freelancer tax planners, and chatbots or MCP agents. Worked example: {\"income\":75000,\"state\":\"MD\",\"includeLocal\":true} returns stateTaxBeforeLocal 3198.88, localTax 2190.4 (3.2% of the 68,450 taxable income) and tax 5389.28; without includeLocal, tax is 3198.88 and localTaxNotice.status is 'excluded'. The local averages (Indiana 1.6, Maryland 3.2, New York 3.5, Ohio 2, Pennsylvania 1.5 percent) are typical estimates that FreeDailyPro has not checked against each locality's own rate; Michigan city taxes have no average and are never added. More options: 'locality' (an id from the response's availableLocalities, for example ny-nyc, ny-yonkers, any Maryland county such as md-montgomery, pa-philadelphia, mi-detroit, mo-kansas-city, mo-st-louis, oh-columbus) adds that city or county's local income tax as its own 'locality' object, with its source page and the day it was read, and replaces the typical average; 'localityRole' worker uses the non-resident rate where one was confirmed. 'payrollPrograms' lists the state payroll programs as their own lines (California SDI 1.3%, New York PFL, New Jersey TDI and FLI, Washington PFML and WA Cares, Massachusetts PFML, Paid Leave Oregon; employee shares on wages, with the wage caps) and 'totalWithLocalAndPayroll' adds them to tax. 'tax' keeps its meaning. Localities and programs whose rates could not be confirmed from an official page (Indiana counties, other Ohio and Pennsylvania cities, other states' programs) are not included. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Payroll & Paycheck"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "income": {
                    "type": "number",
                    "description": "Annual income subject to state tax, in US dollars."
                  },
                  "state": {
                    "description": "US state (two-letter code such as NY, or the full name; DC included). Looks up that state's 2026 brackets, standard deduction and exemptions. Send this or ratePct.",
                    "type": "string"
                  },
                  "ratePct": {
                    "description": "Flat rate in percent (first-version behaviour). Takes priority over state.",
                    "type": "number"
                  },
                  "filingStatus": {
                    "description": "Filing status for the state schedule. Default single.",
                    "type": "string",
                    "enum": [
                      "single",
                      "married-joint",
                      "married-separate",
                      "head-of-household"
                    ]
                  },
                  "includeLocal": {
                    "description": "true adds an average local income tax where the state has local taxes (an estimate). Default false.",
                    "type": "boolean"
                  },
                  "locality": {
                    "description": "A named city or county for the chosen state (id from the response's availableLocalities, e.g. ny-nyc, ny-yonkers, md-montgomery, pa-philadelphia, mi-detroit, mo-kansas-city, mo-st-louis, oh-columbus). Adds its local income tax as its own 'locality' object and replaces the typical average (includeLocal is then ignored). 'tax' is unchanged; see totalWithLocalAndPayroll.",
                    "type": "string"
                  },
                  "localityRole": {
                    "description": "With locality: resident (default) or worker (live elsewhere, work there) where a non-resident rate was confirmed (Philadelphia, Detroit, Kansas City, St. Louis).",
                    "type": "string",
                    "enum": [
                      "resident",
                      "worker"
                    ]
                  }
                },
                "required": [
                  "income"
                ],
                "additionalProperties": false
              },
              "example": {
                "income": 100000,
                "state": "NY",
                "filingStatus": "single"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "US state income tax with a 50-state schedule lookup",
                  "result": {
                    "income": 100000,
                    "state": "NY",
                    "stateName": "New York",
                    "kind": "progressive",
                    "filingStatus": "single",
                    "tax": 4859.75,
                    "taxableIncome": 92000,
                    "effectiveRatePct": 4.86,
                    "marginalRatePct": 5.9,
                    "brackets": [
                      {
                        "fromIncome": 0,
                        "toIncome": 8500,
                        "ratePct": 3.9,
                        "tax": 331.5
                      },
                      {
                        "fromIncome": 8500,
                        "toIncome": 11700,
                        "ratePct": 4.4,
                        "tax": 140.8
                      },
                      {
                        "fromIncome": 11700,
                        "toIncome": 13900,
                        "ratePct": 5.15,
                        "tax": 113.3
                      },
                      "..."
                    ],
                    "rateSource": "tax.ny.gov, NYS-50-T-NYS and NYS-50-T-Y (1/26) annual rate schedule: 3.9%, 4.4%, 5.15%, 5.4%, 5.9%",
                    "rateSourceYear": "2026",
                    "officialSource": true,
                    "localIncluded": false,
                    "taxYear": 2026,
                    "sources": "Each state's revenue department and enacted 2026 laws; per-state notes name the exact source. Tax year 2026 (California uses the 2025 schedule; Vermont and North Dakota use 2025 bracket widths). FreeDailyPro table last checked 2026-10-29 (compiled from secondary sources, confirm with the authority)....",
                    "dataStatus": "estimate",
                    "notes": [
                      "State schedule for New York, tax year 2026: tax.ny.gov, NYS-50-T-NYS and NYS-50-T-Y (1/26) annual rate schedule: 3.9%, 4.4%, 5.15%, 5.4%, 5.9%.",
                      "Taxable income is income less the state standard deduction and personal exemptions for single; credits and federal-tax deductions are not modelled.",
                      "Estimated rates, mostly tax year 2026 (California uses the 2025 schedule; see the per-state note). Check your state's revenue department for exact figures.",
                      "..."
                    ],
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Neither state nor ratePct, an unknown state (the message says what to send), a negative income, an unknown filingStatus, or a locality that does not belong to the state"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/college-cost": {
      "post": {
        "summary": "Project the total cost of college year by year with inflation",
        "operationId": "convertersCollegeCost",
        "description": "Project the total cost of college year by year with inflation. Send JSON with annualCost, years (required); optional: inflationPct, startDate. Returns JSON with total, byYear, startDate, endDate (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Retirement & Debt Planning"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "annualCost": {
                    "type": "number",
                    "minimum": 0
                  },
                  "years": {
                    "type": "number",
                    "minimum": 0
                  },
                  "inflationPct": {
                    "type": "number"
                  },
                  "startDate": {
                    "description": "Optional date the first year starts, as YYYY-MM-DD. Adds the start date of each year to byYear, plus startDate and endDate for the whole program. It only labels the years; the costs do not change.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  }
                },
                "required": [
                  "annualCost",
                  "years"
                ],
                "additionalProperties": false
              },
              "example": {
                "annualCost": 30000,
                "years": 4,
                "inflationPct": 4,
                "startDate": "2027-08-15"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "College cost calculator client and server side from freedailypro",
                  "result": {
                    "total": 127393.92,
                    "byYear": [
                      {
                        "year": 1,
                        "cost": 30000,
                        "startDate": "2027-08-15"
                      },
                      {
                        "year": 2,
                        "cost": 31200,
                        "startDate": "2028-08-15"
                      },
                      {
                        "year": 3,
                        "cost": 32448,
                        "startDate": "2029-08-15"
                      },
                      "..."
                    ],
                    "startDate": "2027-08-15",
                    "endDate": "2031-08-15"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/profit-margin": {
      "post": {
        "summary": "Calculate profit, margin and markup from cost and selling price",
        "operationId": "businessProfitMargin",
        "description": "Send any TWO of 'cost', 'price', 'profit', 'marginPct' and 'markupPct' (the first version took cost and price, which still works) plus optional per-unit 'shipping' and 'acquisition' (customer-acquisition cost), which count as costs. Returns 'profit', 'marginPct' and 'markupPct' as before, plus 'cost', 'price', 'shipping', 'acquisition', 'totalCost' (cost + shipping + acquisition), 'solvedFrom' (which two you sent) and a 'steps' array that shows the working. Definitions: profit = price - cost - shipping - acquisition; margin = profit / price; markup = profit / total cost (with no extras that is profit / cost). Margin and markup together describe the same ratio (markup = margin / (1 - margin)), so that pair is refused: add a cost, price or profit. Who calls it: online-seller and repricing tools (Shopify, Etsy, Amazon and eBay sellers), retail and wholesale quoting tools, ecommerce dashboards, and chatbots or MCP agents. Worked examples: {\"cost\":20,\"markupPct\":75} returns price 35 and marginPct 42.86; {\"cost\":20,\"price\":35,\"shipping\":3,\"acquisition\":2} returns profit 10, marginPct 28.57, markupPct 40 (on the total cost of 25); {\"price\":35,\"marginPct\":42.9} returns cost 19.99. Integration scenario: a pricing tool asks the seller for the product cost and a target markup, adds the shipping and ad cost per order and shows the price and the real margin after those costs. Pure arithmetic on the numbers sent, nothing to update. Marketplace fees and taxes are not included; for those use the marketplace-fee endpoint. A margin of 100% or more, a markup of -100% or less, a costs total larger than the price leaves room for, a profit with a 0% margin or markup, a count of known numbers other than two, and margin + markup alone are rejected with a 400 and a plain-words message. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "cost": {
                    "type": "number",
                    "minimum": 0
                  },
                  "price": {
                    "type": "number",
                    "minimum": 0
                  },
                  "profit": {
                    "type": "number"
                  },
                  "marginPct": {
                    "type": "number"
                  },
                  "markupPct": {
                    "type": "number"
                  },
                  "shipping": {
                    "type": "number"
                  },
                  "acquisition": {
                    "type": "number"
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "cost": 6200,
                "price": 9800
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Profit margin calculator client and server side from freedailypro",
                  "result": {
                    "profit": 3600,
                    "marginPct": 36.73,
                    "markupPct": 58.06
                  }
                }
              }
            }
          },
          "400": {
            "description": "Not exactly two of cost, price, profit, marginPct and markupPct; margin of 100% or more; margin and markup together; costs larger than the price allows; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/marketplace-fee": {
      "post": {
        "summary": "Calculate the marketplace fee and net payout for a sale price from a fee percentage and fixed fee",
        "operationId": "businessMarketplaceFee",
        "description": "Send 'price', 'feePct' (the marketplace's percentage fee) and optionally 'fixedFee' (per-order fixed fees such as Etsy's $0.20 or eBay's $0.40). Returns 'fee' (price x feePct + fixedFee), 'net' (price - fee) and a 'steps' array that shows the working; fee and net are unchanged from the first version. Who calls it: seller tools and listing-price helpers for Etsy, eBay, Amazon, Mercari and Shopify sellers, reseller profit trackers, bookkeeping and accounting apps, and chatbots or MCP agents. Worked example: {\"price\":29.99,\"feePct\":6.5,\"fixedFee\":0.2} returns fee 2.15 (1.95 percentage fee + 0.20 fixed), net 27.84. Integration scenario: a repricing job calls the endpoint once per marketplace with that marketplace's rate and adds its own cost, shipping and payment-processing amounts to reach the profit; the 'steps' array can be shown to the seller. The endpoint applies the one percentage you send: it does not know any marketplace's rates, so send the rate and fixed fee from the marketplace's own fee page (eBay's page, read 30 Oct 2026, shows 13.6% up to $7,500 per item and 2.35% above it, charged on shipping and sales tax as well, plus $0.30 or $0.40 per order; FreeDailyPro's Etsy and Amazon figures could not be re-checked against their official pages). Estimate, not accounting advice. More options: send 'cost' (and optionally shippingCharged, shippingCost, paymentPct, paymentFixed, fulfilment, adCost, returnPct, returnPostage, unsellablePct, feeOnShipping, ordersPerMonth) to get a 'profit' object: profit if the order is kept, the result if it is returned, expected profit, margin, ROI (profit if kept / (cost + your shipping + ad cost)), the break-even price and, with ordersPerMonth, the monthly expected profit. Send 'compare' (2 to 4 of Amazon, Etsy, eBay, Walmart, Mercari, TikTok Shop, Shopify; needs cost, feePct is then optional) to get 'comparison': every fee line, payout, profit, margin, ROI and break-even price per marketplace using the site's preset rates, each with ratesVerified and ratesVerifiedOn (Etsy and Amazon were read from the marketplaces' own pages on 2026-11-01, eBay on 2026-10-30; the others are marked as not re-checked). offsiteAdsPct (12 or 15) adds Etsy Offsite Ads, capped at $100 per order. Presets are starting points; real fees vary by category and account. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "price": {
                    "type": "number",
                    "minimum": 0
                  },
                  "feePct": {
                    "description": "Marketplace fee in percent. Required unless compare is sent.",
                    "type": "number",
                    "minimum": 0
                  },
                  "fixedFee": {
                    "type": "number",
                    "minimum": 0
                  },
                  "cost": {
                    "description": "What the item costs you. With it the response adds a 'profit' object (profit if kept, returns, margin, ROI, break-even price).",
                    "type": "number",
                    "minimum": 0
                  },
                  "shippingCharged": {
                    "description": "Shipping the buyer pays on top of price.",
                    "type": "number",
                    "minimum": 0
                  },
                  "shippingCost": {
                    "description": "What you pay the carrier to send one order. Default 0 (the website form pre-fills 4.50).",
                    "type": "number",
                    "minimum": 0
                  },
                  "paymentPct": {
                    "description": "Separate payment-processing fee in percent (0 where the marketplace fee includes it).",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "paymentFixed": {
                    "type": "number",
                    "minimum": 0
                  },
                  "fulfilment": {
                    "description": "Fulfilment fee per unit, e.g. Amazon FBA (in compare it is charged to Amazon only).",
                    "type": "number",
                    "minimum": 0
                  },
                  "adCost": {
                    "description": "Ad or acquisition cost per order.",
                    "type": "number",
                    "minimum": 0
                  },
                  "returnPct": {
                    "description": "Share of orders returned, in percent. Default 0 (the website form pre-fills 5).",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "returnPostage": {
                    "description": "Postage lost on a return. Default 0 (the website form pre-fills 4.50).",
                    "type": "number",
                    "minimum": 0
                  },
                  "unsellablePct": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100
                  },
                  "feeOnShipping": {
                    "description": "Whether the percentage fee also applies to shipping charged. Default true.",
                    "type": "boolean"
                  },
                  "offsiteAdsPct": {
                    "description": "Compare only: Etsy Offsite Ads fee on the Etsy column, 15% or 12% (capped at $100 per order). Default 0.",
                    "anyOf": [
                      {
                        "type": "number",
                        "enum": [
                          0
                        ]
                      },
                      {
                        "type": "number",
                        "enum": [
                          12
                        ]
                      },
                      {
                        "type": "number",
                        "enum": [
                          15
                        ]
                      }
                    ]
                  },
                  "ordersPerMonth": {
                    "description": "Adds the expected profit for a month of that many orders.",
                    "type": "number",
                    "minimum": 0
                  },
                  "compare": {
                    "description": "2 to 4 of Amazon, Etsy, eBay, Walmart, Mercari, TikTok Shop, Shopify. Needs cost. Returns 'comparison': every fee line, payout, profit, margin, ROI and break-even price per marketplace, with the date each preset's rates were verified.",
                    "minItems": 2,
                    "maxItems": 4,
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "required": [
                  "price"
                ],
                "additionalProperties": false
              },
              "example": {
                "price": 29.99,
                "feePct": 6.5,
                "fixedFee": 0.45
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Marketplace fee calculator client and server side from freedailypro",
                  "result": {
                    "price": 29.99,
                    "fee": 2.4,
                    "net": 27.59
                  }
                }
              }
            }
          },
          "400": {
            "description": "A missing or non-numeric price, no feePct and no compare, compare with fewer than 2 or more than 4 (or an unknown) marketplaces, compare without cost; the body says which field"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/shipping-estimate": {
      "post": {
        "summary": "Estimate a shipping cost from weight, rate per kilogram and a base fee",
        "operationId": "businessShippingEstimate",
        "description": "Estimate a shipping cost from weight, rate per kilogram and a base fee. Send JSON with weightKg, ratePerKg (required); optional: base. Returns JSON with cost (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "weightKg": {
                    "type": "number"
                  },
                  "ratePerKg": {
                    "type": "number"
                  },
                  "base": {
                    "type": "number",
                    "minimum": 0
                  }
                },
                "required": [
                  "weightKg",
                  "ratePerKg"
                ],
                "additionalProperties": false
              },
              "example": {
                "weightKg": 2.4,
                "ratePerKg": 3.2,
                "base": 4
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Shipping cost estimator client and server side from freedailypro",
                  "result": {
                    "cost": 11.68
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/break-even": {
      "post": {
        "summary": "Calculate the break-even number of units from fixed costs, price and variable cost",
        "operationId": "businessBreakEven",
        "description": "Send 'fixedCosts' (per month), 'price' and 'variableCost' (per unit). Returns 'contribution' and 'units' as before (units are rounded UP to whole units), plus 'exactUnits' (fixed costs / contribution, not rounded), 'revenueAtUnits' (whole units x price: the revenue when you sell exactly the whole break-even units) and 'exactRevenue' (the break-even revenue without rounding the units), 'contributionMarginPct' and a 'steps' array that shows the working. Optional 'targetProfit' adds 'target' (units and revenue to earn that monthly profit). Optional 'expectedUnits' (units you expect to sell per month) adds 'expected': 'breakEvenPrice' (fixed costs / expected units + variable cost, rounded up to the cent), 'monthlyProfit' at the price you sent, and 'marginOfSafetyUnits' and 'marginOfSafetyPct' (expected units less the whole break-even units, as a share of expected units; negative means short of break-even). Optional 'startupCost' (needs expectedUnits) adds 'startupMonths': the start-up cost divided by the monthly profit, or null when the monthly profit is not above 0 (never recovered). Who calls it: small-business and e-commerce pricing tools, startup and business-plan builders, accounting and bookkeeping apps, teaching tools for cost-volume-profit analysis, and chatbots or MCP agents. Worked example: {\"fixedCosts\":5000,\"price\":25,\"variableCost\":10,\"expectedUnits\":500,\"startupCost\":6000} returns units 334, exactRevenue 8333.33 (revenueAtUnits 8350), breakEvenPrice 20, marginOfSafetyUnits 166 (33.2%), monthlyProfit 2500 and startupMonths 2.4. Integration scenario: a plan builder collects costs and a forecast volume and shows the owner the lowest price that covers costs at that volume, how far sales can fall, and the payback time of the launch costs, with the working beside each figure. Pure arithmetic on the numbers sent, nothing to update. Illustration only, not financial advice. A price at or below the variable cost, negative inputs, startupCost without expectedUnits and an expectedUnits of 0 are rejected with a 400 and a plain-words message. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fixedCosts": {
                    "type": "number"
                  },
                  "price": {
                    "type": "number"
                  },
                  "variableCost": {
                    "type": "number"
                  },
                  "targetProfit": {
                    "type": "number"
                  },
                  "expectedUnits": {
                    "type": "number"
                  },
                  "startupCost": {
                    "type": "number"
                  }
                },
                "required": [
                  "fixedCosts",
                  "price",
                  "variableCost"
                ],
                "additionalProperties": false
              },
              "example": {
                "fixedCosts": 12000,
                "price": 40,
                "variableCost": 15
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Break even calculator client and server side from freedailypro",
                  "result": {
                    "contribution": 25,
                    "units": 480
                  }
                }
              }
            }
          },
          "400": {
            "description": "A price not above the variable cost, negative or non-numeric inputs, startupCost sent without expectedUnits, or expectedUnits of 0; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/government-forms": {
      "post": {
        "summary": "List the common government forms for a region (an index, not official forms)",
        "operationId": "businessGovernmentForms",
        "description": "List the common government forms for a region (an index, not official forms). Send JSON with no required fields; optional: region. Returns JSON with region, suggested, note (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "region": {
                    "type": "string",
                    "enum": [
                      "US",
                      "IN",
                      "UK",
                      "other"
                    ]
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "region": "US"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Government forms hub client and server side from freedailypro",
                  "result": {
                    "region": "US",
                    "suggested": [
                      "W-9",
                      "W-4",
                      "I-9",
                      "..."
                    ],
                    "note": "Index only — not official forms."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/seo/robots-sitemap": {
      "post": {
        "summary": "Generate a robots.txt and sitemap.xml for a domain from a list of page paths",
        "operationId": "seoRobotsSitemap",
        "description": "Generate a robots.txt and sitemap.xml for a domain from a list of page paths. Send JSON with domain, pages (required). Returns JSON with robotsTxt, sitemapXml (inside result). Limits: pages: up to 500 items. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored. HTML entities: common entities in the text you send (&amp; &lt; &gt; &quot; &#39; &nbsp; and numeric forms such as &#233; or &#xE9;) are decoded once before processing, so 'Tom &amp; Jerry' is read as 'Tom & Jerry' and is not escaped twice, and keyword counts never include the word 'amp'; other named entities are left as typed. Errors: 400 with the same body on every SEO endpoint, {error, code, details: {fieldErrors, formErrors, issues}}.",
        "tags": [
          "Text",
          "SEO & Web Markup"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "domain": {
                    "type": "string",
                    "minLength": 1,
                    "description": "The site address, http:// or https:// with a host, for example https://example.com (a path prefix such as https://example.com/blog is allowed). No username/password, ?query or #fragment. javascript:, ftp: and every other scheme is a 400."
                  },
                  "pages": {
                    "minItems": 1,
                    "maxItems": 500,
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "1 to 500 pages: paths such as /about (a missing leading slash is added), or full URLs on the same site. Empty entries, other hosts, credentials in a URL and protocol-relative // entries are a 400; duplicates are removed; spaces and non-ASCII characters are percent-encoded; & < > \" ' are XML-escaped in sitemap.xml."
                  }
                },
                "required": [
                  "domain",
                  "pages"
                ],
                "additionalProperties": false
              },
              "example": {
                "domain": "https://example.com",
                "pages": [
                  "/",
                  "/about",
                  "/pricing"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "robotsTxt": {
                          "type": "string",
                          "description": "The robots.txt text",
                          "example": "User-agent: *\nAllow: /\n\nSitemap: https://example.com/sitemap.xml"
                        },
                        "sitemapXml": {
                          "type": "string",
                          "description": "The sitemap.xml text (every URL XML-escaped)",
                          "example": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">...</urlset>"
                        }
                      },
                      "required": [
                        "robotsTxt",
                        "sitemapXml"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "result": {
                    "robotsTxt": "User-agent: *\nAllow: /\nDisallow: /admin/\nDisallow: /private/\n\nSitemap: https://example.com/sitemap.xml",
                    "sitemapXml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\n  <url>\n    <loc>https://example.com/</loc>\n    <lastmod>2026-10-30</lastmod>\n  </url>\n  <url>\n    <loc>https://example.com/about</loc>\n    <lastmod>2026-10-30</lastmod>\n  </url>\n  <url>\n    <loc>http..."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input. Body: {error, code, details: {fieldErrors, formErrors, issues}}; error is a plain sentence naming the field, code is invalid_input or a specific code, issues lists each problem as {path, message, code}."
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/grammar-check": {
      "post": {
        "summary": "Check and correct common English grammar, agreement and spelling errors (rule based)",
        "operationId": "textGrammarCheck",
        "description": "A rule-based English checker, NOT an AI model: it applies a fixed list of patterns, so it fixes the mistakes below reliably and leaves everything else alone (anything it is unsure about is returned in 'suggestions' instead of being changed). What it checks and corrects: subject-verb agreement (she go -> she goes; they/we/you was -> were; he/she/it were -> was, but 'if she were' is kept; they/we/you is -> are; he/she/it are -> is; I is/are -> I am; they/we/you/I doesn't or does not -> don't / do not; he/she/it don't or do not -> doesn't / does not; has/have mix-ups; people/children/men/women is -> are); 'every' and 'each' followed by a plural noun (every days -> every day); a/an by sound (a hour -> an hour, an university -> a university, a apple -> an apple); object pronouns used as the subject at the start of a sentence (Me and him goes to the store -> He and I go to the store; Me goes -> I go) and I/you/we/they followed by an -s verb (I goes -> I go; they works -> they work); contractions without apostrophes (dont -> don't); their/they're, its/it's and your/you're mix-ups; 'should of' -> 'should have'; irregular verbs written wrong (buyed -> bought); repeated words; extra spaces and spacing around punctuation; capital 'I' and capital letters at the start of sentences; repeated !!! or ???; and a built-in list of about 100 common misspellings (teh -> the, recieve -> receive). URLs, e-mail addresses, file names, #hashtags and `code` are never changed. It does not understand meaning, so it will miss errors outside these patterns (wrong word choice, tense consistency, missing words, long-distance agreement such as 'the list of items are'). 'corrected' is the fixed text, 'issues' lists each fix in plain words, 'suggestions' lists things to check by hand. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 20000,
                    "description": "The text to check and correct (up to 20,000 characters). Rule based, English only: see the endpoint description for exactly what is checked."
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "She go to school every days and they was happy. i recieve teh email yesterday."
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "corrected": {
                          "type": "string",
                          "description": "The text with the rule-based corrections applied"
                        },
                        "issues": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "type": {
                                "type": "string",
                                "description": "grammar, spelling, spacing, repetition or capitalization"
                              },
                              "message": {
                                "type": "string",
                                "description": "What was changed and why"
                              }
                            },
                            "required": [
                              "type",
                              "message"
                            ]
                          },
                          "description": "Every correction applied"
                        },
                        "suggestions": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "type": {
                                "type": "string",
                                "description": "Kind of suggestion"
                              },
                              "message": {
                                "type": "string",
                                "description": "A doubtful case that was NOT changed"
                              }
                            },
                            "required": [
                              "type",
                              "message"
                            ]
                          },
                          "description": "Possible problems left for you to decide"
                        },
                        "method": {
                          "type": "string",
                          "description": "Always says the checker is rule based (pattern rules and a word list), not an AI model"
                        },
                        "corrections": {
                          "type": "number",
                          "description": "Number of corrections applied"
                        }
                      },
                      "required": [
                        "corrected",
                        "issues",
                        "suggestions",
                        "method",
                        "corrections"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Grammar checker",
                  "result": {
                    "corrected": "She goes to school every day and they were happy. I receive the email yesterday.",
                    "issues": [
                      {
                        "type": "grammar",
                        "message": "\"She go\" → \"She goes\": verb agreement with \"She\""
                      },
                      {
                        "type": "grammar",
                        "message": "\"every days\" → \"every day\": \"every\" is followed by a singular noun"
                      },
                      {
                        "type": "spelling",
                        "message": "\"recieve\" → \"receive\""
                      },
                      "..."
                    ],
                    "suggestions": [],
                    "method": "rule-based (pattern rules and a misspelling list, not an AI model)",
                    "corrections": 6
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or empty text, or more than 20,000 characters"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/seo/caption-generator": {
      "post": {
        "summary": "Write social media captions and topic-based hashtags (template based)",
        "operationId": "seoCaptionGenerator",
        "description": "Writes three captions for a topic, a platform and a tone from fixed templates (not an AI model). Hashtags are built from the words of YOUR topic (stop words removed: 'Grand opening of our new coffee shop' gives #grandopening #coffeeshop #shop #coffee #opening) followed by a small fixed set for the platform (instagram: #instagood, tiktok: #fyp; x and linkedin have none). Hashtag counts: instagram up to 5 from the topic, tiktok 3, linkedin 3, x 2. Tones differ in structure and voice, not just emoji: fun (exclamations, a hook question, emoji), professional (plain update/overview/key-point sentences, no emoji), bold (short imperative lines such as 'Make it happen.' and 'No excuses.'), genz (lowercase slang; on linkedin it falls back to professional because slang reads badly there). Instagram and LinkedIn captions use line breaks and a call to action; X captions are one line within 280 characters including hashtags; TikTok captions are one short line. The topic is placed as a standalone phrase (heading, after a colon, or as its own sentence) so any wording stays grammatical, and its first letter is capitalised unless it looks like a brand (iPhone). Nothing is said about the topic beyond your words. 'result' holds the three captions (each ends with the hashtags) and 'hashtags' lists the tags used. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. HTML entities: common entities in the text you send (&amp; &lt; &gt; &quot; &#39; &nbsp; and numeric forms such as &#233; or &#xE9;) are decoded once before processing, so 'Tom &amp; Jerry' is read as 'Tom & Jerry' and is not escaped twice, and keyword counts never include the word 'amp'; other named entities are left as typed. Errors: 400 with the same body on every SEO endpoint, {error, code, details: {fieldErrors, formErrors, issues}}.",
        "tags": [
          "Text",
          "SEO & Web Markup"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "topic": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "description": "What the post is about, in your own words and in any language or script (Japanese, Arabic, accented Latin, emoji are all fine), for example 'Grand opening of our new coffee shop' or '日本のコーヒー ☕'. Up to 200 characters; it must contain at least one letter or number. The hashtags are built from these words."
                  },
                  "platform": {
                    "type": "string",
                    "enum": [
                      "instagram",
                      "tiktok",
                      "x",
                      "linkedin"
                    ],
                    "description": "instagram, tiktok, x or linkedin: sets length, line breaks, call to action and how many hashtags."
                  },
                  "tone": {
                    "description": "fun (default), professional, bold or genz. Each tone writes with a different sentence structure and voice, not just different emoji.",
                    "type": "string",
                    "enum": [
                      "fun",
                      "professional",
                      "bold",
                      "genz"
                    ]
                  }
                },
                "required": [
                  "topic",
                  "platform"
                ],
                "additionalProperties": false
              },
              "example": {
                "topic": "Grand opening of our new coffee shop",
                "platform": "instagram",
                "tone": "fun"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "description": "One caption, hashtags included"
                      },
                      "description": "Three captions, one per style",
                      "example": [
                        "Grand opening of our new coffee shop! #grandopening #coffeeshop"
                      ]
                    },
                    "hashtags": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "description": "A hashtag"
                      },
                      "description": "The hashtags used in the captions",
                      "example": [
                        "#grandopening",
                        "#coffeeshop"
                      ]
                    }
                  },
                  "required": [
                    "result",
                    "hashtags"
                  ]
                },
                "example": {
                  "result": [
                    "Grand opening of our new coffee shop! 🎉\nTag a friend who needs to see this.\n\n#grandopening #coffeeshop #shop #coffee #opening #instagood",
                    "Ready for this?\nGrand opening of our new coffee shop. ✨\nTag a friend who needs to see this.\n\n#grandopening #coffeeshop #shop #coffee #opening #instagood",
                    "Pure good vibes: grand opening of our new coffee shop 😄\nTag a friend who needs to see this.\n\n#grandopening #coffeeshop #shop #coffee #opening #instagood"
                  ],
                  "hashtags": [
                    "#grandopening",
                    "#coffeeshop",
                    "#shop",
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input. Body: {error, code, details: {fieldErrors, formErrors, issues}}; error is a plain sentence naming the field, code is invalid_input or a specific code, issues lists each problem as {path, message, code}."
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/paraphrase": {
      "post": {
        "summary": "Rewrite English text with rule-based phrase and word changes (not AI) and return the result",
        "operationId": "textParaphrase",
        "description": "A rule-based paraphraser, NOT an AI model: obvious grammar mistakes in the input (the same patterns /v1/text/grammar-check fixes, for example 'Me and him goes') are corrected first and listed in 'grammarFixes' so the rewrite does not repeat them; then it applies a built-in dictionary of about 250 phrase, word and contraction rules (each inflected form counted separately and written out so the grammar stays correct (buy/buys/bought/buying -> purchase/purchases/purchased/purchasing)), plus a few sentence patterns. It does not understand meaning, so it will never rewrite freely; text with nothing in its dictionary comes back unchanged with changed:false and a note saying so. 'strength' (optional, default medium): 'low' = phrase swaps (in order to -> to, a lot of -> plenty of, I think -> I believe), openers (But -> However,, Hi -> Hello) and thanks/please phrasing; 'medium' = low + word swaps (big -> large, problem -> issue, use -> utilize, quickly -> rapidly) and contractions expanded (or contracted when the text has none); 'high' = medium + more word swaps, we will -> we're going to, can -> is able to, need to -> have to, and clause moves: 'She was late because the bus broke down.' -> 'Because the bus broke down, she was late.', 'We launched it last week.' -> 'Last week, we launched it.', and ', but' / ', so' become a new sentence starting 'However,' / 'As a result,'. 'light' and 'strong' are accepted as older names for low and high. If the chosen strength changes nothing but a higher one would, the higher one is used automatically ('strengthApplied' and 'note' say so), so any text that contains at least one dictionary word or phrase always changes. Clause moves only happen when the main clause starts with a pronoun or article (never a name or a command), and URLs, emails, #hashtags, @mentions and `code` are never touched. 'changes' lists every swap (from, to, kind). Always read the result: it keeps the meaning of what it changes but can sound stiff. Line breaks are preserved. English only. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 20000,
                    "description": "English text to rewrite (up to 20,000 characters). Line breaks are kept."
                  },
                  "strength": {
                    "description": "low: phrase swaps and openers only. medium (default): + word swaps and contractions. high: + more words, will/can rewrites and clause moves. 'light' and 'strong' are accepted as older names for low and high. If the chosen strength changes nothing but a higher one can, the higher one is used and strengthApplied says so.",
                    "type": "string",
                    "enum": [
                      "low",
                      "medium",
                      "high",
                      "light",
                      "strong"
                    ]
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "We want to help the team use a simple method to improve the product quickly.",
                "strength": "medium"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "original": {
                          "type": "string",
                          "description": "Your text"
                        },
                        "paraphrased": {
                          "type": "string",
                          "description": "The rewritten text (the same text when changed is false)"
                        },
                        "changed": {
                          "type": "boolean",
                          "description": "Whether anything was rewritten"
                        },
                        "strength": {
                          "type": "string",
                          "description": "low, medium or high as requested"
                        },
                        "strengthApplied": {
                          "type": "string",
                          "description": "The strength actually used"
                        },
                        "changes": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "from": {
                                "type": "string",
                                "description": "Original wording"
                              },
                              "to": {
                                "type": "string",
                                "description": "New wording"
                              },
                              "kind": {
                                "type": "string",
                                "description": "phrase, word, contraction or structure"
                              }
                            },
                            "required": [
                              "from",
                              "to",
                              "kind"
                            ]
                          },
                          "description": "Each swap that was made"
                        },
                        "method": {
                          "type": "string",
                          "description": "Always says the paraphraser is rule based, not an AI model"
                        },
                        "note": {
                          "type": "string",
                          "description": "Why nothing changed, or that the strength was raised"
                        },
                        "grammarFixes": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "description": "A correction"
                          },
                          "description": "Grammar mistakes in the input that were corrected before rewriting (only present when there were any)"
                        }
                      },
                      "required": [
                        "original",
                        "paraphrased",
                        "changed",
                        "strength",
                        "strengthApplied",
                        "changes",
                        "method"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Paraphraser",
                  "result": {
                    "original": "We want to help the team use a simple method to improve the product quickly.",
                    "paraphrased": "We would like to help the team utilize a straightforward approach to improve the product rapidly.",
                    "changed": true,
                    "strength": "medium",
                    "strengthApplied": "medium",
                    "changes": [
                      {
                        "from": "want to",
                        "to": "would like to",
                        "kind": "phrase"
                      },
                      {
                        "from": "use",
                        "to": "utilize",
                        "kind": "word"
                      },
                      {
                        "from": "simple",
                        "to": "straightforward",
                        "kind": "word"
                      },
                      "..."
                    ],
                    "method": "rule-based (built-in phrase and word dictionary plus sentence patterns, not an AI model)"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or empty text, text over 20,000 characters, or an unknown strength (the message lists the valid values)"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/mortgage": {
      "post": {
        "summary": "Mortgage: monthly payment with taxes, insurance, PMI and HOA, extra payments, biweekly, payoff date, yearly table and DTI",
        "operationId": "convertersMortgage",
        "description": "Send 'homePrice', 'ratePct' and 'years' with 'downPayment' (amount) or 'downPaymentPct'. Returns 'monthly' (principal and interest, property tax from 'propertyTaxPct' or 'propertyTaxAnnual', 'homeInsuranceAnnual' as a monthly share, 'hoaMonthly', mortgage insurance and 'maintenanceAndOther'), 'payoff' (payments, total interest, total paid to lender), a 15 against 30 year 'comparison' (or your 'compareYears'), a 'biweekly' plan, and 'costGrowth' when you send 'taxGrowthPct', 'insuranceGrowthPct' or 'hoaGrowthPct'. 'loanType' conventional (PMI under 20% down, ends at 78% of the original value; override with 'pmiRatePct'), fha (upfront and annual mortgage insurance premium from the FHA table) or va ('vaUse' first or subsequent funding fee). 'extraMonthly', 'oneTimeExtra' and 'yearlyExtra' add a payoff-date and interest-saved block, with real calendar dates when 'firstPaymentDate' is sent. 'includeYearly' adds a year-by-year table. 'annualIncome' or 'monthlyIncome' with 'otherMonthlyDebts' adds the front-end and back-end debt-to-income ratios against the 28/36 guideline. Who calls it: mortgage and real-estate sites, lender and broker widgets, home-buying apps, budgeting tools, chatbots and MCP agents. Worked example: {\"homePrice\":400000,\"downPaymentPct\":20,\"ratePct\":6.5,\"years\":30,\"propertyTaxPct\":1.1,\"homeInsuranceAnnual\":1200} returns principal and interest 2,022.62, tax 366.67, insurance 100.00, total 2,489.28 a month, and 408,142.36 total interest (checked independently with the closed-form payment formula). Integration scenario: a listing page shows the all-in monthly cost for each home with the user's down payment, switching to FHA or VA with one field. Same engine as the FreeDailyPro mortgage calculator, so site and API agree. Rates, taxes and insurance are your inputs; the FHA and VA tables carry their own dates in 'sources'. Estimate, not a loan offer. Pure arithmetic from the request: no customer data is stored. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Mortgage & Loans"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "homePrice": {
                    "type": "number",
                    "description": "Purchase price."
                  },
                  "downPayment": {
                    "description": "Down payment as an amount. Send this or downPaymentPct (default 20%).",
                    "type": "number"
                  },
                  "downPaymentPct": {
                    "description": "Down payment as a percent of the price.",
                    "type": "number"
                  },
                  "ratePct": {
                    "type": "number",
                    "description": "Annual interest rate in percent."
                  },
                  "years": {
                    "type": "number",
                    "description": "Term in years, 1 to 50."
                  },
                  "propertyTaxPct": {
                    "description": "Yearly property tax as a percent of the price. Send this or propertyTaxAnnual.",
                    "type": "number"
                  },
                  "propertyTaxAnnual": {
                    "description": "Yearly property tax as an amount.",
                    "type": "number"
                  },
                  "homeInsuranceAnnual": {
                    "description": "Yearly homeowners insurance.",
                    "type": "number"
                  },
                  "hoaMonthly": {
                    "description": "Monthly HOA dues.",
                    "type": "number"
                  },
                  "maintenanceMonthly": {
                    "description": "Monthly maintenance and other costs (shown in the total, left out of the debt-to-income housing figure).",
                    "type": "number"
                  },
                  "pmiRatePct": {
                    "description": "Conventional PMI rate, percent of the loan a year (default 0.6). Applies only above 80% loan-to-value and stops at 78% of the original price.",
                    "type": "number"
                  },
                  "loanType": {
                    "description": "Default conventional. FHA, VA and USDA add their standard fees (see sources in the response).",
                    "type": "string",
                    "enum": [
                      "conventional",
                      "fha",
                      "va",
                      "usda"
                    ]
                  },
                  "vaUse": {
                    "description": "VA funding fee class (VA loans only). Default first.",
                    "type": "string",
                    "enum": [
                      "first",
                      "subsequent",
                      "exempt"
                    ]
                  },
                  "extraMonthly": {
                    "description": "Extra principal paid every month.",
                    "type": "number"
                  },
                  "oneTimeExtra": {
                    "description": "One extra payment.",
                    "type": "object",
                    "properties": {
                      "month": {
                        "type": "number",
                        "description": "Payment number (1 to 600) the extra is paid with."
                      },
                      "amount": {
                        "type": "number"
                      }
                    },
                    "required": [
                      "month",
                      "amount"
                    ],
                    "additionalProperties": false
                  },
                  "yearlyExtra": {
                    "description": "One extra payment every year.",
                    "type": "object",
                    "properties": {
                      "amount": {
                        "type": "number"
                      },
                      "month": {
                        "description": "Payment number 1 to 12 of each loan year it is paid in (default 12).",
                        "type": "number"
                      }
                    },
                    "required": [
                      "amount"
                    ],
                    "additionalProperties": false
                  },
                  "firstPaymentDate": {
                    "description": "Date of the first payment, YYYY-MM-DD. Adds the payoff dates; it only labels the schedule.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  "closingCostPct": {
                    "description": "Closing costs as a percent of the price; adds closing costs and cash to close.",
                    "type": "number"
                  },
                  "annualIncome": {
                    "description": "Gross yearly income, for the debt-to-income check. Send this or monthlyIncome.",
                    "type": "number"
                  },
                  "monthlyIncome": {
                    "description": "Gross monthly income.",
                    "type": "number"
                  },
                  "otherMonthlyDebts": {
                    "description": "Other monthly debt payments (car, cards, student loans) for the back-end ratio.",
                    "type": "number"
                  },
                  "taxGrowthPct": {
                    "description": "Yearly increase of property tax in percent; any growth field adds a year-by-year costGrowth table.",
                    "type": "number"
                  },
                  "insuranceGrowthPct": {
                    "description": "Yearly increase of insurance (and maintenance) in percent.",
                    "type": "number"
                  },
                  "hoaGrowthPct": {
                    "description": "Yearly increase of HOA dues in percent.",
                    "type": "number"
                  },
                  "compareYears": {
                    "description": "The two terms to compare, default [15, 30].",
                    "type": "array",
                    "items": {}
                  },
                  "includeYearly": {
                    "description": "false leaves out the year-by-year table.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "homePrice",
                  "ratePct",
                  "years"
                ],
                "additionalProperties": false
              },
              "example": {
                "homePrice": 1,
                "ratePct": 1,
                "years": 1
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Mortgage calculator: payment with taxes, insurance, PMI and HOA, extra payments, biweekly and payoff date",
                  "result": {
                    "loanType": "conventional",
                    "loanAmount": 320000,
                    "baseLoan": 320000,
                    "financedUpfrontFee": 0,
                    "upfrontFeeLabel": null,
                    "downPayment": 80000,
                    "downPaymentPct": 20,
                    "loanToValuePct": 80,
                    "monthly": {
                      "principalAndInterest": 2022.62,
                      "propertyTax": 366.67,
                      "homeInsurance": 100,
                      "hoa": 0,
                      "mortgageInsurance": 0,
                      "mortgageInsuranceName": "PMI",
                      "maintenanceAndOther": 0,
                      "total": 2489.28,
                      "totalAfterMortgageInsuranceEnds": 2489.28
                    },
                    "mortgageInsurance": null,
                    "payoff": {
                      "payments": 360,
                      "years": 30,
                      "totalInterest": 408142.36,
                      "totalPaidToLender": 728142.36
                    },
                    "comparison": {
                      "shortYears": 15,
                      "longYears": 30,
                      "short": {
                        "payment": 2787.54,
                        "totalInterest": 181757.84
                      },
                      "long": {
                        "payment": 2022.62,
                        "totalInterest": 408142.36
                      },
                      "interestDifference": 226384.52,
                      "paymentDifference": 764.93,
                      "note": "Principal and interest only, no extra payments."
                    },
                    "biweekly": {
                      "payment": 1011.31,
                      "payments": 628,
                      "totalInterest": 314145.8,
                      "monthlyScheduleInterest": 408142.36,
                      "interestSaved": 93996.57,
                      "monthsSooner": 71,
                      "model": "Half of the monthly principal and interest every 14 days, interest at rate / 26 per period. A model: servicers that post biweekly payments only once a month save less."
                    },
                    "rulesAsOf": "2026-10-30",
                    "dataStatus": "estimate",
                    "sources": [
                      {
                        "item": "FHA mortgage insurance",
                        "rule": "Upfront 1.75% of the base loan, financed; annual MIP 0.50% or 0.55% (term over 15 years, loan-to-value up to 95% or above) and 0.15% or 0.40% (15 years or less, up to 90% or above); paid 11 years when loan-to-value is 90% or less, otherwise for the life of the loan; minimum 3.5% down",
                        "source": "HUD Mortgagee Letter 2023-05 (standard table, base loans within the FHA limit)",
                        "status": "estimate"
                      }
                    ],
                    "notes": [
                      "Conventional PMI applies while the loan is above 80% of the price and stops at 78% of the original price. FHA, VA and USDA fees follow the standard published schedules listed in sources (status: estimate)."
                    ],
                    "disclaimer": "Estimate for information only. Not financial, tax or legal advice; lenders, servicers and tax rules differ, so confirm the figures with the lender or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "A missing or out-of-range homePrice, rate or years, a down payment sent as both amount and percent, or an unknown loanType; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/refinance": {
      "post": {
        "summary": "Refinance break-even: monthly saving, simple and full-cost break-even month, and a net advantage table by years kept",
        "operationId": "convertersRefinance",
        "description": "Send the current loan ('currentBalance', 'currentRatePct' and 'remainingYears' or 'remainingMonths'; 'currentPayment' if you know it) and the offer ('newRatePct', 'newTermYears', 'closingCosts' or 'closingCostPct', 'financeClosingCosts' to roll the costs into the new loan). Returns both payments, 'monthlySaving', 'simpleBreakEvenMonths' (closing costs divided by the monthly saving) and 'fullCostBreakEvenMonth', which also counts the balance still owed on each loan, plus 'horizonTable' (net advantage after 1, 2, 3, 5, 7, 10 years and so on) and a plain-words 'verdict' and 'notes' (for example when the new term is longer than what is left). 'plannedYearsToKeep' adds the net advantage at that horizon. Who calls it: lender and broker tools, rate-alert and refinance-comparison sites, budgeting apps, chatbots and MCP agents. Worked example: {\"currentBalance\":300000,\"currentRatePct\":7,\"remainingYears\":28,\"newRatePct\":6,\"newTermYears\":30,\"closingCosts\":6000} returns payments 2,038.83 and 1,798.65, a saving of 240.17 a month, and break-even in month 25 (computed independently month by month). Integration scenario: a rate-alert email calls the endpoint with the user's loan and today's offer and states the break-even month. Rates and costs are your inputs; the endpoint holds no rate data. Estimate, not a loan offer. Pure arithmetic from the request: no customer data is stored. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Mortgage & Loans"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "currentBalance": {
                    "type": "number",
                    "description": "What you still owe on the current loan."
                  },
                  "currentRatePct": {
                    "type": "number",
                    "description": "Current annual rate in percent."
                  },
                  "remainingYears": {
                    "description": "Years left on the current loan. Send this or remainingMonths.",
                    "type": "number"
                  },
                  "remainingMonths": {
                    "description": "Months left on the current loan.",
                    "type": "number"
                  },
                  "currentPayment": {
                    "description": "Your actual principal-and-interest payment, if you do not want it calculated from balance, rate and time left.",
                    "type": "number"
                  },
                  "newRatePct": {
                    "type": "number",
                    "description": "Annual rate of the new loan in percent."
                  },
                  "newTermYears": {
                    "type": "number",
                    "description": "Term of the new loan in years."
                  },
                  "closingCosts": {
                    "description": "Closing costs as an amount. Send this or closingCostPct.",
                    "type": "number"
                  },
                  "closingCostPct": {
                    "description": "Closing costs as a percent of the current balance.",
                    "type": "number"
                  },
                  "financeClosingCosts": {
                    "description": "true adds the closing costs to the new loan instead of paying them in cash.",
                    "type": "boolean"
                  },
                  "plannedYearsToKeep": {
                    "description": "How long you expect to keep the loan; adds a worthIt answer for that horizon.",
                    "type": "number"
                  }
                },
                "required": [
                  "currentBalance",
                  "currentRatePct",
                  "newRatePct",
                  "newTermYears"
                ],
                "additionalProperties": false
              },
              "example": {
                "currentBalance": 250000,
                "currentRatePct": 7,
                "remainingYears": 27,
                "newRatePct": 5.75,
                "newTermYears": 30,
                "closingCosts": 4000
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Refinance break-even calculator: simple and full-cost break-even, interest difference and horizon table",
                  "result": {
                    "current": {
                      "balance": 300000,
                      "ratePct": 7,
                      "payment": 2038.83,
                      "paymentsLeft": 336,
                      "totalInterestRemaining": 385045.48
                    },
                    "refinanced": {
                      "loanAmount": 300000,
                      "ratePct": 6,
                      "termMonths": 360,
                      "payment": 1798.65,
                      "totalInterest": 347514.57,
                      "closingCosts": 6000,
                      "closingCostsFinanced": false
                    },
                    "monthlySaving": 240.17,
                    "simpleBreakEvenMonths": 25,
                    "simpleBreakEvenYears": 2.08,
                    "fullCostBreakEvenMonth": 25,
                    "interestDifferenceOverLife": 37530.92,
                    "totalCostDifferenceOverLife": 31530.92,
                    "horizonTable": [
                      {
                        "years": 1,
                        "paymentsSaved": 2882.09,
                        "closingCostsPaidInCash": 6000,
                        "balanceDifference": 104.74,
                        "netAdvantage": -3013.17
                      }
                    ],
                    "verdict": "Pays back after 25 months (2.08 years) counting payments, closing costs and what is still owed; worth it only if you keep the loan longer than that.",
                    "method": "Net advantage at month m = payments saved up to m - closing costs paid in cash + (balance left on the current loan - balance left on the new loan). The simple break-even is closing costs / monthly saving.",
                    "notes": [
                      "The new term (360 payments) is longer than what is left on the current loan (336), so part of the lower payment comes from stretching the loan. Compare total interest, not only the payment."
                    ],
                    "sources": "Calculation only; no rate or fee table is used. Rates and closing costs are the figures you send.",
                    "disclaimer": "Estimate for information only. Not financial, tax or legal advice; lenders, servicers and tax rules differ, so confirm the figures with the lender or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "A missing or out-of-range balance, rate or term, or closing costs sent as both amount and percent; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/affordability": {
      "post": {
        "summary": "Home affordability: the home price you can afford from income and debts, with the 28/36 guideline, a stretch case and a price check",
        "operationId": "convertersAffordability",
        "description": "Send 'annualIncome' (or 'monthlyIncome'), 'otherMonthlyDebts', 'ratePct', and a 'downPayment' or 'downPaymentPct' (default 20%), with optional 'years', 'propertyTaxPct', 'homeInsuranceAnnual', 'hoaMonthly', 'pmiRatePct', 'loanType' and 'vaUse'. The largest housing payment is the smaller of the front-end limit (share of income) and the back-end limit (share of income minus other debts); the home price is the highest price whose full payment (principal and interest, tax, insurance, HOA, mortgage insurance) fits. 'guideline' uses the 28% / 36% rule, 'stretch' 31% / 43%; 'maxFrontEndPct' and 'maxBackEndPct' add a 'custom' case, and 'homePrice' adds a 'homePriceCheck' of the ratios for a house you are looking at. Each case returns the price, down payment, loan, monthly breakdown, which ratio binds and the resulting ratios. Who calls it: real-estate and mortgage sites, pre-approval widgets, budgeting apps, chatbots and MCP agents. Worked example: {\"annualIncome\":96000,\"otherMonthlyDebts\":500,\"ratePct\":6.5,\"homeInsuranceAnnual\":1200} returns a guideline payment of 2,240 (the front-end ratio binds) for a 358,266 home, and a stretch payment of 2,480 for 398,445 (verified by recomputing the payment for those prices). Integration scenario: a search page filters listings to those under the user's guideline price and flags stretch ones. The ratios are guidelines lenders use, not a lender's decision; your own rate, tax and insurance numbers drive the answer. Pure arithmetic from the request: no customer data is stored. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Mortgage & Loans"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "annualIncome": {
                    "description": "Gross yearly income. Send this or monthlyIncome.",
                    "type": "number"
                  },
                  "monthlyIncome": {
                    "description": "Gross monthly income.",
                    "type": "number"
                  },
                  "otherMonthlyDebts": {
                    "description": "Other monthly debt payments (car, cards, student loans).",
                    "type": "number"
                  },
                  "downPayment": {
                    "description": "Down payment as an amount. Send this or downPaymentPct (default 20%).",
                    "type": "number"
                  },
                  "downPaymentPct": {
                    "description": "Down payment as a percent of the price.",
                    "type": "number"
                  },
                  "ratePct": {
                    "type": "number",
                    "description": "Annual mortgage rate in percent."
                  },
                  "years": {
                    "description": "Term in years (default 30).",
                    "type": "number"
                  },
                  "propertyTaxPct": {
                    "description": "Yearly property tax as a percent of the price (default 1.1).",
                    "type": "number"
                  },
                  "homeInsuranceAnnual": {
                    "description": "Yearly homeowners insurance.",
                    "type": "number"
                  },
                  "hoaMonthly": {
                    "description": "Monthly HOA dues.",
                    "type": "number"
                  },
                  "pmiRatePct": {
                    "description": "Conventional PMI rate in percent of the loan a year (default 0.6).",
                    "type": "number"
                  },
                  "loanType": {
                    "description": "Default conventional.",
                    "type": "string",
                    "enum": [
                      "conventional",
                      "fha",
                      "va",
                      "usda"
                    ]
                  },
                  "vaUse": {
                    "description": "VA funding fee class (VA loans only).",
                    "type": "string",
                    "enum": [
                      "first",
                      "subsequent",
                      "exempt"
                    ]
                  },
                  "maxFrontEndPct": {
                    "description": "Your own housing-ratio limit in percent. When either limit is sent the response has one 'custom' result instead of guideline and stretch.",
                    "type": "number"
                  },
                  "maxBackEndPct": {
                    "description": "Your own total-debt-ratio limit in percent.",
                    "type": "number"
                  },
                  "homePrice": {
                    "description": "A price to check: adds the front and back ratios and a verdict for it.",
                    "type": "number"
                  }
                },
                "required": [
                  "ratePct"
                ],
                "additionalProperties": false
              },
              "example": {
                "monthlyIncome": 8000,
                "otherMonthlyDebts": 600,
                "ratePct": 6.5,
                "years": 30,
                "downPayment": 40000
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Home affordability and debt-to-income calculator: maximum home price at the 28/36 guideline and 31/43 stretch limits",
                  "result": {
                    "grossMonthlyIncome": 8000,
                    "otherMonthlyDebts": 500,
                    "ratePct": 6.5,
                    "years": 30,
                    "loanType": "conventional",
                    "guideline": {
                      "frontLimitPct": 28,
                      "backLimitPct": 36,
                      "maxHousingPayment": 2240,
                      "binding": "housing ratio (front end)",
                      "maxHomePrice": 358266,
                      "downPayment": 71653.2,
                      "loanAmount": 286612.8,
                      "monthly": {
                        "principalAndInterest": 1811.59,
                        "propertyTax": 328.41,
                        "homeInsurance": 100,
                        "hoa": 0,
                        "mortgageInsurance": 0,
                        "total": 2240
                      },
                      "resultingFrontEndPct": 28,
                      "resultingBackEndPct": 34.25
                    },
                    "stretch": {
                      "frontLimitPct": 31,
                      "backLimitPct": 43,
                      "maxHousingPayment": 2480,
                      "binding": "housing ratio (front end)",
                      "maxHomePrice": 398445,
                      "downPayment": 79689,
                      "loanAmount": 318756,
                      "monthly": {
                        "principalAndInterest": 2014.75,
                        "propertyTax": 365.24,
                        "homeInsurance": 100,
                        "hoa": 0,
                        "mortgageInsurance": 0,
                        "total": 2480
                      },
                      "resultingFrontEndPct": 31,
                      "resultingBackEndPct": 37.25
                    },
                    "method": "Largest housing payment = the smaller of (front ratio x income) and (back ratio x income - other monthly debts). The home price is the highest price whose principal and interest, property tax, insurance, HOA and mortgage insurance fit that payment.",
                    "notes": [
                      "Guideline = 28% housing and 36% total debt; stretch = 31% and 43% (the benchmark FHA uses). Lenders also look at credit score, reserves and the loan programme, so approval can differ either way."
                    ],
                    "rulesAsOf": "2026-10-30",
                    "dataStatus": "estimate",
                    "sources": [
                      {
                        "item": "FHA mortgage insurance",
                        "rule": "Upfront 1.75% of the base loan, financed; annual MIP 0.50% or 0.55% (term over 15 years, loan-to-value up to 95% or above) and 0.15% or 0.40% (15 years or less, up to 90% or above); paid 11 years when loan-to-value is 90% or less, otherwise for the life of the loan; minimum 3.5% down",
                        "source": "HUD Mortgagee Letter 2023-05 (standard table, base loans within the FHA limit)",
                        "status": "estimate"
                      }
                    ],
                    "disclaimer": "Estimate for information only. Not financial, tax or legal advice; lenders, servicers and tax rules differ, so confirm the figures with the lender or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or out-of-range income or rate, both annualIncome and monthlyIncome, or a down payment of both amount and percent; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/debt-payoff": {
      "post": {
        "summary": "Debt payoff: avalanche and snowball side by side with payoff dates, total interest, order and a minimums-only baseline",
        "operationId": "convertersDebtPayoff",
        "description": "Send 'debts' (each with 'balance', 'aprPct', 'minPayment' and an optional 'name'; 1 to 30 debts) and either 'extraMonthly' (on top of the minimums) or 'totalMonthlyBudget' (the whole monthly amount, which must cover the minimums). 'strategy' avalanche, snowball or both (default both) chooses which plans are simulated; they come back beside 'minimumsOnly' (each debt paid on its own minimum with no rollover). Each plan has 'debtFreeInMonths', 'debtFreeIn', 'debtFreeDate' (counted from 'startDate'), 'totalInterest', 'totalPaid', 'payoffOrder' (month, date and interest per debt) and 'totalBalanceAtEndOfEachYear'. Freed-up minimums roll into the next debt. Who calls it: budgeting and debt-help apps, credit counselling tools, banks' financial-wellness features, chatbots and MCP agents. Worked example: three debts (5,000 at 22%, 3,000 at 15%, 800 at 8%, minimums 150, 90, 40) with 300 extra a month: avalanche 18 months and 1,200.11 interest, snowball 18 months and 1,443.55, minimums only 52 months and 3,764.66 (checked with an independent month-by-month script). Integration scenario: a wellness app lets the user add cards and shows how much the avalanche saves over the snowball, with the date the last debt is paid off. APRs and balances are your inputs; interest is monthly at APR / 12. Pure arithmetic from the request: no customer data is stored. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Retirement & Debt Planning"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "debts": {
                    "minItems": 1,
                    "maxItems": 30,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "balance": {
                          "type": "number",
                          "description": "Current balance."
                        },
                        "aprPct": {
                          "type": "number",
                          "description": "Annual interest rate in percent."
                        },
                        "minPayment": {
                          "type": "number",
                          "description": "Required minimum monthly payment."
                        }
                      },
                      "required": [
                        "balance",
                        "aprPct",
                        "minPayment"
                      ],
                      "additionalProperties": false
                    },
                    "description": "The debts to pay off, 1 to 30."
                  },
                  "extraMonthly": {
                    "description": "Money you can add each month on top of all the minimums. Send this or totalMonthlyBudget.",
                    "type": "number"
                  },
                  "totalMonthlyBudget": {
                    "description": "Total you can pay each month across all debts (at least the sum of the minimums).",
                    "type": "number"
                  },
                  "strategy": {
                    "description": "avalanche = highest rate first, snowball = smallest balance first, both (default) returns both and compares them.",
                    "type": "string",
                    "enum": [
                      "avalanche",
                      "snowball",
                      "both"
                    ]
                  },
                  "startDate": {
                    "description": "Date of the first payment, YYYY-MM-DD. Adds a payoff date for every debt and the debt-free date.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  }
                },
                "required": [
                  "debts"
                ],
                "additionalProperties": false
              },
              "example": {
                "debts": [
                  {
                    "balance": 1,
                    "aprPct": 1,
                    "minPayment": 1
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Debt payoff planner: avalanche and snowball plans with payoff dates, interest and a minimums-only baseline",
                  "result": {
                    "totalStartingBalance": 8800,
                    "sumOfMinimumPayments": 280,
                    "extraMonthly": 300,
                    "monthlyBudget": 580,
                    "avalanche": {
                      "rule": "Extra money goes to the highest interest rate first.",
                      "debtFreeInMonths": 18,
                      "debtFreeIn": "1 year 6 months",
                      "debtFreeDate": "2028-05-01",
                      "totalInterest": 1200.11,
                      "totalPaid": 10000.11,
                      "payoffOrder": [
                        {
                          "debt": "Card A",
                          "payoffMonth": 13,
                          "payoffDate": "2027-12-01",
                          "interestPaid": 643.17
                        }
                      ],
                      "totalBalanceAtEndOfEachYear": [
                        2932.03
                      ]
                    },
                    "snowball": {
                      "rule": "Extra money goes to the smallest balance first.",
                      "debtFreeInMonths": 18,
                      "debtFreeIn": "1 year 6 months",
                      "debtFreeDate": "2028-05-01",
                      "totalInterest": 1443.55,
                      "totalPaid": 10243.55,
                      "payoffOrder": [
                        {
                          "debt": "Car",
                          "payoffMonth": 3,
                          "payoffDate": "2027-02-01",
                          "interestPaid": 9.29
                        }
                      ],
                      "totalBalanceAtEndOfEachYear": [
                        3091.02
                      ]
                    },
                    "minimumsOnly": {
                      "rule": "Each debt gets only its own minimum, with no money rolled over when one is paid off.",
                      "debtFreeInMonths": 52,
                      "debtFreeIn": "4 years 4 months",
                      "debtFreeDate": "2031-03-01",
                      "totalInterest": 3764.66,
                      "totalPaid": 12564.66,
                      "payoffOrder": [
                        {
                          "debt": "Car",
                          "payoffMonth": 22,
                          "payoffDate": "2028-09-01",
                          "interestPaid": 61.5
                        }
                      ],
                      "totalBalanceAtEndOfEachYear": [
                        6918.15
                      ]
                    },
                    "comparison": {
                      "interestSavedByAvalanche": 243.44,
                      "monthsDifference": 0,
                      "lowerInterest": "avalanche",
                      "note": "Avalanche never costs more interest than snowball; snowball clears the first debt sooner, which some people find easier to stick with."
                    },
                    "savingsVsMinimumsOnly": {
                      "interest": 2564.55,
                      "monthsSooner": 34
                    },
                    "method": "Each month: interest = balance x APR / 12 on every open debt; every open debt gets its minimum (or what is left of the balance); the rest of the monthly budget goes to the target debt in order, carrying over to the next debt when one is cleared.",
                    "notes": [
                      "Interest is a plain monthly APR / 12 on the balance; real cards compound daily and add fees or new purchases, so statements differ by a little."
                    ],
                    "sources": "Calculation only; no rate table is used. Balances, rates and minimums are what you send.",
                    "disclaimer": "Estimate for information only. Not financial, tax or legal advice; lenders, servicers and tax rules differ, so confirm the figures with the lender or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "No debts or more than 30, a balance or minimum payment of 0 or less, an APR outside 0 to 100, extraMonthly together with totalMonthlyBudget, or a budget below the sum of the minimums; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/contribution-limits": {
      "post": {
        "summary": "Contribution limits: 401(k), SIMPLE, IRA and HSA limits by tax year with catch-ups, Roth phase-outs and IRA deduction limits",
        "operationId": "convertersContributionLimits",
        "description": "Send nothing for the latest table, or 'taxYear' (2025 and 2026 are in the table), 'age' (adds catch-up amounts: 50 and over, 60 to 63 super catch-up, HSA 55 and over), 'hsaCoverage' self or family, and optionally 'magi' with 'filingStatus' (and 'coveredByWorkplacePlan') to compute the reduced Roth IRA contribution and the traditional IRA deduction. Returns 'k401', 'simple', 'ira' and 'hsa' sections with 'totalForYourAge', plus 'taxYear', 'tableAsOf', 'availableYears', 'sources' (the notices the numbers come from), 'dataStatus' and 'nextReview'. An unsupported 'taxYear' is a 400 that lists the years held; the API does not guess future limits. Who calls it: payroll and HR tools, financial-planning and robo-advisor apps, benefits portals, chatbots and MCP agents. Worked example: {\"taxYear\":2026,\"age\":61,\"hsaCoverage\":\"family\"} returns 401(k) deferral 24,500 plus the 11,250 age 60 to 63 catch-up (35,750), IRA 7,500 plus 1,100 (8,600) and family HSA 8,750 plus 1,000 (9,750). Where the data comes from: IRS Notice 2025-67 (2026 retirement plan and IRA limits) and Rev. Proc. 2025-19 (2026 HSA), IRS Notice 2024-80 and Rev. Proc. 2024-25 (2025); the figures were read from secondary summaries and marked 'estimate' in dataStatus, so confirm them on irs.gov. Update process: one table file shared with the website, reviewed each November when the IRS publishes the next year's limits. Pure arithmetic from the request: no customer data is stored. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Retirement & Debt Planning"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "taxYear": {
                    "description": "Tax year, 2025 or 2026 (default: the latest in the table). Other years are a 400 that lists the years available.",
                    "type": "number"
                  },
                  "age": {
                    "description": "Age reached by the end of the year: adds the catch-up for 401(k) (50, and the larger 60 to 63 amount), IRA (50) and HSA (55) and the total for that age.",
                    "type": "number"
                  },
                  "hsaCoverage": {
                    "description": "HSA coverage in December: adds the limit for it.",
                    "type": "string",
                    "enum": [
                      "self",
                      "family"
                    ]
                  },
                  "magi": {
                    "description": "Modified adjusted gross income. With filingStatus: the Roth IRA contribution you are allowed after the income phase-out (and, with coveredByWorkplacePlan, the traditional IRA deduction). Phase-out ranges are in the table for 2026 only.",
                    "type": "number"
                  },
                  "filingStatus": {
                    "description": "Needed with magi.",
                    "type": "string",
                    "enum": [
                      "single",
                      "married-joint",
                      "married-separate",
                      "head-of-household"
                    ]
                  },
                  "coveredByWorkplacePlan": {
                    "description": "true adds the traditional IRA deduction phase-out for someone covered by a workplace plan.",
                    "type": "boolean"
                  }
                },
                "additionalProperties": false
              },
              "example": {}
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Retirement and HSA contribution limits by tax year: 401(k), SIMPLE, IRA, Roth phase-out and HSA",
                  "result": {
                    "taxYear": 2026,
                    "tableAsOf": "2026-10-30",
                    "availableYears": [
                      2025
                    ],
                    "age": 61,
                    "k401": {
                      "employeeDeferral": 24500,
                      "catchUp50": 8000,
                      "catchUp60to63": 11250,
                      "annualAdditionsLimit": 72000,
                      "compensationLimit": 360000,
                      "catchUpForYourAge": 11250,
                      "totalForYourAge": 35750
                    },
                    "simple": {
                      "employeeDeferral": 17000,
                      "catchUp50": 4000,
                      "catchUp60to63": 5250,
                      "totalForYourAge": 22250
                    },
                    "ira": {
                      "limit": 7500,
                      "catchUp50": 1100,
                      "totalForYourAge": 8600
                    },
                    "hsa": {
                      "selfOnly": 4400,
                      "family": 8750,
                      "catchUp55": 1000,
                      "yourCoverage": "family",
                      "limitForYourCoverage": 8750,
                      "totalForYourAge": 9750
                    },
                    "sources": {
                      "retirement": "IRS Notice 2025-67 (2026 retirement plan and IRA limits); read via an Ascensus summary",
                      "hsa": "IRS Rev. Proc. 2025-19 (2026 HSA); read via a Keiter CPA summary",
                      "table": "IRS Notice 2025-67 (2026 retirement plans and IRAs), Rev. Proc. 2025-19 (2026 HSA), Notice 2024-80 and Rev. Proc. 2024-25 (2025). Tax year 2025 and 2026. FreeDailyPro table last checked 2026-10-30 (compiled from secondary sources, confirm with the authority). Next review: November, when the IRS publishes next year's limits."
                    },
                    "dataStatus": "estimate",
                    "nextUpdate": "November, when the IRS publishes next year's limits",
                    "notes": [
                      "Catch-up rules: 401(k), 403(b) and governmental 457(b) catch-up from age 50, a larger one at 60 to 63; IRA catch-up from 50; HSA catch-up from 55. Ages are the age reached by the end of the calendar year."
                    ],
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "A taxYear not in the table (the body lists the available years), an age outside 0 to 120, a negative MAGI, or magi without filingStatus"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/retirement": {
      "post": {
        "summary": "Retirement and FIRE projection: nest egg in today's dollars, sustainable income, goal gap, FIRE number and drawdown by age",
        "operationId": "convertersRetirement",
        "description": "Send 'currentAge', 'retirementAge', 'currentSavings', 'annualContribution' and your assumptions ('expectedReturnPct', 'returnInRetirementPct', 'inflationPct', 'withdrawalRatePct', 'contributionGrowthPct', 'lifeExpectancyAge'), plus optionally 'desiredAnnualIncome' and 'otherAnnualIncome' (Social Security, pension; today's dollars). Returns 'atRetirement' (nest egg in today's dollars and nominal, contributions and growth), 'income' (what the withdrawal rate supports, yearly and monthly), 'goal' (nest egg needed, surplus or shortfall, extra yearly saving needed, and a 'financialIndependence' block with the FIRE number, years and age reached) and a 'drawdown' by age showing whether the money lasts to 'lifeExpectancyAge'. Returns are real (after inflation): (1 + return) / (1 + inflation) - 1. Return, inflation and withdrawal rate are assumptions you control (defaults 7%, 2.5%, 4%), never market data or a forecast; the response says so. Who calls it: retirement and robo-advisor tools, HR and benefits portals, FIRE communities, personal-finance apps, chatbots and MCP agents. Worked example: {\"currentAge\":35,\"retirementAge\":65,\"currentSavings\":100000,\"annualContribution\":10000,\"expectedReturnPct\":7,\"inflationPct\":2.5,\"withdrawalRatePct\":4,\"desiredAnnualIncome\":60000} returns a nest egg of 961,756.26 in today's dollars, 38,470.25 a year of sustainable income, a 1,500,000 requirement, a shortfall of 538,243.74 and 8,987.99 more to save each year (verified with an independent Python projection). Integration scenario: a benefits portal shows each employee whether they are on track and how much more per year closes the gap. Illustration, not investment advice. Pure arithmetic from the request: no customer data is stored. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Retirement & Debt Planning"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "currentAge": {
                    "type": "number",
                    "description": "Your age now (whole years)."
                  },
                  "retirementAge": {
                    "type": "number",
                    "description": "Age you plan to stop working."
                  },
                  "lifeExpectancyAge": {
                    "description": "Age the money must last to (default 95).",
                    "type": "number"
                  },
                  "currentSavings": {
                    "description": "Invested savings now.",
                    "type": "number"
                  },
                  "annualContribution": {
                    "description": "What you add each year, in today's dollars.",
                    "type": "number"
                  },
                  "contributionGrowthPct": {
                    "description": "Yearly real increase of the contribution in percent (default 0).",
                    "type": "number"
                  },
                  "expectedReturnPct": {
                    "description": "Expected nominal return before retirement, percent a year (default 7). An assumption, not market data.",
                    "type": "number"
                  },
                  "returnInRetirementPct": {
                    "description": "Expected nominal return during retirement (default: same as before retirement).",
                    "type": "number"
                  },
                  "inflationPct": {
                    "description": "Expected inflation, percent a year (default 2.5).",
                    "type": "number"
                  },
                  "withdrawalRatePct": {
                    "description": "Share of the nest egg withdrawn in the first year (default 4).",
                    "type": "number"
                  },
                  "desiredAnnualIncome": {
                    "description": "Income you want per year in today's dollars. Adds the nest egg needed, the gap, the extra saving needed and the years to financial independence.",
                    "type": "number"
                  },
                  "otherAnnualIncome": {
                    "description": "Pension or Social Security per year in today's dollars, counted from the retirement age (default 0).",
                    "type": "number"
                  }
                },
                "required": [
                  "currentAge",
                  "retirementAge"
                ],
                "additionalProperties": false
              },
              "example": {
                "currentAge": 1,
                "retirementAge": 1
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Retirement and FIRE projection: nest egg, sustainable income, gap and drawdown with inflation and a withdrawal rate",
                  "result": {
                    "assumptions": {
                      "currentAge": 35,
                      "retirementAge": 65,
                      "lifeExpectancyAge": 95,
                      "expectedReturnPct": 7,
                      "returnInRetirementPct": 7,
                      "inflationPct": 2.5,
                      "withdrawalRatePct": 4,
                      "realReturnPct": 4.39,
                      "contributionGrowthPct": 0,
                      "note": "Return, inflation and withdrawal rate are your assumptions (defaults 7%, 2.5%, 4%), not market data or a forecast. Amounts are in today's dollars unless the field says nominal."
                    },
                    "atRetirement": {
                      "yearsToRetirement": 30,
                      "nestEggToday": 961756.26,
                      "nestEggNominal": 2017348.76,
                      "totalContributed": 300000,
                      "growth": 561756.26
                    },
                    "income": {
                      "sustainableAtWithdrawalRate": 38470.25,
                      "sustainableMonthly": 3205.85,
                      "otherAnnualIncome": 0,
                      "totalAnnualIncomeToday": 38470.25,
                      "sustainableNominalFirstYear": 80693.95
                    },
                    "goal": {
                      "desiredAnnualIncomeToday": 60000,
                      "nestEggNeeded": 1500000,
                      "nestEggNeededNominal": 3146351.37,
                      "surplusOrShortfall": -538243.74,
                      "onTrack": false,
                      "extraAnnualSavingNeeded": 8987.99,
                      "financialIndependence": {
                        "number": 1500000,
                        "yearsToReach": 38.68,
                        "ageReached": 73.68,
                        "method": "Site FIRE calculator: contributions held constant in today's dollars, target = (desired income - other income) / withdrawal rate."
                      }
                    },
                    "drawdown": {
                      "annualSpendingToday": 60000,
                      "fundsLastToAge": 91,
                      "runsOutAtAge": 91,
                      "balanceAtLifeExpectancyToday": 0,
                      "rule": "Withdrawals are taken at the start of each year and rise with inflation; the rest grows at the retirement real return."
                    },
                    "accumulation": [
                      {
                        "age": 36,
                        "contribution": 10000,
                        "endBalanceReal": 114390.24,
                        "endBalanceNominal": 117250
                      }
                    ],
                    "drawdownByYear": [
                      {
                        "age": 65,
                        "startBalanceReal": 961756.26,
                        "withdrawalReal": 60000,
                        "withdrawalNominal": 125854.05,
                        "endBalanceReal": 941345.56
                      }
                    ],
                    "sources": "Calculation only; no tax table or market data. The 4% default is the common withdrawal-rate rule of thumb from the Trinity study; it is not a guarantee.",
                    "disclaimer": "Estimate for information only. Not financial, tax or legal advice; lenders, servicers and tax rules differ, so confirm the figures with the lender or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "A retirementAge below currentAge, a lifeExpectancyAge not above retirementAge, non-whole ages, or a value outside its allowed range; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/loan-interest": {
      "post": {
        "summary": "Loan and interest calculator: loan, simple interest and compound interest in one service, with APR, extra payments and inflation-adjusted growth",
        "operationId": "convertersLoanInterest",
        "description": "One endpoint for three jobs, chosen with 'kind': loan (everything the older /v1/converters/loan does: payment, APR with a fee, solveFor, paymentFrequency, compounding, deferred and zero-coupon, plus 'extraMonthly' for an early-payoff block and 'yearlySummary'), simple-interest ('principal', 'annualRatePercent', 'years'; 'compareWithCompound' adds what annual compounding would have earned) and compound-interest (adds 'frequency' annually, semiannually, quarterly, monthly or daily, 'monthlyContribution', 'contributeAtStart' and 'inflationPct' for a value in today's dollars, with a yearly balance table). The older paths /v1/converters/loan, /v1/converters/simple-interest and /v1/converters/compound-interest keep working unchanged; this one merges them. Who calls it: lender and comparison sites, savings and investing apps, education and accounting tools, chatbots and MCP agents. Worked example: {\"kind\":\"simple-interest\",\"principal\":10000,\"annualRatePercent\":5,\"years\":10,\"compareWithCompound\":true} returns 5,000 interest (total 15,000) against 16,288.95 with annual compounding, 1,288.95 more. Compound with 200 a month at 5% monthly for 10 years from 10,000 gives 47,526.55 (37,127.67 in today's dollars at 2.5% inflation); checked independently. Fields that belong to another kind are rejected rather than ignored. Pure arithmetic from the request: no customer data is stored. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Mortgage & Loans"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "loan",
                      "simple-interest",
                      "compound-interest"
                    ],
                    "description": "loan: payment, schedule and solving; simple-interest; compound-interest (with regular contributions and inflation)."
                  },
                  "principal": {
                    "description": "Amount. For kind loan it is required except when solveFor is 'amount'.",
                    "type": "number",
                    "minimum": 0
                  },
                  "annualRatePercent": {
                    "description": "Annual rate in percent.",
                    "type": "number",
                    "minimum": 0
                  },
                  "years": {
                    "description": "Term in years.",
                    "type": "number",
                    "minimum": 0
                  },
                  "startDate": {
                    "description": "Interest kinds: start date, YYYY-MM-DD; adds the maturity date.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  "firstPaymentDate": {
                    "description": "Loan: date of the first payment, YYYY-MM-DD; adds payment dates and the payoff date.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  "previewMonths": {
                    "description": "Loan: number of schedule rows to return, 0 to 12.",
                    "type": "number",
                    "minimum": 0
                  },
                  "paymentFrequency": {
                    "description": "Loan: payment frequency (default monthly).",
                    "type": "string",
                    "enum": [
                      "monthly",
                      "biweekly",
                      "weekly"
                    ]
                  },
                  "compounding": {
                    "description": "Loan: how interest compounds (default: on every payment).",
                    "type": "string",
                    "enum": [
                      "payment",
                      "annual",
                      "monthly",
                      "daily",
                      "continuous"
                    ]
                  },
                  "loanType": {
                    "description": "Loan: amortized (default), deferred or zeroCoupon.",
                    "type": "string",
                    "enum": [
                      "amortized",
                      "deferred",
                      "zeroCoupon"
                    ]
                  },
                  "fee": {
                    "description": "Loan: upfront fee; adds the APR and money received.",
                    "type": "number",
                    "minimum": 0
                  },
                  "solveFor": {
                    "description": "Loan: what to solve for; amount, term and rate need 'payment'.",
                    "type": "string",
                    "enum": [
                      "payment",
                      "amount",
                      "term",
                      "rate"
                    ]
                  },
                  "payment": {
                    "description": "Loan: target payment per period for solveFor amount, term or rate.",
                    "type": "number",
                    "minimum": 0
                  },
                  "extraMonthly": {
                    "description": "Plain monthly loan: extra principal each month; adds interest saved and payments saved.",
                    "type": "number",
                    "minimum": 0
                  },
                  "yearlySummary": {
                    "description": "Plain monthly loan: adds a year-by-year principal, interest and balance table.",
                    "type": "boolean"
                  },
                  "frequency": {
                    "description": "Compound interest: compounding frequency (default annually).",
                    "type": "string",
                    "enum": [
                      "annually",
                      "semiannually",
                      "quarterly",
                      "monthly",
                      "daily"
                    ]
                  },
                  "monthlyContribution": {
                    "description": "Compound interest: amount added every month (needs frequency monthly).",
                    "type": "number",
                    "minimum": 0
                  },
                  "contributeAtStart": {
                    "description": "Compound interest: true adds each contribution at the start of the month instead of the end.",
                    "type": "boolean"
                  },
                  "inflationPct": {
                    "description": "Compound interest: adds the future value in today's dollars.",
                    "type": "number"
                  },
                  "compareWithCompound": {
                    "description": "Simple interest: adds the result with annual compounding for comparison.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "kind"
                ],
                "additionalProperties": false
              },
              "example": {
                "kind": "loan",
                "principal": 20000,
                "annualRatePercent": 7.5,
                "years": 5
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Loan and interest calculator: loan payments, simple interest and compound interest with contributions in one endpoint",
                  "result": {
                    "kind": "simple-interest",
                    "principal": 10000,
                    "interest": 5000,
                    "totalAmount": 15000,
                    "comparedWithAnnualCompounding": {
                      "futureValue": 16288.95,
                      "interest": 6288.95,
                      "extraInterestFromCompounding": 1288.95
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "A missing or unknown kind, a missing principal or rate, a field that does not apply to the chosen kind, or a payment that never pays the loan off; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/converters/exchange-rates": {
      "post": {
        "summary": "Exchange rates: daily reference rates for about 200 currencies, crypto and metals, with a standard-set fallback, the as-of date and the source shown",
        "operationId": "convertersExchangeRates",
        "description": "Send 'amount' (default 1), 'from' (default USD) and 'to' (one code or a list of up to 20; required), optionally 'date' for a past day (YYYY-MM-DD, see Valid dates and errors below; a weekend or holiday returns the latest earlier working day with a 'dateNote'), or 'listCurrencies' true. Returns 'rates', 'converted', the rate 'date', 'source', 'sourceId' and a 'note'. Two sources: the broad set (sourceId reference-broad: daily rates for about 200 codes, namely ISO currencies plus common crypto assets and the metals XAU, XAG, XPT and XPD; tried first) and the standard set (sourceId reference-daily, about 30 currencies; the fallback). The optional 'source' picks one: auto (default: broad first, the standard set if the broad set cannot be fetched, with a providerNote saying so), broad (broad only, 502 if unavailable) or standard (standard set only). A history range ('startDate' with 'endDate', up to 366 days and 5 currencies) comes from the standard set only, so it needs standard-set currencies. 'listCurrencies' returns the codes with type (fiat, metal or other), a name where known, per-type counts and the date of the set. Limits: these are daily reference rates, refreshed about once a day, not live and not intraday; the response says 'live: false' and 'stale: true' with a warning when the newest data is more than 5 days old. They can differ from what a bank, card network or exchange charges, crypto and metal values are not tradable prices, and the broad set is a compiled daily set without a per-currency source list, so use them as reference only. Converted amounts are rounded to 2 decimals, or to 6 decimals when the result is under 0.01 so a small amount never shows as 0 (8 decimals for crypto and 'other' codes); 'amount' must be from 0.000001 to 1e12 (1,000,000,000,000), anything else is a 400. Valid dates and errors: Standard-set fiat currencies (about 30, for example USD, EUR, GBP, JPY, INR) have dated rates from 1999-01-04 up to today. Crypto (for example BTC), metals (XAU, XAG, XPT, XPD) and every other currency outside the standard list have dated rates from 2024-03-02 only. A dated request before 2024-03-02 for such a code, or with source broad, is answered with 400 before any provider is called, and the message names both start dates; standard-set currencies before 2024-03-02 are answered from the standard set with a providerNote. A date before 1999-01-04 or in the future is a 400. A 502 (with code rate_provider_unavailable) means only that the chosen provider could not be reached right now. Fallback: when neither provider can be reached, a latest-rates request (no date) is answered from a fixed built-in snapshot dated 2026-11-17 (publicly available reference rates of that day), refreshed monthly by hand and not updated at run time; that answer has source \"Built-in backup rates (dated 2026-11-17)\", sourceId built-in-snapshot, stale true, fallback true and a warning, so it cannot be mistaken for current data. A dated or range request is never answered from the snapshot. If neither source can be reached, a latest-rates request falls back to a labelled old built-in snapshot and a dated or range request returns 502 rather than made-up rates. Who calls it: invoicing and e-commerce tools, expense apps, dashboards, chatbots and MCP agents. Worked example: {\"amount\":100,\"from\":\"USD\",\"to\":[\"EUR\",\"BTC\"]} against a set dated 2026-10-31 with 1 USD = 0.86 EUR returns 86 EUR. Data: the rates are compiled once a day from publicly available sources into one consolidated set (market data only; nothing you send is stored), and every request reads the newest stored day. If no stored day can be read, a latest-rates request falls back to a labelled old built-in snapshot (sourceId built-in-snapshot, stale true, fallback true); backup rates are refreshed monthly. Source attributions are kept in the internal documentation, not in responses. Rates data notice: exchange rates are compiled from multiple publicly available sources. They are not live data. They are previous-day data, typically from the most recent business day (shown by the date or ratesAsOf field of the response), provided for your information only and to be used as reference. They are indicative, not live trading rates, and not the rate a bank or card will give you. FreeDailyPro does not provide trading guidance, investment advice or trading services. If a rights holder or data provider tells FreeDailyPro about restrictions on the use of any data, we will review the notice promptly and comply for future use. FreeDailyPro accepts no responsibility for how users apply this information, except where the public source page itself states that the data is restricted for use. To send a notice, use the Contact page: https://freedailypro.com/contact. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Calculators",
          "Currency & VAT"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "amount": {
                    "description": "Amount to convert (default 1), from 0.000001 to 1e12 (1,000,000,000,000); outside that range is a 400. Converted fiat values keep 2 decimals, or 6 when the result is under 0.01, so a small amount never rounds to 0; crypto and other codes keep 8.",
                    "type": "number",
                    "minimum": 0.000001,
                    "maximum": 1000000000000
                  },
                  "from": {
                    "description": "Currency code to convert from (default USD): ISO codes such as USD, plus crypto and metal codes in the broad set.",
                    "type": "string"
                  },
                  "to": {
                    "description": "Currency code, or a list of up to 20 codes, to convert to. Required unless listCurrencies is true.",
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    ]
                  },
                  "date": {
                    "description": "A past date, YYYY-MM-DD, up to today: the daily rate for that day. Standard-set fiat currencies go back to 1999-01-04; crypto, metals and the other broad-set currencies only from 2024-03-02, so a date before 2024-03-02 with BTC, XAU or any code outside the standard set, or with source broad, is a 400 that names both start dates. A future date or one before 1999-01-04 is a 400. On a weekend or holiday you get the latest earlier working day, with a dateNote. Example: 2024-03-15.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  "startDate": {
                    "description": "History: first day of a range of up to 366 days (send with endDate). Must be between 1999-01-04 and today. Example: 2024-01-02.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  "endDate": {
                    "description": "History: last day of the range, on or before today. Example: 2024-03-15.",
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  "listCurrencies": {
                    "description": "true returns the supported currency codes (with type and name) and the date of the latest rates.",
                    "type": "boolean"
                  },
                  "source": {
                    "description": "auto (default): the broad daily set of about 200 currencies, crypto and metals, falling back to the standard set; broad: only the broad set; standard: only the standard set (about 30 currencies, and the only one with history ranges).",
                    "type": "string",
                    "enum": [
                      "auto",
                      "broad",
                      "standard"
                    ]
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "from": "USD",
                "to": "EUR"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "result": {
                    "source": "Publicly available reference rates",
                    "sourceId": "reference-broad",
                    "note": "Previous-day reference rates, not live data: compiled from publicly available sources, they usually reflect the most recent business day (the date is in ratesAsOf or date) and are provided for information only, to be used as reference. They are not live trading rates and not the rate a bank or card will give you. FreeDailyPro does not provide trading guidance, investment advice or trading services. Crypto and metal values are daily reference values, not tradable prices.",
                    "live": false,
                    "from": "USD",
                    "amount": 100,
                    "date": "2026-10-31",
                    "stale": false,
                    "rates": {
                      "EUR": 0.86,
                      "GBP": 0.75
                    },
                    "converted": {
                      "EUR": 86,
                      "GBP": 75
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "A malformed currency code or date, a date in the future or before 1999-01-04, a dated request before 2024-03-02 for crypto, metals, another currency outside the standard set or source broad (the message names both start dates), an amount below 0.000001 or above 1e12, a missing 'to', more than 20 currencies (5 for a history), a range over 366 days, a startDate after endDate, source broad with a date range, or a code with no rate in the chosen set; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          },
          "502": {
            "description": "The chosen rate source could not be reached right now (source broad, a past date or a date range). The body is {error, code: rate_provider_unavailable}; a latest request in auto mode falls back to a labelled built-in snapshot instead"
          }
        }
      }
    },
    "/v1/converters/vat-validate": {
      "post": {
        "summary": "Validate an EU VAT number: layout check per member state plus a live VIES lookup",
        "operationId": "convertersVatValidate",
        "description": "Send 'vatNumber' (for example DE123456789, spaces and dots allowed) and optionally 'country' when the number has no prefix, and 'offlineOnly' true to skip the live lookup. Step 1 is an offline layout check against the national format of each EU member state (plus XI for Northern Ireland goods; Greece is EL, GR is accepted). A number that fails it returns valid false, checked 'format' and a reason, and is never sent to VIES. Step 2 asks the European Commission's VIES service whether the number is registered for intra-EU trade: the answer is valid true or false, checked 'vies', with the registered name and address when the member state shares them and the request date. Limits: a good layout does not prove registration (only VIES does), the UK (GB) is no longer in VIES, and VIES is often down for single member states. When VIES does not answer the endpoint returns 503 with a plain message, which is not billed, instead of guessing; results are cached in memory for 10 minutes and nothing is stored. VIES confirms a number exists, not that a business is trustworthy. The live call could not be made from the build environment, so the tests use a mocked provider and one real lookup must be checked after deploy. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Currency & VAT"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "vatNumber": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 40,
                    "description": "The EU VAT number, with or without the two-letter prefix and with spaces or dots, for example DE123456789 or 'DE 123.456.789'."
                  },
                  "country": {
                    "description": "Two-letter country code when vatNumber has no prefix (Greece is EL).",
                    "type": "string"
                  },
                  "offlineOnly": {
                    "description": "true checks only the number layout and skips the live VIES lookup.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "vatNumber"
                ],
                "additionalProperties": false
              },
              "example": {
                "vatNumber": "DE123456789"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "result": {
                    "vatNumber": "DE123456789",
                    "country": "DE",
                    "countryName": "Germany",
                    "formatValid": true,
                    "valid": true,
                    "checked": "vies",
                    "name": "EXAMPLE GMBH",
                    "address": "MUSTERSTRASSE 1, 10115 BERLIN",
                    "requestDate": "2026-11-01",
                    "note": "valid true means the number is registered for intra-EU trade in VIES at the request date. Some member states return no name or address."
                  }
                }
              }
            }
          },
          "400": {
            "description": "vatNumber is missing, has no country prefix and no country was sent, or country is not two letters; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          },
          "503": {
            "description": "VIES did not answer, so nothing was checked; try again later",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds to wait before retrying"
              }
            }
          }
        }
      }
    },
    "/v1/converters/vat-rates": {
      "post": {
        "summary": "VAT and GST rates: standard and reduced rates for 61 countries and Canadian province groups with a data version, as-of date and verification note per country",
        "operationId": "convertersVatRates",
        "description": "Send nothing for the whole table, or 'country' (name or ISO code), 'region' (eu, other-europe, canada, asia-pacific, middle-east-africa, americas) or 'currency' to filter. Returns 'rates' (country, region, standardRatePct, reducedRatesPct, currency, and a 'verification' note saying how that row was checked), plus 'dataVersion', 'asOf', 'taxYear', 'tableLastEntered', 'euStandardRatesComparedOn', 'count', 'sources', 'dataStatus' ('estimate'), 'nextReview' and 'notes'. Standard and common reduced rates only: zero rates, exemptions, thresholds, special schemes and regional rates (apart from the Canadian provinces) are not included. Who calls it: invoicing and e-commerce checkouts, accounting tools, marketplace sellers, cross-border pricing, chatbots and MCP agents. Worked example: an empty body returns 59 rows, dataVersion 2026-10; {\"country\":\"Austria\"} returns standard 20% with the reduced rates. EU standard rates were compared with a published 2026 table on 30 Oct 2026; reduced rates and non-EU rows were compiled from national sources by FreeDailyPro and not all re-verified, so each row says so; confirm with the tax authority before invoicing. Update process: one table file shared with the website, reviewed each January. Use the VAT/GST calculator endpoint (/v1/converters/vat-gst) to apply a rate to an amount. Pure arithmetic from the request: no customer data is stored. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Calculators",
          "Currency & VAT"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "country": {
                    "description": "A country name, or a list of names (for example Germany, UK, Canada - Ontario HST). Leave out for the whole table.",
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    ]
                  },
                  "region": {
                    "description": "Only the countries of one region.",
                    "type": "string",
                    "enum": [
                      "eu",
                      "other-europe",
                      "canada",
                      "asia-pacific",
                      "middle-east-africa",
                      "americas"
                    ]
                  },
                  "currency": {
                    "description": "Only the countries that use this currency code, for example EUR.",
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "example": {}
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "result": {
                    "dataVersion": "2026-10",
                    "asOf": "October 2026",
                    "taxYear": 2026,
                    "tableLastEntered": "2026-10-11",
                    "euStandardRatesComparedOn": "2026-10-30",
                    "count": 59,
                    "rates": [
                      {
                        "country": "Austria",
                        "region": "eu",
                        "standardRatePct": 20,
                        "reducedRatesPct": [
                          13
                        ],
                        "currency": "EUR",
                        "verification": "standard rate compared with a published 2026 table on 30 Oct 2026; reduced rates compiled from memory of national sources"
                      }
                    ],
                    "sources": "Each country's tax authority. Tax year 2026. FreeDailyPro table last checked 2026-10-11 (compiled from secondary sources, confirm with the authority). Next review: January.",
                    "dataStatus": "estimate",
                    "nextReview": "January",
                    "notes": [
                      "Standard and common reduced rates only. Zero rates, exemptions, thresholds, special schemes and regional rates (apart from the Canadian provinces listed) are not included."
                    ],
                    "disclaimer": "Estimate for information only. Not tax, legal or financial advice; check the figures with the tax authority or a qualified adviser."
                  }
                }
              }
            }
          },
          "400": {
            "description": "An unknown region (the body lists the valid ones)"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/bank-statement-to-csv": {
      "post": {
        "summary": "Turn a bank statement (text-based PDF or pasted text) into transactions, CSV and a balance check",
        "operationId": "businessBankStatementToCsv",
        "description": "Send the statement as a text-based PDF or as pasted text and get dated transactions, a CSV, the opening and closing balances found, and a reconciliation that checks the rows against the printed balances. Three ways to send it: JSON with text; JSON with fileBase64 (the PDF, base64 encoded); or multipart/form-data with the PDF under the field file (plus the other options as form fields). A PDF can be up to 20 MB and 100 pages. For a PDF the text and its positions are read from the file and rebuilt into lines, then the same parser reads them; the response adds source {type, pages, characters}, and includeText:true returns the lines that were read as extractedText. year fills in dates that print no year; dateOrder (auto, mdy, dmy) and numberFormat (auto, us for 1,234.56, eu for 1.234,56) are detected unless set; flipSigns reverses signs for card statements that print purchases as positive. categorize:true adds a category to each row from a short list of generic keywords, and categoryRules (your own {match, category} pairs, first match wins) apply before them; either one adds a category column to the CSV, a category on every transaction and categoryTotals (moneyOut, moneyIn, net and count per category). The categories are rule-based, not a merchant database: unmatched rows are Uncategorized, so check them. Limits: statements whose PDF has no text layer (scans and photos) are refused with a 422 because OCR is not supported; password-protected PDFs are refused; layouts differ a lot between banks, so check the reconciliation and skippedLines, and a PDF from which no transaction could be read returns a 422 with a hint instead of an empty result. No statement is stored. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Documents",
          "Bookkeeping"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "description": "The statement as pasted text. Send this, or a PDF in fileBase64 (or as the multipart field file).",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2000000
                  },
                  "fileBase64": {
                    "description": "A text-based PDF statement, base64 encoded, up to 20 MB and 100 pages. Scanned or photographed PDFs are refused with a 422: there is no OCR.",
                    "type": "string",
                    "minLength": 8,
                    "maxLength": 28000000
                  },
                  "year": {
                    "type": "integer",
                    "minimum": 1990,
                    "maximum": 2100
                  },
                  "dateOrder": {
                    "type": "string",
                    "enum": [
                      "auto",
                      "mdy",
                      "dmy"
                    ]
                  },
                  "numberFormat": {
                    "type": "string",
                    "enum": [
                      "auto",
                      "us",
                      "eu"
                    ]
                  },
                  "flipSigns": {
                    "type": "boolean"
                  },
                  "categorize": {
                    "description": "true adds a category to every row from a short list of generic keywords (not a merchant database). Default false.",
                    "type": "boolean"
                  },
                  "categoryRules": {
                    "description": "Your own rules: a row whose description contains match (any case) gets that category; the first matching rule wins, before the built-in keywords.",
                    "maxItems": 200,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "match": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        "category": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 60
                        }
                      },
                      "required": [
                        "match",
                        "category"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "includeText": {
                    "description": "true adds the lines read from the PDF to the response as extractedText, to see what the parser saw.",
                    "type": "boolean"
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "text": "Date Description Amount Balance\n10/01 Opening balance 2,500.00\n10/03 GROCERY MART #14 -62.18 2,437.82\n10/05 PAYROLL ACME INC 1,950.00 4,387.82\n10/09 CITY POWER -118.40 4,269.42",
                "year": 2026,
                "dateOrder": "mdy",
                "numberFormat": "us"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Bank statement to CSV client and server side from freedailypro",
                  "result": {
                    "transactions": [
                      {
                        "date": "2026-10-03",
                        "description": "GROCERY MART #14",
                        "amount": -62.18,
                        "balance": 2437.82,
                        "signGuess": false
                      },
                      {
                        "date": "2026-10-05",
                        "description": "PAYROLL ACME INC",
                        "amount": 1950,
                        "balance": 4387.82,
                        "signGuess": false
                      },
                      {
                        "date": "2026-10-09",
                        "description": "CITY POWER",
                        "amount": -118.4,
                        "balance": 4269.42,
                        "signGuess": false
                      }
                    ],
                    "openingBalance": 2500,
                    "closingBalance": null,
                    "dateOrder": "mdy",
                    "numberFormat": "us",
                    "cardLayout": false,
                    "skippedLines": [],
                    "reconciliation": {
                      "basis": "balances",
                      "ok": true,
                      "total": 1769.42,
                      "mismatchedRows": [],
                      "difference": null,
                      "message": "All 3 running balances follow from the rows."
                    },
                    "csv": "Date,Description,Amount,Balance\n2026-10-03,GROCERY MART #14,-62.18,2437.82\n2026-10-05,PAYROLL ACME INC,1950,4387.82\n2026-10-09,CITY POWER,-118.4,4269.42"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Neither text nor a PDF was sent, both were sent, an option is invalid, or the PDF is over 20 MB or 100 pages; the body says which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "422": {
            "description": "The PDF cannot be read: it is a scan or photo with no text layer (OCR is not supported), password-protected, damaged, not a PDF, or no transactions could be recognised in its text; the body says which"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/blind-cv": {
      "post": {
        "summary": "Remove names and contact details from a CV for fair screening",
        "operationId": "businessBlindCv",
        "description": "Remove names and contact details from a CV for fair screening. Send JSON with text (required); optional: names, custom, removeEmail, removePhone, removeLinks, removeAddress, removeBirth, removePersonal, removeGender, removeYears, labels. Returns JSON with text, counts, removed, nameUsed (inside result). Limits: text: up to 500000 characters; names: up to 500 characters; custom: up to 5000 characters. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500000
                  },
                  "names": {
                    "type": "string",
                    "maxLength": 500
                  },
                  "custom": {
                    "type": "string",
                    "maxLength": 5000
                  },
                  "removeEmail": {
                    "type": "boolean"
                  },
                  "removePhone": {
                    "type": "boolean"
                  },
                  "removeLinks": {
                    "type": "boolean"
                  },
                  "removeAddress": {
                    "type": "boolean"
                  },
                  "removeBirth": {
                    "type": "boolean"
                  },
                  "removePersonal": {
                    "type": "boolean"
                  },
                  "removeGender": {
                    "type": "boolean"
                  },
                  "removeYears": {
                    "type": "boolean"
                  },
                  "labels": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Maria Lopez\nmaria@example.com | +1 555 0100\n14 Elm Street, Austin, TX\n\nOperations Manager, Harbor Coffee, 2018-2026\nLed a team of 12 and cut order errors by 40%.",
                "names": "Maria Lopez",
                "removeEmail": true,
                "removePhone": true,
                "removeAddress": true
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Blind CV redactor client and server side from freedailypro",
                  "result": {
                    "text": "[NAME]\n[EMAIL] | +1 555 0100\n[ADDRESS], TX\n\nOperations Manager, Harbor Coffee, 2018-2026\nLed a team of 12 and cut order errors by 40%.",
                    "counts": {
                      "name": 1,
                      "email": 1,
                      "address": 1
                    },
                    "removed": 3,
                    "nameUsed": "Maria Lopez"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/publishing/isbn": {
      "post": {
        "summary": "Check an ISBN-10 or ISBN-13, convert between them and hyphenate",
        "operationId": "publishingIsbn",
        "description": "Validates the check digit of an ISBN-10 or ISBN-13 (hyphens, spaces and a leading 'ISBN' are ignored), converts it to the other form and writes it with hyphens. When the check digit is wrong, valid is false and expectedCheck says what it should be; isbn10/isbn13 are then built from the corrected digit and convertedFromCorrected is true. Hyphenation uses the International ISBN Agency RangeMessage for every 978 and 979 registration group (287 groups); rangesVersion is the date of that RangeMessage, currently 2026-10-30, and the table is generated from it, not hand-written. A number in a range the agency has not assigned (or in an unassigned group) is still validated and converted but comes back without hyphens, with rangeStatus unassigned-range or unknown-group and a hyphenationNote starting 'Range not assigned'. Ranges change over time, so the hyphens are a formatting aid, not a statement about who the publisher is. An invalid ISBN is a normal 200 answer with valid: false (400 is only for a malformed request). Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "isbn": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 40,
                    "description": "An ISBN-10 or ISBN-13, with or without hyphens or spaces, optionally written with an ISBN prefix. Control characters, NUL and zero-width characters are rejected with 422. Text that is not shaped like an ISBN is a 422 whose message and result never repeat what you sent."
                  }
                },
                "required": [
                  "isbn"
                ],
                "additionalProperties": false
              },
              "example": {
                "isbn": "978-0-306-40615-7"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "input": {
                          "type": "string",
                          "description": "The text you sent"
                        },
                        "clean": {
                          "type": "string",
                          "description": "Digits only (and a final X for an ISBN-10), upper case"
                        },
                        "kind": {
                          "type": "string",
                          "description": "isbn10, isbn13 or unknown (not 10 or 13 characters)",
                          "enum": [
                            "isbn10",
                            "isbn13",
                            "unknown"
                          ]
                        },
                        "wellFormed": {
                          "type": "boolean",
                          "description": "Length and characters are right (the check digit may still be wrong)"
                        },
                        "valid": {
                          "type": "boolean",
                          "description": "The check digit is correct"
                        },
                        "error": {
                          "type": "string",
                          "description": "Why the input is not an ISBN, in plain words"
                        },
                        "givenCheck": {
                          "type": "string",
                          "description": "The check digit you gave"
                        },
                        "expectedCheck": {
                          "type": "string",
                          "description": "The check digit these digits should have"
                        },
                        "isbn10": {
                          "type": "string",
                          "description": "The ISBN-10 form (only for a 978 number)"
                        },
                        "isbn13": {
                          "type": "string",
                          "description": "The ISBN-13 form"
                        },
                        "convertedFromCorrected": {
                          "type": "boolean",
                          "description": "isbn10 and isbn13 were built using the corrected check digit"
                        },
                        "isbn10Hyphenated": {
                          "type": "string",
                          "description": "ISBN-10 with hyphens"
                        },
                        "isbn13Hyphenated": {
                          "type": "string",
                          "description": "ISBN-13 with hyphens"
                        },
                        "groupName": {
                          "type": "string",
                          "description": "Name of the registration group, for example India"
                        },
                        "rangesVersion": {
                          "type": "string",
                          "description": "Date of the International ISBN Agency RangeMessage the hyphenation used, for example 2026-10-30"
                        },
                        "rangeStatus": {
                          "type": "string",
                          "description": "ok (hyphenated), unassigned-range (the agency has not assigned this range to publishers) or unknown-group (no such registration group); absent when the input is not a usable ISBN",
                          "enum": [
                            "ok",
                            "unassigned-range",
                            "unknown-group"
                          ]
                        },
                        "hyphenationNote": {
                          "type": "string",
                          "description": "Why no hyphens could be placed: starts with 'Range not assigned' for an unassigned range or group"
                        },
                        "barcodeDigits": {
                          "type": "string",
                          "description": "The 13 digits printed under an EAN-13 barcode"
                        },
                        "note": {
                          "type": "string",
                          "description": "Extra remark, for example about a corrected digit"
                        }
                      },
                      "required": [
                        "input",
                        "clean",
                        "kind",
                        "wellFormed",
                        "valid",
                        "convertedFromCorrected",
                        "rangesVersion"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "result": {
                    "input": "978-0-306-40615-7",
                    "clean": "9780306406157",
                    "kind": "isbn13",
                    "wellFormed": true,
                    "valid": true,
                    "convertedFromCorrected": false,
                    "givenCheck": "7",
                    "expectedCheck": "7",
                    "isbn10": "0306406152",
                    "isbn13": "9780306406157",
                    "isbn10Hyphenated": "0-306-40615-2",
                    "isbn13Hyphenated": "978-0-306-40615-7",
                    "groupName": "English language",
                    "barcodeDigits": "9780306406157"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or empty isbn, a value longer than 40 characters, or an unknown field"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/publishing/spine-width": {
      "post": {
        "summary": "Calculate spine width and full wrap-cover size for a paperback",
        "operationId": "publishingSpineWidth",
        "description": "Calculates the spine width (pages x paper thickness per page + an optional allowance), the full cover width (back trim + spine + front trim + 2 x bleed), the cover height (trim height + 2 x bleed), the pixel size of the cover file at the chosen dpi, and the position of the back, spine and front panels. Units: inches for every length, pixels for pixels, dpi for resolution. Limits: trim width and height 2 to 14 in; pages a whole number 1 to 2000; thicknessIn from 0.0001 to 0.02 (below 0.0001 is a 400); bleedIn 0 to 1 (default 0.125); spineAllowanceIn -0.5 to 0.5 (default 0); dpi a whole number 72 to 1200 (default 300). Anything outside is a 400 that names the field. The numbers are starting values: the printer's own cover template is the authority. Warnings are returned for an odd page count, a very narrow spine, unusual paper thickness, zero bleed, and (platform kdp, the default) a page count outside 24 to 828, the limits for black-and-white paperbacks on white paper; ingramspark and lulu have no built-in page limits. The final spine (pages x thicknessIn + spineAllowanceIn) must be above 0, otherwise 400. The formula is the same for kdp, ingramspark and lulu, so spine and cover sizes are identical for the same input; platform changes only the summary label and the KDP page-limit warning. A null optional field counts as not sent. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "platform": {
                    "description": "Printer the result is labelled for. Default kdp. The spine and cover formula (pages x thicknessIn + spineAllowanceIn; width = 2 x trim width + spine + 2 x bleed) is the same for every printer: platform only changes the label in summary and, for kdp, adds a warning when pages is outside 24 to 828 (black and white, white paper). It does not change bleed, spine or cover size. Use the thicknessIn and bleedIn your printer gives. null is treated as not sent.",
                    "type": "string",
                    "enum": [
                      "kdp",
                      "ingramspark",
                      "lulu"
                    ]
                  },
                  "trimWidthIn": {
                    "type": "number",
                    "minimum": 2,
                    "maximum": 14,
                    "description": "Trim width of one page in inches, 2 to 14."
                  },
                  "trimHeightIn": {
                    "type": "number",
                    "minimum": 2,
                    "maximum": 14,
                    "description": "Trim height in inches, 2 to 14."
                  },
                  "pages": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 2000,
                    "description": "Page count, a whole number from 1 to 2000. Printed books have an even count; an odd number returns a warning."
                  },
                  "thicknessIn": {
                    "type": "number",
                    "minimum": 0.0001,
                    "maximum": 0.02,
                    "description": "Paper thickness in inches per page (one sheet is two pages), at least 0.0001 and at most 0.02, for example 0.002252 for KDP black and white on white paper. A value below 0.0001 is a 400."
                  },
                  "bleedIn": {
                    "description": "Bleed in inches added on every outer edge, 0 to 1. Default 0.125 for every platform. null is treated as not sent.",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1
                  },
                  "spineAllowanceIn": {
                    "description": "Extra width in inches added to (or, if negative, removed from) the spine, -0.5 to 0.5. Default 0. The final spine (pages x thicknessIn + spineAllowanceIn) must be above 0, otherwise the result is a 400. null is treated as not sent.",
                    "type": "number",
                    "minimum": -0.5,
                    "maximum": 0.5
                  },
                  "dpi": {
                    "description": "Resolution used to give the cover size in pixels, a whole number from 72 to 1200. Default 300. null is treated as not sent.",
                    "type": "integer",
                    "minimum": 72,
                    "maximum": 1200
                  }
                },
                "required": [
                  "trimWidthIn",
                  "trimHeightIn",
                  "pages",
                  "thicknessIn"
                ],
                "additionalProperties": false
              },
              "example": {
                "platform": "kdp",
                "trimWidthIn": 6,
                "trimHeightIn": 9,
                "pages": 320,
                "thicknessIn": 0.002252
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "spineIn": {
                          "type": "number",
                          "description": "Spine width in inches, 4 decimals"
                        },
                        "coverWidthIn": {
                          "type": "number",
                          "description": "Full cover width in inches, bleed included"
                        },
                        "coverHeightIn": {
                          "type": "number",
                          "description": "Full cover height in inches, bleed included"
                        },
                        "pixels": {
                          "type": "object",
                          "properties": {
                            "width": {
                              "type": "integer",
                              "description": "Cover width in pixels"
                            },
                            "height": {
                              "type": "integer",
                              "description": "Cover height in pixels"
                            },
                            "dpi": {
                              "type": "integer",
                              "description": "The dpi used"
                            }
                          },
                          "required": [
                            "width",
                            "height",
                            "dpi"
                          ]
                        },
                        "panels": {
                          "type": "object",
                          "description": "Panel rectangles in inches from the top-left corner of the full cover",
                          "properties": {
                            "back": {
                              "type": "object",
                              "properties": {
                                "x": {
                                  "type": "number",
                                  "description": "Left edge in inches from the top-left corner of the full cover (bleed included)"
                                },
                                "y": {
                                  "type": "number",
                                  "description": "Top edge in inches"
                                },
                                "w": {
                                  "type": "number",
                                  "description": "Width in inches"
                                },
                                "h": {
                                  "type": "number",
                                  "description": "Height in inches"
                                }
                              },
                              "required": [
                                "x",
                                "y",
                                "w",
                                "h"
                              ]
                            },
                            "spine": {
                              "type": "object",
                              "properties": {
                                "x": {
                                  "type": "number",
                                  "description": "Left edge in inches from the top-left corner of the full cover (bleed included)"
                                },
                                "y": {
                                  "type": "number",
                                  "description": "Top edge in inches"
                                },
                                "w": {
                                  "type": "number",
                                  "description": "Width in inches"
                                },
                                "h": {
                                  "type": "number",
                                  "description": "Height in inches"
                                }
                              },
                              "required": [
                                "x",
                                "y",
                                "w",
                                "h"
                              ]
                            },
                            "front": {
                              "type": "object",
                              "properties": {
                                "x": {
                                  "type": "number",
                                  "description": "Left edge in inches from the top-left corner of the full cover (bleed included)"
                                },
                                "y": {
                                  "type": "number",
                                  "description": "Top edge in inches"
                                },
                                "w": {
                                  "type": "number",
                                  "description": "Width in inches"
                                },
                                "h": {
                                  "type": "number",
                                  "description": "Height in inches"
                                }
                              },
                              "required": [
                                "x",
                                "y",
                                "w",
                                "h"
                              ]
                            }
                          },
                          "required": [
                            "back",
                            "spine",
                            "front"
                          ]
                        },
                        "warnings": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "description": "A warning in plain words"
                          },
                          "description": "Empty when nothing needs attention"
                        },
                        "summary": {
                          "type": "string",
                          "description": "Plain-text summary you can paste"
                        }
                      },
                      "required": [
                        "spineIn",
                        "coverWidthIn",
                        "coverHeightIn",
                        "pixels",
                        "panels",
                        "warnings",
                        "summary"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "result": {
                    "spineIn": 0.7206,
                    "coverWidthIn": 12.9706,
                    "coverHeightIn": 9.25,
                    "pixels": {
                      "width": 3892,
                      "height": 2775,
                      "dpi": 300
                    },
                    "panels": {
                      "back": {
                        "x": 0.125,
                        "y": 0.125,
                        "w": 6,
                        "h": 9
                      },
                      "spine": {
                        "x": 6.125,
                        "y": 0.125,
                        "w": 0.7206,
                        "h": 9
                      },
                      "front": {
                        "x": 6.8456,
                        "y": 0.125,
                        "w": 6,
                        "h": 9
                      }
                    },
                    "warnings": [],
                    "summary": "Cover size estimate for Amazon KDP. Confirm with the platform's own cover template.\nTrim: 6 x 9 in, 320 pages, 0.002252 in per page, bleed 0.125 in\nSpine width: 0.721 in (18.3 mm)\nFull cover width: 12.971 in (329.5 mm)\nFull cover height: 9.250 in (234.9 mm)\nAt 300 dpi: 3892 x 2775 px"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Body: {error, code, details: {fieldErrors, formErrors, issues, examples}}. code is invalid_input (a value is missing, out of range, for example dpi 0, pages 0 or thicknessIn 0.5, not a number, or an unknown field; fieldErrors names each field and details.examples shows two accepted requests) or invalid_spine_width (pages x thicknessIn + spineAllowanceIn is not above 0). Example request: {\"trimWidthIn\":6,\"trimHeightIn\":9,\"pages\":300,\"thicknessIn\":0.002252,\"platform\":\"kdp\"}"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/publishing/print-royalty": {
      "post": {
        "summary": "Calculate print cost, royalty per copy and the price needed for a target royalty",
        "operationId": "publishingPrintRoyalty",
        "description": "Printing cost per copy = fixedCharge + perPageCharge x pages, in your own currency. Royalty per copy = author share x listPrice - printing cost, where the author share is percent/100 for method rate, or 1 - percent/100 for method wholesale (percent is then the discount given to retailers). The royalty can be negative: that means the list price does not cover the printing cost (a warning says so). targetRoyalty (0 or more) returns the lowest list price, rounded up to the cent, that earns it, or null when the author share is 0. upfrontCost returns how many copies earn back that one-off cost, or null when each copy earns nothing. priceTable shows the royalty at nine list prices in steps of 1 around your listPrice (prices of 0 or less are left out). Limits: pages 1 to 2000, percent 0 to 100, every money value 0 or more (a negative targetRoyalty is a 400); listPrice 0 is accepted. Amounts are rounded to the cent; no currency conversion or tax is applied. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pages": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 2000,
                    "description": "Page count, 1 to 2000."
                  },
                  "fixedCharge": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1000000,
                    "description": "Fixed printing charge per copy, in your currency (0 to 1,000,000)."
                  },
                  "perPageCharge": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1000000,
                    "description": "Printing charge per page, in the same currency (0 to 1,000,000). Printing cost per copy = fixedCharge + perPageCharge x pages and must also be at most 1,000,000."
                  },
                  "method": {
                    "type": "string",
                    "enum": [
                      "rate",
                      "wholesale"
                    ],
                    "description": "rate: you earn percent of the list price. wholesale: percent is the discount given to retailers and you earn the rest."
                  },
                  "percent": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 100,
                    "description": "The royalty rate (method rate) or the retailer discount (method wholesale), 0 to 100."
                  },
                  "listPrice": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1000000,
                    "description": "The list (cover) price per copy, 0 to 1,000,000; above that is a 400. At 0 nothing is earned, so the royalty is the printing cost as a loss."
                  },
                  "targetRoyalty": {
                    "description": "The royalty per copy you want to earn, 0 to 1,000,000. When given, priceForTargetRoyalty is the lowest list price (to the cent) that earns it; null when the royalty share is 0.",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1000000
                  },
                  "upfrontCost": {
                    "description": "One-off cost (editing, cover, ISBN), 0 to 1,000,000. When given, copiesToRecoverUpfront is how many copies earn it back (at least 1 when the cost is above 0); null when each copy earns nothing. targetRoyalty and upfrontCost may be null, which means not sent.",
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1000000
                  }
                },
                "required": [
                  "pages",
                  "fixedCharge",
                  "perPageCharge",
                  "method",
                  "percent",
                  "listPrice"
                ],
                "additionalProperties": false
              },
              "example": {
                "pages": 320,
                "fixedCharge": 1,
                "perPageCharge": 0.012,
                "method": "rate",
                "percent": 60,
                "listPrice": 14.99
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "printCostPerCopy": {
                          "type": "number",
                          "description": "Printing cost of one copy"
                        },
                        "royaltyPerCopy": {
                          "type": "number",
                          "description": "What you earn per copy at listPrice; negative when the price does not cover the printing cost"
                        },
                        "priceForTargetRoyalty": {
                          "type": "number",
                          "nullable": true,
                          "description": "Lowest list price that earns targetRoyalty; null when targetRoyalty was not sent or the author share is 0"
                        },
                        "copiesToRecoverUpfront": {
                          "type": "integer",
                          "nullable": true,
                          "description": "Copies needed to earn back upfrontCost; null when upfrontCost was not sent or a copy earns nothing"
                        },
                        "priceTable": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "price": {
                                "type": "number",
                                "description": "A list price"
                              },
                              "royalty": {
                                "type": "number",
                                "description": "Royalty per copy at that price"
                              },
                              "margin": {
                                "type": "number",
                                "description": "Royalty as a percent of the price, 1 decimal"
                              }
                            },
                            "required": [
                              "price",
                              "royalty",
                              "margin"
                            ]
                          },
                          "description": "Royalty at nine prices around listPrice"
                        },
                        "warnings": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "description": "A warning in plain words"
                          }
                        }
                      },
                      "required": [
                        "printCostPerCopy",
                        "royaltyPerCopy",
                        "priceTable",
                        "warnings"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "result": {
                    "printCostPerCopy": 4.84,
                    "royaltyPerCopy": 4.15,
                    "priceForTargetRoyalty": null,
                    "copiesToRecoverUpfront": null,
                    "priceTable": [
                      {
                        "price": 10.99,
                        "royalty": 1.75,
                        "margin": 15.9
                      },
                      {
                        "price": 11.99,
                        "royalty": 2.35,
                        "margin": 19.6
                      },
                      {
                        "price": 12.99,
                        "royalty": 2.95,
                        "margin": 22.7
                      },
                      "..."
                    ],
                    "warnings": []
                  }
                }
              }
            }
          },
          "400": {
            "description": "A value is missing, negative (for example targetRoyalty -5), out of range, or an unknown field; the body names the field"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/ecommerce/etsy-listing-check": {
      "post": {
        "summary": "Check an Etsy listing title and tags against Etsy's rules",
        "operationId": "ecommerceEtsyListingCheck",
        "description": "Checks a title and an optional list of tags. Findings with severity error are Etsy's hard rules: a title over 140 characters; the characters % : & used more than once each in a title; the characters $ ^ \\ and the backtick anywhere in a title; more than 13 tags; a tag over 20 characters; a repeated tag; a tag that starts with a hyphen or apostrophe. Findings with severity advice are suggestions (capitals, repeated words, unusual symbols, very short or very long titles, single-word tags, tags that only repeat the title) because Etsy's guidance changes and ranking is not public; ok means a check passed. errors counts the error findings, so errors: 0 means no hard rule is broken. Tags are split on commas, semicolons and new lines. Lengths count characters, not bytes. null is treated as omitted on every optional field. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000,
                    "description": "The listing title. It is trimmed first; an empty or whitespace-only title is a 400. Errors: more than 140 characters; the characters % : & used more than once each; any of $ ^ \\ and the backtick. Everything else is advice."
                  },
                  "tags": {
                    "description": "Tags separated by commas, semicolons or new lines. Errors: more than 13 tags, a tag over 20 characters, a repeated tag, a tag starting with a hyphen or apostrophe. null is treated as omitted.",
                    "type": "string",
                    "maxLength": 5000
                  }
                },
                "required": [
                  "title"
                ],
                "additionalProperties": false
              },
              "example": {
                "title": "Handmade ceramic coffee mug, 12 oz, speckled blue glaze, microwave safe gift",
                "tags": "ceramic mug, coffee mug, handmade gift, blue glaze, pottery"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "title": {
                          "type": "object",
                          "properties": {
                            "length": {
                              "type": "integer",
                              "description": "Title length in characters"
                            },
                            "front": {
                              "type": "string",
                              "description": "The first 40 characters, which show first in many lists"
                            },
                            "findings": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "severity": {
                                    "type": "string",
                                    "description": "error, advice or ok",
                                    "enum": [
                                      "error",
                                      "advice",
                                      "ok"
                                    ]
                                  },
                                  "text": {
                                    "type": "string",
                                    "description": "What was found, in plain words"
                                  }
                                },
                                "required": [
                                  "severity",
                                  "text"
                                ]
                              }
                            },
                            "errors": {
                              "type": "integer",
                              "description": "Number of error findings"
                            }
                          },
                          "required": [
                            "length",
                            "front",
                            "findings",
                            "errors"
                          ]
                        },
                        "tags": {
                          "type": "object",
                          "properties": {
                            "tags": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "tag": {
                                    "type": "string",
                                    "description": "The tag"
                                  },
                                  "length": {
                                    "type": "integer",
                                    "description": "Length in characters"
                                  },
                                  "problems": {
                                    "type": "array",
                                    "items": {
                                      "type": "string",
                                      "description": "A problem with this tag"
                                    }
                                  },
                                  "inTitle": {
                                    "type": "boolean",
                                    "description": "Every meaningful word of the tag is already in the title"
                                  }
                                },
                                "required": [
                                  "tag",
                                  "length",
                                  "problems",
                                  "inTitle"
                                ]
                              }
                            },
                            "findings": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "severity": {
                                    "type": "string",
                                    "description": "error, advice or ok",
                                    "enum": [
                                      "error",
                                      "advice",
                                      "ok"
                                    ]
                                  },
                                  "text": {
                                    "type": "string",
                                    "description": "What was found, in plain words"
                                  }
                                },
                                "required": [
                                  "severity",
                                  "text"
                                ]
                              }
                            },
                            "errors": {
                              "type": "integer",
                              "description": "Number of error findings"
                            },
                            "titleWordsNotInTags": {
                              "type": "array",
                              "items": {
                                "type": "string",
                                "description": "A meaningful title word that no tag contains"
                              }
                            },
                            "cleaned": {
                              "type": "array",
                              "items": {
                                "type": "string",
                                "description": "A tag"
                              },
                              "description": "The tags again, duplicates removed"
                            }
                          },
                          "required": [
                            "tags",
                            "findings",
                            "errors",
                            "titleWordsNotInTags",
                            "cleaned"
                          ]
                        }
                      },
                      "required": [
                        "title",
                        "tags"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "result": {
                    "title": {
                      "length": 76,
                      "front": "Handmade ceramic coffee mug, 12 oz, spec",
                      "findings": [
                        {
                          "severity": "ok",
                          "text": "76 of 140 characters used."
                        }
                      ],
                      "errors": 0
                    },
                    "tags": {
                      "tags": [
                        {
                          "tag": "ceramic mug",
                          "length": 11,
                          "problems": [],
                          "inTitle": true
                        },
                        {
                          "tag": "coffee mug",
                          "length": 10,
                          "problems": [],
                          "inTitle": true
                        },
                        {
                          "tag": "handmade gift",
                          "length": 13,
                          "problems": [],
                          "inTitle": true
                        },
                        "..."
                      ],
                      "findings": [
                        {
                          "severity": "advice",
                          "text": "5 of 13 tags used. Each unused tag is a search phrase left on the table."
                        },
                        {
                          "severity": "advice",
                          "text": "4 tags only repeat words already in the title (ceramic mug; coffee mug; handmade gift...). Use tags for different phrases than the title carries."
                        }
                      ],
                      "errors": 0,
                      "titleWordsNotInTags": [
                        "speckled",
                        "microwave",
                        "safe"
                      ],
                      "cleaned": [
                        "ceramic mug",
                        "coffee mug",
                        "handmade gift",
                        "..."
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "title missing or over 1000 characters, tags over 5000 characters, or an unknown field"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/publishing/kdp-description": {
      "post": {
        "summary": "Format or clean a book description as the HTML Amazon KDP allows",
        "operationId": "publishingKdpDescription",
        "description": "Send text (blank lines make paragraphs; a line starting with # is a heading in the heading tag; lines starting with - or * make a bullet list and 1. a numbered list; **bold**, *italic* and __underline__ work; a single line break inside a paragraph becomes <br>) or html. HTML is cleaned to the tags KDP accepts: scripts and styles are removed with their content, other disallowed tags are removed but their text is kept, some tags are changed into an allowed one (for example h2 into the heading tag), and attributes are stripped. removed and changed count tags by name. stats gives the length of the HTML (tags included), the visible length, the word count and how many characters it is over KDP's limit of 4,000 characters; notes lists problems such as being over the limit. Send at least one of text and html; when both are sent, html is used. heading is h4 (default), h5 or h6. null is treated as omitted on every optional field. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "description": "Plain text; blank lines make paragraphs. null is treated as omitted. Send text or html. Missing, empty and whitespace-only input all return the same 400 \"Send text or html.\". html wins when both have content.",
                    "type": "string",
                    "maxLength": 200000
                  },
                  "html": {
                    "description": "HTML to clean to the tags KDP allows; what was removed or changed is reported. Script, style, head, title and noscript elements are removed with their content; if one is never closed, everything after its opening tag is removed too.",
                    "type": "string",
                    "maxLength": 200000
                  },
                  "heading": {
                    "description": "Tag used for headings. Default h4. null is treated as omitted.",
                    "type": "string",
                    "enum": [
                      "h4",
                      "h5",
                      "h6"
                    ]
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "text": "A fast, funny guide to running a small shop.\n\nEvery chapter ends with one thing you can do today.",
                "heading": "h4"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "html": {
                          "type": "string",
                          "description": "The description as KDP-ready HTML"
                        },
                        "removed": {
                          "type": "object",
                          "additionalProperties": {
                            "type": "integer"
                          },
                          "description": "Tags removed, with how many times each"
                        },
                        "changed": {
                          "type": "object",
                          "additionalProperties": {
                            "type": "integer"
                          },
                          "description": "Tags changed into an allowed one, with how many times each"
                        },
                        "stats": {
                          "type": "object",
                          "properties": {
                            "htmlLength": {
                              "type": "integer",
                              "description": "Characters in the HTML, tags included"
                            },
                            "visible": {
                              "type": "integer",
                              "description": "Characters a reader sees"
                            },
                            "words": {
                              "type": "integer",
                              "description": "Words"
                            },
                            "overBy": {
                              "type": "integer",
                              "description": "Characters over KDP's limit; 0 when within"
                            }
                          },
                          "required": [
                            "htmlLength",
                            "visible",
                            "words",
                            "overBy"
                          ]
                        },
                        "notes": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "description": "A problem worth fixing, in plain words"
                          }
                        }
                      },
                      "required": [
                        "html",
                        "removed",
                        "changed",
                        "stats",
                        "notes"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "result": {
                    "html": "<p>A fast, funny guide to running a small shop.</p><p>Every chapter ends with one thing you can do today.</p>",
                    "removed": {},
                    "changed": {},
                    "stats": {
                      "htmlLength": 109,
                      "visible": 95,
                      "words": 19,
                      "overBy": 0
                    },
                    "notes": [
                      "Nothing is in bold or a heading. A bold first line gives the listing a hook."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Neither text nor html was sent, a value is too long (200,000 characters), heading is not h4, h5 or h6, or an unknown field"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/publishing/onix": {
      "post": {
        "summary": "Build an ONIX 3.0 product record for one book",
        "operationId": "publishingOnix",
        "description": "Validates the book details and, when there are no errors, returns a single-product ONIX 3.0 (reference tags) XML message. The status is 200 with xml when valid and 422 with xml: null when issues contains at least one level error; warnings never block output. Checks: title present; at least one named contributor; a valid ISBN-13 (978 or 979, correct check digit; an ISBN-10 is refused with the ISBN-13 to use); publisher; a real publication date (YYYY-MM-DD, YYYY-MM or YYYY); a three-letter lower-case ISO 639-2/B language (default eng); productForm BC paperback (default), BB hardback or EA digital download (written with form detail E101); page count digits only; BISAC (three letters, six digits) and Thema codes; short description up to 350 characters; prices as digits with up to 2 decimals and a three-letter currency in capitals, no two with the same currency and type; territory WORLD (default) or two-letter country codes separated by spaces. Price type: 01 is the recommended price excluding tax and 02 including tax. If you do not send a type, USD and CAD prices get 01 (they are quoted before sales tax) and every other currency gets 02; sending 02 with USD or CAD is accepted but returns a warning. Control characters that XML cannot hold are removed from every text field. Other ONIX product forms (for example ED, DG, AJ) are not supported and are rejected with a 400. null is treated as omitted on every optional field (including the optional parts of each contributor and price); required fields cannot be null. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000,
                    "description": "The product title. null is treated as omitted on every optional field (subtitle, language, productForm, pageCount, subjects, audience, shortDescription, description, prices, territory, availability and the optional parts of each contributor and price). Control characters (for example U+0001) are rejected with 422, not removed."
                  },
                  "subtitle": {
                    "type": "string",
                    "maxLength": 1000
                  },
                  "contributors": {
                    "minItems": 1,
                    "maxItems": 50,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 300,
                          "description": "Name as printed, for example Jane Q. Writer."
                        },
                        "inverted": {
                          "description": "Name inverted for sorting, written Last name, First name (a warning when there is no comma).",
                          "type": "string",
                          "maxLength": 300
                        },
                        "role": {
                          "description": "ONIX contributor role code (code list 17). Default A01 (author). Common: B01 editor, A12 illustrator, B06 translator.",
                          "type": "string",
                          "pattern": "^[A-Z][0-9]{2}$"
                        }
                      },
                      "required": [
                        "name"
                      ],
                      "additionalProperties": false
                    },
                    "description": "At least one named contributor."
                  },
                  "isbn": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 40,
                    "description": "The ISBN-13 (978 or 979, valid check digit), hyphens allowed. An ISBN-10 is rejected with the ISBN-13 to use."
                  },
                  "publisher": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 300
                  },
                  "pubDate": {
                    "type": "string",
                    "maxLength": 20,
                    "description": "Publication date as YYYY-MM-DD, YYYY-MM or YYYY, and a real calendar date. Anything else is reported as an error issue (422)."
                  },
                  "language": {
                    "description": "Three-letter ISO 639-2/B language code in lower case, for example eng, fre, ger, spa. Default eng. Checked against the ISO 639-2/B list (special codes mis, mul, und, zxx included); an unknown code such as xxx or zzz is an error issue (422).",
                    "type": "string",
                    "maxLength": 10
                  },
                  "productForm": {
                    "description": "ONIX product form: BC paperback (default), BB hardback, EA digital download (written with form detail E101, EPUB).",
                    "type": "string",
                    "enum": [
                      "BB",
                      "BC",
                      "EA"
                    ]
                  },
                  "pageCount": {
                    "description": "Number of pages as digits, 1 to 999999, written as text. Anything else is an error issue (422); print forms without it get a warning.",
                    "type": "string",
                    "maxLength": 10
                  },
                  "subjects": {
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "scheme": {
                          "type": "string",
                          "enum": [
                            "bisac",
                            "thema"
                          ]
                        },
                        "code": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 40,
                          "description": "A BISAC code such as FIC027020 (three letters, six digits) or a Thema code such as FBA or 1KBB."
                        }
                      },
                      "required": [
                        "scheme",
                        "code"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "audience": {
                    "description": "ONIX audience code: 01 general/trade, 02 children/juvenile, 03 young adult, 04 primary and secondary education, 05 college/higher education, 06 professional and scholarly. Default: not stated.",
                    "type": "string",
                    "enum": [
                      "01",
                      "02",
                      "03",
                      "04",
                      "05",
                      "06"
                    ]
                  },
                  "shortDescription": {
                    "description": "Up to 350 characters.",
                    "type": "string",
                    "maxLength": 350
                  },
                  "description": {
                    "description": "The main description; a warning when missing.",
                    "type": "string",
                    "maxLength": 100000
                  },
                  "prices": {
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "amount": {
                          "type": "string",
                          "maxLength": 20,
                          "description": "Digits with a decimal point and at most 2 decimals, for example 14.99. 0 and any other format are reported as an error issue (422)."
                        },
                        "currency": {
                          "type": "string",
                          "maxLength": 10,
                          "description": "Three-letter ISO 4217 code in capitals, for example USD. Anything else is an error issue (422)."
                        },
                        "type": {
                          "description": "ONIX price type: 01 recommended retail price EXCLUDING tax, 02 INCLUDING tax. Default by currency: 01 for USD and CAD (their prices are quoted before sales tax), 02 for every other currency. A warning is returned when USD or CAD is sent with 02. Two prices with the same currency and type are rejected.",
                          "type": "string",
                          "enum": [
                            "01",
                            "02"
                          ]
                        }
                      },
                      "required": [
                        "amount",
                        "currency"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "territory": {
                    "description": "WORLD, or two-letter country codes separated by spaces, for example US CA GB. Default WORLD. Anything else is an error issue (422).",
                    "type": "string",
                    "maxLength": 200
                  },
                  "availability": {
                    "description": "ONIX product availability code from code list 65, two digits. Default 20 (available). Common: 10 not yet available, 20 available, 23 manufactured on demand, 40 not available. A code that is not in list 65 (for example 99) is an error issue (422).",
                    "type": "string",
                    "pattern": "^[0-9]{2}$"
                  }
                },
                "required": [
                  "title",
                  "contributors",
                  "isbn",
                  "publisher",
                  "pubDate"
                ],
                "additionalProperties": false
              },
              "example": {
                "title": "The Small Shop Handbook",
                "contributors": [
                  {
                    "name": "Maria Lopez",
                    "inverted": "Lopez, Maria",
                    "role": "A01"
                  }
                ],
                "isbn": "9780306406157",
                "publisher": "Northwind Press",
                "pubDate": "2026-11-15",
                "language": "eng",
                "productForm": "BC",
                "pageCount": "320",
                "prices": [
                  {
                    "amount": "14.99",
                    "currency": "USD"
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "issues": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "field": {
                                "type": "string",
                                "description": "The request field the issue is about"
                              },
                              "message": {
                                "type": "string",
                                "description": "What to fix, in plain words"
                              },
                              "level": {
                                "type": "string",
                                "description": "error blocks the XML; warning does not",
                                "enum": [
                                  "error",
                                  "warning"
                                ]
                              }
                            },
                            "required": [
                              "field",
                              "message",
                              "level"
                            ]
                          }
                        },
                        "xml": {
                          "type": "string",
                          "nullable": true,
                          "description": "The ONIX 3.0 message (UTF-8 XML), or null when there is an error issue"
                        }
                      },
                      "required": [
                        "issues"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "result": {
                    "issues": [
                      {
                        "field": "availability",
                        "message": "The publication date is in the future but availability is set to Available. Consider Not yet available.",
                        "level": "warning"
                      },
                      {
                        "field": "subjects",
                        "message": "No subject code. Most retailers and distributors ask for at least one BISAC or Thema code.",
                        "level": "warning"
                      },
                      {
                        "field": "description",
                        "message": "No description. Retailers normally show it on the product page.",
                        "level": "warning"
                      }
                    ],
                    "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<ONIXMessage release=\"3.0\" xmlns=\"http://ns.editeur.org/onix/3.0/reference\">\n  <Header>\n    <Sender>\n      <SenderName>Northwind Press</SenderName>\n    </Sender>\n    <SentDateTime>20261030T144036Z</SentDateTime>\n  </Header>\n  <Product>\n    <RecordReference>9780..."
                  }
                }
              }
            }
          },
          "400": {
            "description": "A field is missing, has the wrong type or an unsupported value (productForm other than BB, BC or EA; audience, price type or role that is not a code from the lists), or is unknown; the body names the field. Values with the right type but wrong content (a bad ISBN, date, currency, page count) are not a 400: they come back as error issues with status 422"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "422": {
            "description": "The record has validation errors (a wrong ISBN check digit, an impossible date, a duplicate price, ...). The body is {result: {issues, xml: null}}; fix the issues with level error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/cover-letter": {
      "post": {
        "summary": "Write a cover letter from the applicant, company, role and achievements",
        "operationId": "businessCoverLetter",
        "description": "Write a cover letter from the applicant, company, role and achievements. Send JSON with name, contact, date, company, role, achievements (required); optional: manager, found, years, why, includeDocx. Returns JSON with title, sections, filename (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1
                  },
                  "contact": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Contact lines, one per line. At least one line must be an email address, a phone number or a LinkedIn address (422 otherwise); the closing line \"I can be reached at ...\" uses the email and phone, never a city."
                  },
                  "date": {
                    "type": "string",
                    "minLength": 1,
                    "description": "The letter date. A YYYY-MM-DD date is written out in full (November 5, 2026); other text is used as typed."
                  },
                  "company": {
                    "type": "string",
                    "minLength": 1
                  },
                  "role": {
                    "type": "string",
                    "minLength": 1
                  },
                  "achievements": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Best results for this job, one per line"
                  },
                  "manager": {
                    "description": "Hiring manager's name. Default: Hiring Manager.",
                    "type": "string"
                  },
                  "found": {
                    "description": "Where you found the job, in a word or phrase: LinkedIn, on Indeed, a friend, your careers page. A preposition is added when it is missing.",
                    "type": "string"
                  },
                  "years": {
                    "description": "Years of experience: 8, 8 years or 8+ years all become '8 years of experience'.",
                    "type": "string"
                  },
                  "why": {
                    "description": "Why this company, as a clause that follows 'because': 'your mission to cut waste'. A leading 'because' and capital letter are fixed for you.",
                    "type": "string"
                  },
                  "includeDocx": {
                    "description": "true also returns the letter as a Word file in result.docx (filename, contentType, base64). Default false: the result holds the text and sections only.",
                    "type": "boolean"
                  }
                },
                "required": [
                  "name",
                  "contact",
                  "date",
                  "company",
                  "role",
                  "achievements"
                ],
                "additionalProperties": false
              },
              "example": {
                "name": "Maria Lopez",
                "contact": "maria@example.com\n+1 555 0100",
                "date": "2026-10-20",
                "company": "Harbor Coffee Co.",
                "role": "Operations Manager",
                "achievements": "Cut order errors by 40%\nLed a team of 12\nOpened two new locations",
                "manager": "Dana Reed",
                "years": "8"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Cover letter maker client and server side from freedailypro",
                  "result": {
                    "title": "Maria Lopez",
                    "sections": [
                      {
                        "paragraphs": [
                          "maria@example.com",
                          "+1 555 0100",
                          "",
                          "..."
                        ]
                      },
                      {
                        "paragraphs": [
                          "Dear Dana Reed,",
                          "",
                          "I am writing to apply for the Operations Manager position at Harbor Coffee Co. I bring 8 of experience in this field."
                        ]
                      },
                      {
                        "paragraphs": [
                          "Here is what I would bring to the role:"
                        ],
                        "bullets": [
                          "Cut order errors by 40%",
                          "Led a team of 12",
                          "Opened two new locations"
                        ]
                      },
                      "..."
                    ],
                    "filename": "cover-letter-harbor-coffee-co.docx"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/donation-receipt": {
      "post": {
        "summary": "Build a charity donation receipt with the IRS-required statement and the deductible amount after goods and services",
        "operationId": "businessDonationReceipt",
        "description": "Build a charity donation receipt with the IRS-required statement and the deductible amount after goods and services. Send JSON with organizationName, ein, donorName, date (required); optional: exemptionType, organizationAddress, donorAddress, receiptNumber, eventName, contributionType, amount, propertyDescription, goodsAndServices, intangibleReligiousBenefitsOnly, signerName, signerTitle, includeDocx. Limits: organizationName: up to 200 characters; exemptionType: up to 40 characters; organizationAddress: up to 400 characters; donorName: up to 200 characters; donorAddress: up to 400 characters; receiptNumber: up to 60 characters; eventName: up to 200 characters; propertyDescription: up to 500 characters; goodsAndServices: up to 20 items; signerName: up to 200 characters; signerTitle: up to 200 characters. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "organizationName": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "description": "The charity's legal name."
                  },
                  "ein": {
                    "type": "string",
                    "minLength": 1,
                    "description": "The charity's Employer Identification Number, 9 digits (12-3456789 or 123456789). Printed on the receipt; a malformed number is a 422."
                  },
                  "exemptionType": {
                    "description": "Section of the Internal Revenue Code that exempts the charity. Default 501(c)(3).",
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 40
                  },
                  "organizationAddress": {
                    "description": "Charity address, printed under the name.",
                    "type": "string",
                    "maxLength": 400
                  },
                  "donorName": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "description": "Who gave."
                  },
                  "donorAddress": {
                    "description": "Donor address (optional).",
                    "type": "string",
                    "maxLength": 400
                  },
                  "date": {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                    "description": "Date the gift was received, YYYY-MM-DD, a real date."
                  },
                  "receiptNumber": {
                    "description": "Your receipt number.",
                    "type": "string",
                    "maxLength": 60
                  },
                  "eventName": {
                    "description": "Event or campaign, for example 'Spring Gala'.",
                    "type": "string",
                    "maxLength": 200
                  },
                  "contributionType": {
                    "description": "cash (default) states the amount; noncash describes the property and states no value, as the IRS requires.",
                    "type": "string",
                    "enum": [
                      "cash",
                      "noncash"
                    ]
                  },
                  "amount": {
                    "description": "Cash: the total the donor paid, in US dollars. Needed for cash. For two $150 tickets send 300.",
                    "type": "number",
                    "minimum": 0
                  },
                  "propertyDescription": {
                    "description": "Non-cash: what was given. Needed for noncash. Do not put a value on it.",
                    "type": "string",
                    "maxLength": 500
                  },
                  "goodsAndServices": {
                    "description": "What the donor received in return (dinner, ticket, merchandise). Leave out when nothing was given. The deductible amount is the amount paid less their value.",
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "description": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        "quantity": {
                          "description": "How many. Default 1.",
                          "type": "number",
                          "minimum": 0
                        },
                        "fairMarketValueEach": {
                          "type": "number",
                          "minimum": 0,
                          "description": "Good-faith estimate of what one is worth, for example a $60 dinner."
                        }
                      },
                      "required": [
                        "description",
                        "fairMarketValueEach"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "intangibleReligiousBenefitsOnly": {
                    "description": "true when the only benefit was intangible religious benefits (for a religious organization); prints that statement instead of a goods and services list.",
                    "type": "boolean"
                  },
                  "signerName": {
                    "description": "Who signs for the charity.",
                    "type": "string",
                    "maxLength": 200
                  },
                  "signerTitle": {
                    "description": "Signer's title.",
                    "type": "string",
                    "maxLength": 200
                  },
                  "includeDocx": {
                    "description": "true also returns the receipt as a Word file in result.docx (filename, contentType, base64).",
                    "type": "boolean"
                  }
                },
                "required": [
                  "organizationName",
                  "ein",
                  "donorName",
                  "date"
                ],
                "additionalProperties": false
              },
              "example": {
                "organizationName": "Riverside Community Arts",
                "ein": "12-3456789",
                "donorName": "Jordan Rivera",
                "date": "2026-11-01",
                "eventName": "Autumn Gala",
                "amount": 300,
                "goodsAndServices": [
                  {
                    "description": "Gala dinner",
                    "quantity": 2,
                    "fairMarketValueEach": 60
                  }
                ],
                "signerName": "Maria Chen",
                "signerTitle": "Treasurer"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/offer-letter-draft": {
      "post": {
        "summary": "Draft an employment offer letter from the role, salary and start date",
        "operationId": "businessOfferLetterDraft",
        "description": "Draft an employment offer letter from the role, salary and start date. Send JSON with candidate, company, title, startDate (required); optional: salary, positionType, salaryPeriod, employmentType, managerName, managerTitle, mentorName, companyTagline, benefits, paidInternship, durationNumber, durationUnit, learningPoints, equipment, contingencies, termination, noticeDays, state, responseDeadline, signerName, signerTitle, includeDocx. Returns JSON with title, body (inside result). Limits: candidate: up to 200 characters; company: up to 200 characters; title: up to 200 characters; startDate: up to 20 characters; employmentType: up to 40 characters; managerName: up to 200 characters; managerTitle: up to 200 characters; mentorName: up to 200 characters; companyTagline: up to 200 characters; benefits: up to 2000 characters; durationNumber: at most 260, at least 1; learningPoints: up to 20 items; noticeDays: at most 365, at least 1; state: up to 100 characters; responseDeadline: up to 20 characters; signerName: up to 200 characters; signerTitle: up to 200 characters. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "candidate": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "description": "Full name of the person receiving the offer."
                  },
                  "company": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "description": "The employer's name."
                  },
                  "title": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "description": "The job title."
                  },
                  "salary": {
                    "description": "Pay as a number or text: 92000, \"$92,000\", \"92,000 per year\", \"6,000/month\", \"45 per hour\". Must be above 0 (422 otherwise). Required, except for an unpaid internship. Words after the number set the period unless salaryPeriod is sent.",
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 60
                      },
                      {
                        "type": "number"
                      }
                    ]
                  },
                  "startDate": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 20,
                    "description": "First day of work as a real calendar date, YYYY-MM-DD (422 otherwise). A date in the past is allowed and returned as a warning."
                  },
                  "positionType": {
                    "description": "Default permanent.",
                    "type": "string",
                    "enum": [
                      "permanent",
                      "internship"
                    ]
                  },
                  "salaryPeriod": {
                    "description": "What the pay is per. Default year, or the period named in the salary text.",
                    "type": "string",
                    "enum": [
                      "year",
                      "month",
                      "hour"
                    ]
                  },
                  "employmentType": {
                    "description": "Full-time (default), Part-time, Contract.",
                    "type": "string",
                    "maxLength": 40
                  },
                  "managerName": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "managerTitle": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "mentorName": {
                    "description": "Internships: the mentor named in the reporting section.",
                    "type": "string",
                    "maxLength": 200
                  },
                  "companyTagline": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "benefits": {
                    "description": "Permanent roles: the benefits paragraph. A standard sentence is used when left out.",
                    "type": "string",
                    "maxLength": 2000
                  },
                  "paidInternship": {
                    "description": "Internships: true when a stipend is paid (then salary is the stipend). Default false: an unpaid-internship clause is written.",
                    "type": "boolean"
                  },
                  "durationNumber": {
                    "description": "Internships: how long it lasts, in durationUnit. Default 3.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 260
                  },
                  "durationUnit": {
                    "description": "Default months.",
                    "type": "string",
                    "enum": [
                      "weeks",
                      "months"
                    ]
                  },
                  "learningPoints": {
                    "description": "Internships: what the intern will gain, one item each. A standard list is used when left out.",
                    "maxItems": 20,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 300
                    }
                  },
                  "equipment": {
                    "description": "Whose equipment is used. Default company.",
                    "type": "string",
                    "enum": [
                      "company",
                      "own"
                    ]
                  },
                  "contingencies": {
                    "description": "Which conditions the offer depends on. Defaults: criminalCheck and workEligibility true, the others false.",
                    "type": "object",
                    "properties": {
                      "criminalCheck": {
                        "type": "boolean"
                      },
                      "backgroundCheck": {
                        "type": "boolean"
                      },
                      "referenceCheck": {
                        "type": "boolean"
                      },
                      "workEligibility": {
                        "type": "boolean"
                      }
                    },
                    "additionalProperties": false
                  },
                  "termination": {
                    "description": "Default at-will.",
                    "type": "string",
                    "enum": [
                      "at-will",
                      "notice"
                    ]
                  },
                  "noticeDays": {
                    "description": "With termination notice: days of written notice. Default 30.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 365
                  },
                  "state": {
                    "description": "Governing-law state or country. The governing-law section is left out when this is not sent.",
                    "type": "string",
                    "maxLength": 100
                  },
                  "responseDeadline": {
                    "description": "Last day to accept, YYYY-MM-DD, on or before startDate (422 otherwise).",
                    "type": "string",
                    "maxLength": 20
                  },
                  "signerName": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "signerTitle": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "includeDocx": {
                    "description": "true also returns the letter as a Word file in result.docx (filename, contentType, base64).",
                    "type": "boolean"
                  }
                },
                "required": [
                  "candidate",
                  "company",
                  "title",
                  "startDate"
                ],
                "additionalProperties": false
              },
              "example": {
                "candidate": "Priya Nair",
                "company": "Northwind Design LLC",
                "title": "Product Designer",
                "salary": "$92,000 per year",
                "startDate": "2026-11-16"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Employment offer letter draft client and server side from freedailypro",
                  "result": {
                    "title": "Employment offer letter (draft)",
                    "body": "Dear Priya Nair,\n\nNorthwind Design LLC is pleased to offer you the position of Product Designer, starting 2026-11-16, with compensation of $92,000 per year. This draft is not a binding contract until signed.\n\nSincerely,\nNorthwind Design LLC"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/resume-job-match": {
      "post": {
        "summary": "Compare a resume with a job post: keyword coverage, what matches and what is missing",
        "operationId": "businessResumeJobMatch",
        "description": "Compare a resume with a job post: keyword coverage, what matches and what is missing. Send JSON with resume, jobPost (required); optional: maxKeywords. Limits: resume: up to 100000 characters; jobPost: up to 100000 characters; maxKeywords: at most 100, at least 1. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "resume": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100000,
                    "description": "The resume as plain text (up to 100,000 characters)."
                  },
                  "jobPost": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100000,
                    "description": "The job posting as plain text (up to 100,000 characters). Paste the whole posting: the keywords come from how often it repeats words and two-word phrases."
                  },
                  "maxKeywords": {
                    "description": "How many posting keywords to check, 1 to 100. Default 40.",
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100
                  }
                },
                "required": [
                  "resume",
                  "jobPost"
                ],
                "additionalProperties": false
              },
              "example": {
                "resume": "Data analyst with 5 years of experience. Built SQL reports and Tableau dashboards for the sales team. Automated weekly reporting in Python and cut reporting time by 40%. Led a team of 3 analysts.",
                "jobPost": "We are hiring a Data Analyst. You will build dashboards in Tableau and Power BI, write SQL queries, and automate reporting with Python. SQL and dashboards are essential; experience with A/B testing is a plus. You will present results to stakeholders.",
                "maxKeywords": 20
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/resume-outline": {
      "post": {
        "summary": "Build a resume outline from a name, title, skills and experience",
        "operationId": "businessResumeOutline",
        "description": "Build a resume outline from a name, title, skills and experience. Send JSON with name, title (required); optional: summary, skills, experience, education, contact, includeDocx. Returns JSON with heading, summary, skills, experience, sections (inside result). Limits: name: up to 200 characters; title: up to 200 characters; summary: up to 2000 characters; skills: up to 60 items; experience: up to 30 items; education: up to 10 items; contact: up to 500 characters. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "description": "Your name."
                  },
                  "title": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200,
                    "description": "The job title you are applying for or hold."
                  },
                  "summary": {
                    "description": "Your own summary. When left out a one-line draft is written and flagged (summaryIsDraft).",
                    "type": "string",
                    "maxLength": 2000
                  },
                  "skills": {
                    "maxItems": 60,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    }
                  },
                  "experience": {
                    "description": "Jobs, newest first.",
                    "maxItems": 30,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "company": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        "role": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        "years": {
                          "description": "The period, such as 2022-2026 or 2021-Present. Must contain a real year and not end before it starts (422 otherwise).",
                          "type": "string",
                          "maxLength": 60
                        },
                        "achievements": {
                          "description": "Result lines for this job. Prompts are written in their place when left out.",
                          "maxItems": 12,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 400
                          }
                        }
                      },
                      "required": [
                        "company",
                        "role"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "education": {
                    "maxItems": 10,
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "school": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        "degree": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        "years": {
                          "type": "string",
                          "maxLength": 60
                        }
                      },
                      "required": [
                        "school",
                        "degree"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "contact": {
                    "description": "Contact lines, one per line, shown under your name.",
                    "type": "string",
                    "maxLength": 500
                  },
                  "includeDocx": {
                    "description": "true also returns the outline as a Word file in result.docx (filename, contentType, base64).",
                    "type": "boolean"
                  }
                },
                "required": [
                  "name",
                  "title"
                ],
                "additionalProperties": false
              },
              "example": {
                "name": "Priya Nair",
                "title": "Product Designer",
                "summary": "Designer with 6 years in fintech.",
                "skills": [
                  "Figma",
                  "User research",
                  "Prototyping"
                ],
                "experience": [
                  {
                    "company": "Northwind",
                    "role": "Senior Designer",
                    "years": "2022-2026"
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Resume outline builder client and server side from freedailypro",
                  "result": {
                    "heading": "Priya Nair — Product Designer",
                    "summary": "Designer with 6 years in fintech.",
                    "skills": [
                      "Figma",
                      "User research",
                      "Prototyping"
                    ],
                    "experience": [
                      {
                        "company": "Northwind",
                        "role": "Senior Designer",
                        "years": "2022-2026"
                      }
                    ],
                    "sections": [
                      "Summary",
                      "Skills",
                      "Experience",
                      "..."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/citation": {
      "post": {
        "summary": "Format a source as an APA, MLA or Chicago citation",
        "operationId": "textCitation",
        "description": "Format a source as an APA, MLA or Chicago citation. Send JSON with style, title (required); optional: sourceType, authors, groupAuthor, year, publicationDate, accessDate, siteName, publisher, siteOrPublisher, city, journalName, volume, issue, pages, edition, bookTitle, editors, doi, url, page, chicagoEdition. Returns JSON with the answer as a string in result. Limits: title: up to 500 characters; authors: up to 2000 characters; groupAuthor: up to 300 characters; publicationDate: up to 10 characters; accessDate: up to 10 characters; siteName: up to 300 characters; publisher: up to 300 characters; siteOrPublisher: up to 300 characters; city: up to 200 characters; journalName: up to 300 characters; volume: up to 20 characters; issue: up to 20 characters; pages: up to 30 characters; edition: up to 40 characters; bookTitle: up to 500 characters; editors: up to 1000 characters; doi: up to 200 characters; url: up to 2000 characters; page: up to 30 characters. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "style": {
                    "type": "string",
                    "enum": [
                      "apa",
                      "mla",
                      "chicago"
                    ],
                    "description": "apa: APA 7th edition. mla: MLA 9th edition. chicago: Chicago notes-bibliography (see chicagoEdition)."
                  },
                  "sourceType": {
                    "description": "What is being cited. Default: journal-article when journalName is sent, book-chapter when bookTitle is sent, website when a url is sent without a publisher, otherwise book.",
                    "type": "string",
                    "enum": [
                      "website",
                      "book",
                      "journal-article",
                      "book-chapter"
                    ]
                  },
                  "title": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 500,
                    "description": "The title of the page, book, article or chapter, in the capitalization it should have. APA wants sentence case; MLA and Chicago want headline case. It is used as typed and advice is returned in notes."
                  },
                  "authors": {
                    "description": "People, separated by semicolons, new lines or 'and': 'Smith, Jane; Lee, Kim' or 'Jane Smith and Kim Lee'. 'Last, First' is exact; 'First Last' takes the last word as the surname. Leave out when there is no author (the title leads) and use groupAuthor for an organization.",
                    "type": "string",
                    "maxLength": 2000
                  },
                  "groupAuthor": {
                    "description": "An organization as the author, for example World Health Organization.",
                    "type": "string",
                    "maxLength": 300
                  },
                  "year": {
                    "description": "Year as 2025 or a string such as 2025 or n.d. A negative or non-year number is a 422. Left out: n.d.",
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 10
                      },
                      {
                        "type": "number"
                      }
                    ]
                  },
                  "publicationDate": {
                    "description": "Full date YYYY-MM-DD (websites): written as April 24, 2025 in APA, 24 Apr. 2025 in MLA, April 24, 2025 in Chicago. Replaces year.",
                    "type": "string",
                    "maxLength": 10
                  },
                  "accessDate": {
                    "description": "YYYY-MM-DD. Websites: MLA prints it when sent (and, with today's date, when the page has no date); Chicago prints it only for undated pages; APA never does.",
                    "type": "string",
                    "maxLength": 10
                  },
                  "siteName": {
                    "description": "Websites: the name of the site (left out in APA when it is the same as the author).",
                    "type": "string",
                    "maxLength": 300
                  },
                  "publisher": {
                    "description": "Books and chapters: the publisher's name only.",
                    "type": "string",
                    "maxLength": 300
                  },
                  "siteOrPublisher": {
                    "description": "Older field: becomes siteName for a website, the journal name for a journal article, and the publisher otherwise.",
                    "type": "string",
                    "maxLength": 300
                  },
                  "city": {
                    "description": "Chicago 17th: publisher city for books and chapters. Ignored by APA and MLA, and by Chicago 18th.",
                    "type": "string",
                    "maxLength": 200
                  },
                  "journalName": {
                    "description": "Journal articles: the journal's title (required for journal-article).",
                    "type": "string",
                    "maxLength": 300
                  },
                  "volume": {
                    "type": "string",
                    "maxLength": 20
                  },
                  "issue": {
                    "type": "string",
                    "maxLength": 20
                  },
                  "pages": {
                    "description": "A page range such as 45-60 (en dash, hyphen or em dash), or a single page, or an article number such as e0193972.",
                    "type": "string",
                    "maxLength": 30
                  },
                  "edition": {
                    "description": "Books: 2, 2nd or 2nd ed. All become 2nd ed.",
                    "type": "string",
                    "maxLength": 40
                  },
                  "bookTitle": {
                    "description": "Chapters: the title of the book that holds the chapter (required for book-chapter).",
                    "type": "string",
                    "maxLength": 500
                  },
                  "editors": {
                    "description": "Chapters: the book's editors, written like authors.",
                    "type": "string",
                    "maxLength": 1000
                  },
                  "doi": {
                    "description": "A DOI (10.1037/ppm0000185) or its link. Written as an https://doi.org/ link, and used instead of a URL.",
                    "type": "string",
                    "maxLength": 200
                  },
                  "url": {
                    "description": "The web address. For a website it is the page; for a book, article or chapter it is used only when there is no DOI. https:// is added to a bare domain.",
                    "type": "string",
                    "maxLength": 2000
                  },
                  "page": {
                    "description": "The page or page range you are quoting, for the in-text citation or Chicago note.",
                    "type": "string",
                    "maxLength": 30
                  },
                  "chicagoEdition": {
                    "description": "Chicago only. 17 (default): the edition the site's Citation Generator uses, publisher city included. 18: the newest edition (2024), no publisher city, up to 6 authors in a bibliography.",
                    "type": "string",
                    "enum": [
                      "17",
                      "18"
                    ]
                  }
                },
                "required": [
                  "style",
                  "title"
                ],
                "additionalProperties": false
              },
              "example": {
                "style": "apa",
                "authors": "Ada Lovelace",
                "title": "Notes on the Analytical Engine",
                "year": 1843,
                "siteOrPublisher": "Taylor's Scientific Memoirs"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "style": {
                          "type": "string",
                          "description": "apa, mla or chicago"
                        },
                        "sourceType": {
                          "type": "string",
                          "description": "Kind of source"
                        },
                        "manual": {
                          "type": "string",
                          "description": "Which style manual the format follows"
                        },
                        "citation": {
                          "type": "string",
                          "description": "The reference-list citation as plain text"
                        },
                        "html": {
                          "type": "string",
                          "description": "The same citation with italics as HTML"
                        },
                        "segments": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "t": {
                                "type": "string",
                                "description": "Text of the segment"
                              },
                              "i": {
                                "type": "boolean",
                                "description": "Italic"
                              }
                            },
                            "required": [
                              "t"
                            ]
                          },
                          "description": "The citation split into plain and italic parts"
                        },
                        "label": {
                          "type": "string",
                          "description": "Short label for the citation"
                        },
                        "notes": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "description": "A note"
                          },
                          "description": "Things to check by hand"
                        },
                        "inText": {
                          "type": "object",
                          "properties": {
                            "parenthetical": {
                              "type": "string",
                              "description": "In-text citation in brackets"
                            },
                            "narrative": {
                              "type": "string",
                              "description": "In-text citation inside a sentence"
                            }
                          },
                          "required": [
                            "parenthetical",
                            "narrative"
                          ]
                        }
                      },
                      "required": [
                        "style",
                        "citation"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Citation generator client and server side from freedailypro",
                  "result": "Ada Lovelace (1843). Notes on the Analytical Engine. Taylor's Scientific Memoirs"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/text/paper-format": {
      "post": {
        "summary": "Check a paper's headings, paragraphs and spacing hints and return format notes",
        "operationId": "textPaperFormat",
        "description": "Check a paper's headings, paragraphs and spacing hints and return format notes. Send JSON with no required fields; optional: style, text. Returns JSON with words, hasTitleLikeHeading, hasDoubleSpacingHint, paragraphCount, notes (inside result). Limits: text: up to 2000000 characters. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Text"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "style": {
                    "description": "The style to return formatting rules for: apa (7th edition), mla (9th) or chicago (Turabian/Chicago student-paper defaults). Leave out to get all three in `guides`.",
                    "type": "string",
                    "enum": [
                      "apa",
                      "mla",
                      "chicago"
                    ]
                  },
                  "text": {
                    "description": "Optional paper text. When sent, the response also counts words and paragraphs and looks for the reference-list heading the style expects. The text carries no fonts or margins, so layout cannot be checked from it: use the site's Paper Format Checker on a .docx for that.",
                    "type": "string",
                    "maxLength": 2000000
                  }
                },
                "additionalProperties": false
              },
              "example": {
                "text": "Introduction\n\nThis paper studies the effect of sleep on memory. We review twelve studies published since 2015."
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "properties": {
                        "guides": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "Formatting guides keyed by style (apa, mla, chicago): page, font, spacing, title page, headings, reference list, citations and sources"
                        },
                        "textStats": {
                          "type": "object",
                          "properties": {
                            "words": {
                              "type": "number",
                              "description": "Words"
                            },
                            "paragraphCount": {
                              "type": "number",
                              "description": "Paragraphs"
                            },
                            "referenceHeadingFound": {
                              "type": "boolean",
                              "description": "Whether a reference-list heading was found"
                            },
                            "expectedReferenceHeading": {
                              "type": "string",
                              "description": "The heading the chosen style expects"
                            }
                          },
                          "required": [
                            "words",
                            "paragraphCount"
                          ]
                        },
                        "disclaimer": {
                          "type": "string",
                          "description": "What the guide does not cover"
                        }
                      },
                      "required": [
                        "guides",
                        "disclaimer"
                      ]
                    }
                  },
                  "required": [
                    "result"
                  ]
                },
                "example": {
                  "tool": "Paper format checker client and server side from freedailypro",
                  "result": {
                    "words": 17,
                    "hasTitleLikeHeading": true,
                    "hasDoubleSpacingHint": false,
                    "paragraphCount": 2,
                    "notes": [
                      "Heuristic only — not a full APA/MLA layout engine."
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/pay-stub": {
      "post": {
        "summary": "Generate a pay stub with gross pay, deductions and net pay",
        "operationId": "businessPayStub",
        "description": "Generate a pay stub with gross pay, deductions and net pay. Send JSON with employer, employee, periodStart, periodEnd, payDate, payType, rate (required); optional: hours, overtimeHours, otMultiplier, bonus, fedPct, statePct, ssPct, medPct, health, retire, other, ytdGross, employerAddress, employeeId. Returns JSON with figures, document (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents",
          "Payroll & Paycheck"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "employer": {
                    "type": "string",
                    "minLength": 1
                  },
                  "employee": {
                    "type": "string",
                    "minLength": 1
                  },
                  "periodStart": {
                    "type": "string",
                    "minLength": 1
                  },
                  "periodEnd": {
                    "type": "string",
                    "minLength": 1
                  },
                  "payDate": {
                    "type": "string",
                    "minLength": 1
                  },
                  "payType": {
                    "type": "string",
                    "enum": [
                      "hourly",
                      "salary"
                    ]
                  },
                  "rate": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Hourly rate, or the salary for this period"
                  },
                  "hours": {
                    "type": "string"
                  },
                  "overtimeHours": {
                    "type": "string"
                  },
                  "otMultiplier": {
                    "type": "string"
                  },
                  "bonus": {
                    "type": "string"
                  },
                  "fedPct": {
                    "type": "string"
                  },
                  "statePct": {
                    "type": "string"
                  },
                  "ssPct": {
                    "type": "string"
                  },
                  "medPct": {
                    "type": "string"
                  },
                  "health": {
                    "type": "string"
                  },
                  "retire": {
                    "type": "string"
                  },
                  "other": {
                    "type": "string"
                  },
                  "ytdGross": {
                    "type": "string"
                  },
                  "employerAddress": {
                    "type": "string"
                  },
                  "employeeId": {
                    "type": "string"
                  }
                },
                "required": [
                  "employer",
                  "employee",
                  "periodStart",
                  "periodEnd",
                  "payDate",
                  "payType",
                  "rate"
                ],
                "additionalProperties": false
              },
              "example": {
                "employer": "Northwind Design LLC",
                "employee": "Maria Lopez",
                "periodStart": "2026-10-01",
                "periodEnd": "2026-10-15",
                "payDate": "2026-10-20",
                "payType": "hourly",
                "rate": "28.50",
                "hours": "80",
                "overtimeHours": "4",
                "fedPct": "12",
                "statePct": "4",
                "ssPct": "6.2",
                "medPct": "1.45",
                "health": "85"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Pay stub generator client and server side from freedailypro",
                  "result": {
                    "figures": {
                      "regular": 2280,
                      "overtime": 171,
                      "bonus": 0,
                      "gross": 2451,
                      "deductions": [
                        {
                          "label": "Federal income tax",
                          "amount": 294.12
                        },
                        {
                          "label": "State income tax",
                          "amount": 98.04
                        },
                        {
                          "label": "Social Security",
                          "amount": 151.96
                        },
                        "..."
                      ],
                      "totalDeductions": 664.66,
                      "net": 1786.34,
                      "regularHours": 80,
                      "overtimeHours": 4
                    },
                    "document": {
                      "title": "Pay Stub",
                      "sections": [
                        {
                          "paragraphs": [
                            "Employer: Northwind Design LLC",
                            "Employee: Maria Lopez",
                            "Pay period: 2026-10-01 to 2026-10-15",
                            "..."
                          ]
                        },
                        {
                          "heading": "Earnings",
                          "paragraphs": [
                            "Regular pay (80 h at $28.50): $2,280.00",
                            "Overtime (4 h): $171.00",
                            "Gross pay: $2,451.00"
                          ]
                        },
                        {
                          "heading": "Deductions",
                          "paragraphs": [
                            "Federal income tax: -$294.12",
                            "State income tax: -$98.04",
                            "Social Security: -$151.96",
                            "..."
                          ]
                        },
                        "..."
                      ],
                      "filename": "pay-stub-maria-lopez-2026-10-20.docx"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/proposal": {
      "post": {
        "summary": "Build a client proposal with scope, timeline and pricing sections",
        "operationId": "businessProposal",
        "description": "Build a client proposal with scope, timeline and pricing sections. Send JSON with you, client, date, summary, scope, prices (required); optional: title, validDays, outOfScope, deliverables, timeline, terms. Returns JSON with title, subtitle, sections, filename (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "you": {
                    "type": "string",
                    "minLength": 1
                  },
                  "client": {
                    "type": "string",
                    "minLength": 1
                  },
                  "date": {
                    "type": "string",
                    "minLength": 1
                  },
                  "summary": {
                    "type": "string",
                    "minLength": 1
                  },
                  "scope": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Scope of work, one item per line"
                  },
                  "prices": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Price lines with the amount at the end, for example Design: $1,200"
                  },
                  "title": {
                    "type": "string"
                  },
                  "validDays": {
                    "type": "string"
                  },
                  "outOfScope": {
                    "type": "string"
                  },
                  "deliverables": {
                    "type": "string"
                  },
                  "timeline": {
                    "type": "string"
                  },
                  "terms": {
                    "type": "string"
                  }
                },
                "required": [
                  "you",
                  "client",
                  "date",
                  "summary",
                  "scope",
                  "prices"
                ],
                "additionalProperties": false
              },
              "example": {
                "you": "Northwind Design LLC",
                "client": "Harbor Coffee Co.",
                "date": "2026-10-20",
                "title": "Website redesign",
                "summary": "A new five-page website with online ordering.",
                "scope": "Design five pages\nBuild and test the ordering form\nLaunch and train staff",
                "prices": "Design: $2,400\nBuild: $3,600\nTraining: $300",
                "validDays": "30"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Proposal builder client and server side from freedailypro",
                  "result": {
                    "title": "Website redesign",
                    "subtitle": "for Harbor Coffee Co.",
                    "sections": [
                      {
                        "paragraphs": [
                          "Prepared for: Harbor Coffee Co.",
                          "Prepared by: Northwind Design LLC",
                          "Date: 2026-10-20",
                          "..."
                        ]
                      },
                      {
                        "heading": "1. Summary",
                        "paragraphs": [
                          "A new five-page website with online ordering."
                        ]
                      },
                      {
                        "heading": "2. Scope of work",
                        "paragraphs": [],
                        "bullets": [
                          "Design five pages",
                          "Build and test the ordering form",
                          "Launch and train staff"
                        ]
                      },
                      "..."
                    ],
                    "filename": "proposal-harbor-coffee-co.docx"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/business/rental-application": {
      "post": {
        "summary": "Build a rental application for a property from the rent, deposit and move-in date",
        "operationId": "businessRentalApplication",
        "description": "Build a rental application for a property from the rent, deposit and move-in date. Send JSON with property, landlord (required); optional: rent, deposit, moveIn, fee, pets. Returns JSON with title, subtitle, sections, filename (inside result). Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Documents"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "property": {
                    "type": "string",
                    "minLength": 1
                  },
                  "landlord": {
                    "type": "string",
                    "minLength": 1
                  },
                  "rent": {
                    "type": "string"
                  },
                  "deposit": {
                    "type": "string"
                  },
                  "moveIn": {
                    "type": "string"
                  },
                  "fee": {
                    "type": "string"
                  },
                  "pets": {
                    "type": "string",
                    "enum": [
                      "yes",
                      "no"
                    ]
                  }
                },
                "required": [
                  "property",
                  "landlord"
                ],
                "additionalProperties": false
              },
              "example": {
                "property": "14 Elm Street, Unit 2B, Austin, TX",
                "landlord": "Elm Street Properties",
                "rent": "1850",
                "deposit": "1850",
                "moveIn": "2026-11-15",
                "fee": "45",
                "pets": "no"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "tool": "Rental application maker client and server side from freedailypro",
                  "result": {
                    "title": "Rental Application",
                    "subtitle": "14 Elm Street, Unit 2B, Austin, TX",
                    "sections": [
                      {
                        "paragraphs": [
                          "Property applied for: 14 Elm Street, Unit 2B, Austin, TX",
                          "Monthly rent: 1850",
                          "Security deposit: 1850",
                          "..."
                        ]
                      },
                      {
                        "heading": "1. Applicant",
                        "paragraphs": [
                          "Full legal name: ______________________________________",
                          "Date of birth: ______________________________________",
                          "Phone: ______________________________________",
                          "..."
                        ]
                      },
                      {
                        "heading": "2. Other adults and children who will live there",
                        "paragraphs": [
                          "Name and relationship: ______________________________________",
                          "Name and relationship: ______________________________________",
                          "Name and relationship: ______________________________________"
                        ]
                      },
                      "..."
                    ],
                    "filename": "rental-application-14-elm-street-unit-2b-austin-tx.docx"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pdf/compress/lossless-bw": {
      "post": {
        "summary": "Compress a scanned PDF to lossless black-and-white",
        "operationId": "pdfCompressLosslessBw",
        "description": "Last-resort compression for scans. Turns pages into pure black-and-white JBIG2 pictures (1 bit per pixel, 150 dpi by default; every pixel darker than mid-grey becomes black), each page coded on its own and exactly as read, so no letter is ever swapped: safe for contracts and numbers. Colour and shading are lost and text on converted pages is no longer selectable. A page is converted only when that makes it at least 10% smaller than the page as it is; every other page (for example real-text pages) is copied untouched. Returns one PDF. Use /v1/pdf/compress/smallest-bw for a much smaller file or /v1/pdf/compress/greyscale to keep shading. Errors: 400 for a bad option or an upload over 20 MB, 422 with a plain message when the PDF is unreadable, password-protected, over 100 pages, or when no smaller file can be made (the original is then the better file). Still supported: this is one of the pieces of /v1/pdf/compress/extreme, which runs the whole ladder (Balanced, Aggressive, then these) and returns the smallest. Response headers: X-Original-Bytes, X-Compressed-Bytes, X-Pages-Converted, X-Pages-Total, X-Reduction-Percent. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF. Up to 20 MB and 100 pages."
                  },
                  "dpi": {
                    "type": "number",
                    "description": "Render resolution, 100 to 200 (default 150). Higher is sharper and larger.",
                    "minimum": 100,
                    "maximum": 200,
                    "default": 150
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pdf"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 8,531 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Compressed-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "8531"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "23570"
              },
              "X-Pages-Converted": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "2"
              },
              "X-Pages-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "2"
              },
              "X-Reduction-Percent": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "63.8"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pdf/compress/smallest-bw": {
      "post": {
        "summary": "Compress a scanned PDF to the smallest black-and-white file",
        "operationId": "pdfCompressSmallestBw",
        "description": "Last-resort compression for scans, smallest result. Pure black-and-white JBIG2 in symbol mode: each letter shape is stored once and reused across all pages, typically about 3 times smaller than lossless-bw. Caution: because look-alike letters share one stored shape, a letter can very rarely be swapped for a look-alike one (for example a 6 and an 8 in tiny print), so read important numbers in the original or use /v1/pdf/compress/lossless-bw. Colour and shading are lost and text on converted pages is no longer selectable. A page is converted only when that makes it at least 10% smaller; every other page is copied untouched. Returns one PDF. Errors: 400 for a bad option or an upload over 20 MB, 422 with a plain message when the PDF is unreadable, password-protected, over 100 pages, or when no smaller file can be made (the original is then the better file). Still supported: this is one of the pieces of /v1/pdf/compress/extreme, which runs the whole ladder (Balanced, Aggressive, then these) and returns the smallest. Response headers: X-Original-Bytes, X-Compressed-Bytes, X-Pages-Converted, X-Pages-Total, X-Reduction-Percent. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF. Up to 20 MB and 100 pages."
                  },
                  "dpi": {
                    "type": "number",
                    "description": "Render resolution, 100 to 200 (default 150).",
                    "minimum": 100,
                    "maximum": 200,
                    "default": 150
                  },
                  "threshold": {
                    "type": "number",
                    "description": "How alike two letter shapes must look to share one stored shape, 0.4 to 0.9 (default 0.85). Higher is safer (fewer look-alike swaps) and slightly larger.",
                    "minimum": 0.4,
                    "maximum": 0.9,
                    "default": 0.85
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pdf"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 6,001 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Compressed-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "6001"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "23570"
              },
              "X-Pages-Converted": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "2"
              },
              "X-Pages-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "2"
              },
              "X-Reduction-Percent": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "74.5"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pdf/compress/greyscale": {
      "post": {
        "summary": "Compress a scanned PDF to greyscale pages",
        "operationId": "pdfCompressGreyscale",
        "description": "Last-resort compression for scans that keeps shading and photos: pages become greyscale JPEG pictures at 100 dpi by default (colour is dropped; nothing is thresholded to pure black and white). Larger than the two black-and-white endpoints. Text on converted pages is no longer selectable. A page is converted only when that makes it at least 10% smaller; every other page is copied untouched. Returns one PDF, or 422 with a clear message when the result would not be smaller than the PDF you sent. Errors: 400 for a bad option or an upload over 20 MB, 422 with a plain message when the PDF is unreadable, password-protected, over 100 pages, or when no smaller file can be made (the original is then the better file). Still supported: this is one of the pieces of /v1/pdf/compress/extreme, which runs the whole ladder (Balanced, Aggressive, then these) and returns the smallest. Response headers: X-Original-Bytes, X-Compressed-Bytes, X-Pages-Converted, X-Pages-Total, X-Reduction-Percent. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF. Up to 20 MB and 100 pages."
                  },
                  "dpi": {
                    "type": "number",
                    "description": "Render resolution, 100 to 200 (default 100).",
                    "minimum": 100,
                    "maximum": 200,
                    "default": 100
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pdf"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 14,911 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Compressed-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "14911"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "119040"
              },
              "X-Pages-Converted": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "2"
              },
              "X-Pages-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "2"
              },
              "X-Reduction-Percent": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "87.5"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pdf/compress/balanced": {
      "post": {
        "summary": "Compress a PDF (Balanced)",
        "operationId": "pdfCompressBalanced",
        "description": "The gentle way, the same as Balanced on the website: tidies the file's structure, stores blank pages as empty pages, and re-saves the pictures inside at about 140 dpi. Text stays selectable; links, bookmarks, form fields and page sizes are kept. Fast. Use /v1/pdf/compress/aggressive when this is not small enough. Errors: 400 for a missing file, a bad option or an upload over 20 MB; 422 with a plain message when the PDF is unreadable, password-protected, over 100 pages, or when nothing gets smaller than the original (the original is then the better file); 503 with Retry-After when the server is busy. Every level is a complete file; this endpoint returns the last (smallest) one. Response headers: X-Original-Bytes, X-Compressed-Bytes, X-Reduction-Percent, X-Levels-Applied (comma-separated level ids, in the order they ran, up to and including the file returned; ids are tidy, blank-pages, pictures-quick, pictures-fit, pages-quarters, pages-sixteenths, paper-clean, areas-140dpi, flat-fills, photos-70dpi, text-picture-100dpi, text-100dpi, text-85dpi, greyscale-70dpi, bw-jbig2-lossless, bw-jbig2-smallest), X-Pages-Converted, X-Pages-Total, X-Text-Selectable (true or false), X-Truncated (true when the time budget ran out and the file is the smallest level finished by then; X-Truncated-Reason says why). Limits: 20 MB and 100 pages. The stronger modes render pages and can take several seconds per page, so a request has a time budget (about 25 seconds); when it runs out you get the smallest level finished so far with X-Truncated: true instead of a timeout. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF. Up to 20 MB and 100 pages."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pdf"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 2,852 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Compressed-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "2852"
              },
              "X-Levels-Applied": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "pictures-quick,pictures-fit"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "119040"
              },
              "X-Pages-Converted": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "0"
              },
              "X-Pages-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "2"
              },
              "X-Reduction-Percent": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "97.6"
              },
              "X-Text-Selectable": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "true"
              },
              "X-Truncated": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "false"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pdf/compress/aggressive": {
      "post": {
        "summary": "Compress a PDF (Aggressive)",
        "operationId": "pdfCompressAggressive",
        "description": "Everything Balanced does, then pages become pictures in finer and finer steps, the same as Aggressive on the website: 200 dpi quarters and sixteenths with empty areas dropped, an optional paper clean for scans, then 140 dpi areas, flat areas stored as plain fills, photos at 70 dpi, text with pictures at 100 dpi, text at 100 dpi (small print at 120) and text at 85 dpi. A page is converted only when that is clearly smaller (at least 10%); other pages are kept as they are. Text on converted pages is no longer selectable (X-Text-Selectable says so), and links and form fields on them are gone. Heavier than Balanced. Errors: 400 for a missing file, a bad option or an upload over 20 MB; 422 with a plain message when the PDF is unreadable, password-protected, over 100 pages, or when nothing gets smaller than the original (the original is then the better file); 503 with Retry-After when the server is busy. Every level is a complete file; this endpoint returns the last (smallest) one. Response headers: X-Original-Bytes, X-Compressed-Bytes, X-Reduction-Percent, X-Levels-Applied (comma-separated level ids, in the order they ran, up to and including the file returned; ids are tidy, blank-pages, pictures-quick, pictures-fit, pages-quarters, pages-sixteenths, paper-clean, areas-140dpi, flat-fills, photos-70dpi, text-picture-100dpi, text-100dpi, text-85dpi, greyscale-70dpi, bw-jbig2-lossless, bw-jbig2-smallest), X-Pages-Converted, X-Pages-Total, X-Text-Selectable (true or false), X-Truncated (true when the time budget ran out and the file is the smallest level finished by then; X-Truncated-Reason says why). Limits: 20 MB and 100 pages. The stronger modes render pages and can take several seconds per page, so a request has a time budget (about 25 seconds); when it runs out you get the smallest level finished so far with X-Truncated: true instead of a timeout. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF. Up to 20 MB and 100 pages."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pdf"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 2,852 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Compressed-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "2852"
              },
              "X-Levels-Applied": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "pictures-quick,pictures-fit"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "119040"
              },
              "X-Pages-Converted": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "0"
              },
              "X-Pages-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "2"
              },
              "X-Reduction-Percent": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "97.6"
              },
              "X-Text-Selectable": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "true"
              },
              "X-Truncated": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "false"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pdf/compress/extreme": {
      "post": {
        "summary": "Compress a PDF (Extreme)",
        "operationId": "pdfCompressExtreme",
        "description": "Everything Aggressive does, then every page as 70 dpi greyscale, and as pure black-and-white JBIG2 (exact, then with shared letter shapes), the same as Extreme on the website. The last three levels are alternatives and the smallest is returned. Colour and shading are lost and text is no longer selectable. In the symbol-mode result a letter can very rarely be swapped for a look-alike one (a 6 and an 8 in tiny print), so check important numbers in the original. /v1/pdf/compress/lossless-bw, /smallest-bw and /greyscale are Extreme's pieces and are still supported, with their own options. Errors: 400 for a missing file, a bad option or an upload over 20 MB; 422 with a plain message when the PDF is unreadable, password-protected, over 100 pages, or when nothing gets smaller than the original (the original is then the better file); 503 with Retry-After when the server is busy. Every level is a complete file; this endpoint returns the last (smallest) one. Response headers: X-Original-Bytes, X-Compressed-Bytes, X-Reduction-Percent, X-Levels-Applied (comma-separated level ids, in the order they ran, up to and including the file returned; ids are tidy, blank-pages, pictures-quick, pictures-fit, pages-quarters, pages-sixteenths, paper-clean, areas-140dpi, flat-fills, photos-70dpi, text-picture-100dpi, text-100dpi, text-85dpi, greyscale-70dpi, bw-jbig2-lossless, bw-jbig2-smallest), X-Pages-Converted, X-Pages-Total, X-Text-Selectable (true or false), X-Truncated (true when the time budget ran out and the file is the smallest level finished by then; X-Truncated-Reason says why). Limits: 20 MB and 100 pages. The stronger modes render pages and can take several seconds per page, so a request has a time budget (about 25 seconds); when it runs out you get the smallest level finished so far with X-Truncated: true instead of a timeout. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF. Up to 20 MB and 100 pages."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pdf"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 2,852 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Compressed-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "2852"
              },
              "X-Levels-Applied": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "pictures-quick,pictures-fit"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "119040"
              },
              "X-Pages-Converted": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "0"
              },
              "X-Pages-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "2"
              },
              "X-Reduction-Percent": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "97.6"
              },
              "X-Text-Selectable": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "true"
              },
              "X-Truncated": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "false"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pdf/compress/size": {
      "post": {
        "summary": "Compress a PDF to a size",
        "operationId": "pdfCompressSize",
        "description": "The same ladder as the other modes with a goal in bytes, the same as File size on the website: it runs the steps gentlest first and stops at the first one that fits targetSize. limit says how far it may go: balanced keeps text selectable, aggressive lets pages become pictures, extreme (default) adds greyscale and black and white. If the goal cannot be reached every allowed step is tried and you get the smallest file with X-Target-Met: false and X-Limit-Reason in plain words. A PDF already at or under the goal is returned unchanged with X-Target-Met: true. Extra response headers: X-Target-Bytes, X-Target-Met, X-Limit, X-Limit-Reason (only when the goal was not met). Errors: 400 for a missing file, a bad option or an upload over 20 MB; 422 with a plain message when the PDF is unreadable, password-protected, over 100 pages, or when nothing gets smaller than the original (the original is then the better file); 503 with Retry-After when the server is busy. Every level is a complete file; this endpoint returns the last (smallest) one. Response headers: X-Original-Bytes, X-Compressed-Bytes, X-Reduction-Percent, X-Levels-Applied (comma-separated level ids, in the order they ran, up to and including the file returned; ids are tidy, blank-pages, pictures-quick, pictures-fit, pages-quarters, pages-sixteenths, paper-clean, areas-140dpi, flat-fills, photos-70dpi, text-picture-100dpi, text-100dpi, text-85dpi, greyscale-70dpi, bw-jbig2-lossless, bw-jbig2-smallest), X-Pages-Converted, X-Pages-Total, X-Text-Selectable (true or false), X-Truncated (true when the time budget ran out and the file is the smallest level finished by then; X-Truncated-Reason says why). Limits: 20 MB and 100 pages. The stronger modes render pages and can take several seconds per page, so a request has a time budget (about 25 seconds); when it runs out you get the smallest level finished so far with X-Truncated: true instead of a timeout. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF. Up to 20 MB and 100 pages."
                  },
                  "targetSize": {
                    "type": "string",
                    "description": "The size you want the PDF to end up at, for example 2MB, 500KB or a number of bytes.",
                    "example": "2MB"
                  },
                  "limit": {
                    "type": "string",
                    "description": "How far the steps may go: balanced, aggressive or extreme (default).",
                    "enum": [
                      "balanced",
                      "aggressive",
                      "extreme"
                    ],
                    "default": "extreme"
                  }
                },
                "required": [
                  "file",
                  "targetSize"
                ]
              },
              "example": {
                "file": "sample.pdf",
                "targetSize": "2MB"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 28,531 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Compressed-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "28531"
              },
              "X-Levels-Applied": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "pictures-quick,pictures-fit"
              },
              "X-Limit": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "extreme"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "119040"
              },
              "X-Pages-Converted": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "0"
              },
              "X-Pages-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "2"
              },
              "X-Reduction-Percent": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "76"
              },
              "X-Target-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "30720"
              },
              "X-Target-Met": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "true"
              },
              "X-Text-Selectable": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "true"
              },
              "X-Truncated": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "false"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/extract/text": {
      "post": {
        "summary": "Get the text of a PowerPoint",
        "operationId": "pptxExtractText",
        "description": "Returns the text of every slide: titles, bullets with their level, and tables, optionally with the speaker notes. format txt (default), md or json (slides with number, title, hidden, paragraphs, tables and notes). Hidden slides are skipped unless includeHidden is true. Charts and diagrams are not read. 422 when the deck has no text at all. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "format": {
                    "type": "string",
                    "description": "txt (default), md or json",
                    "enum": [
                      "txt",
                      "md",
                      "json"
                    ]
                  },
                  "includeHidden": {
                    "type": "boolean",
                    "description": "Include hidden slides. Default false."
                  },
                  "includeNotes": {
                    "type": "boolean",
                    "description": "Add each slide's speaker notes. Default false."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "format": {
                    "type": "string",
                    "description": "txt (default), md or json",
                    "enum": [
                      "txt",
                      "md",
                      "json"
                    ]
                  },
                  "includeHidden": {
                    "type": "boolean",
                    "description": "Include hidden slides. Default false."
                  },
                  "includeNotes": {
                    "type": "boolean",
                    "description": "Add each slide's speaker notes. Default false."
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, text/plain, 372 bytes.",
            "content": {
              "text/plain, text/markdown or application/json": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides in the deck",
                "example": "6"
              },
              "X-Slides-With-Text": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides that have text",
                "example": "5"
              },
              "X-Words": {
                "schema": {
                  "type": "string"
                },
                "description": "Words counted",
                "example": "37"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/extract/notes": {
      "post": {
        "summary": "Get the speaker notes of a PowerPoint",
        "operationId": "pptxExtractNotes",
        "description": "Returns the speaker notes slide by slide as plain text, Markdown, or a Word document (.docx). Notes of hidden slides are skipped unless includeHidden is true. 422 when the deck has no speaker notes. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "format": {
                    "type": "string",
                    "description": "txt (default), md or docx",
                    "enum": [
                      "txt",
                      "md",
                      "docx"
                    ]
                  },
                  "includeHidden": {
                    "type": "boolean",
                    "description": "Include notes of hidden slides. Default false."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "format": {
                    "type": "string",
                    "description": "txt (default), md or docx",
                    "enum": [
                      "txt",
                      "md",
                      "docx"
                    ]
                  },
                  "includeHidden": {
                    "type": "boolean",
                    "description": "Include notes of hidden slides. Default false."
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, text/plain, 191 bytes.",
            "content": {
              "text/plain, text/markdown or application/vnd.openxmlformats-officedocument.wordprocessingml.document": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides in the deck",
                "example": "6"
              },
              "X-Slides-With-Notes": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides that have notes in the result",
                "example": "3"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/extract/images": {
      "post": {
        "summary": "Extract the pictures of a PowerPoint",
        "operationId": "pptxExtractImages",
        "description": "Returns a ZIP with every picture of the deck exactly as stored (no re-encoding), named by slide, for example slide02_image-2-1.jpeg. Pictures only the slide design uses (a logo on the master) are left out unless includeTemplatePictures is true; pictures only on hidden slides are left out unless includeHidden is true. 422 when there are none. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "includeHidden": {
                    "type": "boolean",
                    "description": "Include pictures that appear only on hidden slides. Default false."
                  },
                  "includeTemplatePictures": {
                    "type": "boolean",
                    "description": "Include pictures used only by the master or layouts. Default false."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "includeHidden": {
                    "type": "boolean",
                    "description": "Include pictures that appear only on hidden slides. Default false."
                  },
                  "includeTemplatePictures": {
                    "type": "boolean",
                    "description": "Include pictures used only by the master or layouts. Default false."
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/zip, 422,271 bytes.",
            "content": {
              "application/zip": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides in the deck",
                "example": "6"
              },
              "X-Pictures": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures in the ZIP",
                "example": "1"
              },
              "X-Pictures-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Their total size",
                "example": "422137"
              },
              "X-Picture-Files": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "slide05_image1.jpg"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/clean": {
      "post": {
        "summary": "Remove notes, comments, hidden slides and author details from a PowerPoint",
        "operationId": "pptxClean",
        "description": "Strips what you do not want to share and returns a clean .pptx: speaker notes, comments, hidden slides, author and company details with the revision list, and the stored preview picture (all on by default); document properties (title, subject, keywords) and custom properties are off by default. Slides, layouts and formatting are untouched, and parts only the removed slides used are dropped. Set an option to false to keep that thing. 422 when every slide is hidden and hiddenSlides is on. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "notes": {
                    "type": "boolean",
                    "description": "Remove speaker notes. Default true."
                  },
                  "comments": {
                    "type": "boolean",
                    "description": "Remove comments. Default true."
                  },
                  "hiddenSlides": {
                    "type": "boolean",
                    "description": "Delete slides that are hidden when presenting. Default true."
                  },
                  "authorInfo": {
                    "type": "boolean",
                    "description": "Remove author, last modified by, company, manager and the revision list. Default true."
                  },
                  "thumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true."
                  },
                  "documentProperties": {
                    "type": "boolean",
                    "description": "Also clear title, subject, keywords, description and category. Default false."
                  },
                  "customProperties": {
                    "type": "boolean",
                    "description": "Also remove custom document properties. Default false."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "notes": {
                    "type": "boolean",
                    "description": "Remove speaker notes. Default true."
                  },
                  "comments": {
                    "type": "boolean",
                    "description": "Remove comments. Default true."
                  },
                  "hiddenSlides": {
                    "type": "boolean",
                    "description": "Delete slides that are hidden when presenting. Default true."
                  },
                  "authorInfo": {
                    "type": "boolean",
                    "description": "Remove author, last modified by, company, manager and the revision list. Default true."
                  },
                  "thumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true."
                  },
                  "documentProperties": {
                    "type": "boolean",
                    "description": "Also clear title, subject, keywords, description and category. Default false."
                  },
                  "customProperties": {
                    "type": "boolean",
                    "description": "Also remove custom document properties. Default false."
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 456,246 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file you sent",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "456246"
              },
              "X-Slides-Before": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides before",
                "example": "6"
              },
              "X-Slides-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides after",
                "example": "5"
              },
              "X-Notes-Pages-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Notes pages removed",
                "example": "3"
              },
              "X-Comments-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Comments removed",
                "example": "0"
              },
              "X-Hidden-Slides-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Hidden slides removed",
                "example": "1"
              },
              "X-Summary": {
                "schema": {
                  "type": "string"
                },
                "description": "Everything removed, in plain words",
                "example": "Removed 3 notes pages; No comments found; Removed 1 hidden slide; Removed author, last modified by; Removed the stored preview picture"
              },
              "X-Author-Info-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "2"
              },
              "X-Custom-Properties-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "0"
              },
              "X-Document-Properties-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "0"
              },
              "X-Thumbnail-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "1"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/compress/default": {
      "post": {
        "summary": "Compress a PowerPoint (Default level)",
        "operationId": "pptxCompressDefault",
        "description": "Re-saves the pictures at the Default level, the sharpest: up to 220 dpi at JPEG quality 82; PNG stays PNG. Pictures (JPEG, PNG, BMP) are re-saved smaller, unused slide layouts and the stored preview picture are removed, and the file is re-packed at maximum compression; text, charts, animations, audio and video stay exactly as they are, so the deck is still fully editable. Always returns a .pptx, even a deck with no pictures (the X-Note header says when it could not get smaller). Errors: 400 for a missing file or bad option; 422 with a plain reason when the file is not a readable .pptx or when the 25 second time budget runs out; 503 with Retry-After when two compressions are already running. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "removeNotes": {
                    "type": "boolean",
                    "description": "Also remove speaker notes first. Default false."
                  },
                  "removeThumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true; send false to keep it."
                  },
                  "removeUnusedLayouts": {
                    "type": "boolean",
                    "description": "Remove slide layouts no slide uses, and the pictures only they carry. Default true; send false to keep them."
                  },
                  "maxDpi": {
                    "type": "number",
                    "description": "Never keep pictures sharper than this many dpi, 48 to 300, on top of the level.",
                    "minimum": 48,
                    "maximum": 300
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "removeNotes": {
                    "type": "boolean",
                    "description": "Also remove speaker notes first. Default false."
                  },
                  "removeThumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true; send false to keep it."
                  },
                  "removeUnusedLayouts": {
                    "type": "boolean",
                    "description": "Remove slide layouts no slide uses, and the pictures only they carry. Default true; send false to keep them."
                  },
                  "maxDpi": {
                    "type": "number",
                    "description": "Never keep pictures sharper than this many dpi, 48 to 300, on top of the level.",
                    "minimum": 48,
                    "maximum": 300
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 329,617 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file you sent",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "329617"
              },
              "X-Reduction-Percent": {
                "schema": {
                  "type": "string"
                },
                "description": "How much smaller, in percent",
                "example": "29.5"
              },
              "X-Level": {
                "schema": {
                  "type": "string"
                },
                "description": "The picture setting used (default, medium, strong, or t1 to t6 between and beyond them in size mode)",
                "example": "default"
              },
              "X-Pictures-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures in the deck",
                "example": "1"
              },
              "X-Pictures-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures re-saved smaller",
                "example": "1"
              },
              "X-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "What the optional removals took out"
              },
              "X-Target-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: the goal in bytes"
              },
              "X-Target-Met": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: true when the file fits the goal"
              },
              "X-Note": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: why the goal was not reached, in plain words"
              },
              "X-Picture-Bytes-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "283497"
              },
              "X-Picture-Bytes-Before": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "422137"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          },
          "503": {
            "description": "Busy: retry after the number of seconds in the Retry-After header"
          }
        }
      }
    },
    "/v1/pptx/compress/medium": {
      "post": {
        "summary": "Compress a PowerPoint (Medium level)",
        "operationId": "pptxCompressMedium",
        "description": "Re-saves the pictures at the Medium level: up to 150 dpi at JPEG quality 72, and an opaque PNG photo becomes a JPEG when that is under half its size. A good size for email. Pictures (JPEG, PNG, BMP) are re-saved smaller, unused slide layouts and the stored preview picture are removed, and the file is re-packed at maximum compression; text, charts, animations, audio and video stay exactly as they are, so the deck is still fully editable. Always returns a .pptx, even a deck with no pictures (the X-Note header says when it could not get smaller). Errors: 400 for a missing file or bad option; 422 with a plain reason when the file is not a readable .pptx or when the 25 second time budget runs out; 503 with Retry-After when two compressions are already running. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "removeNotes": {
                    "type": "boolean",
                    "description": "Also remove speaker notes first. Default false."
                  },
                  "removeThumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true; send false to keep it."
                  },
                  "removeUnusedLayouts": {
                    "type": "boolean",
                    "description": "Remove slide layouts no slide uses, and the pictures only they carry. Default true; send false to keep them."
                  },
                  "maxDpi": {
                    "type": "number",
                    "description": "Never keep pictures sharper than this many dpi, 48 to 300, on top of the level.",
                    "minimum": 48,
                    "maximum": 300
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "removeNotes": {
                    "type": "boolean",
                    "description": "Also remove speaker notes first. Default false."
                  },
                  "removeThumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true; send false to keep it."
                  },
                  "removeUnusedLayouts": {
                    "type": "boolean",
                    "description": "Remove slide layouts no slide uses, and the pictures only they carry. Default true; send false to keep them."
                  },
                  "maxDpi": {
                    "type": "number",
                    "description": "Never keep pictures sharper than this many dpi, 48 to 300, on top of the level.",
                    "minimum": 48,
                    "maximum": 300
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 144,397 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file you sent",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "144397"
              },
              "X-Reduction-Percent": {
                "schema": {
                  "type": "string"
                },
                "description": "How much smaller, in percent",
                "example": "69.1"
              },
              "X-Level": {
                "schema": {
                  "type": "string"
                },
                "description": "The picture setting used (default, medium, strong, or t1 to t6 between and beyond them in size mode)",
                "example": "medium"
              },
              "X-Pictures-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures in the deck",
                "example": "1"
              },
              "X-Pictures-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures re-saved smaller",
                "example": "1"
              },
              "X-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "What the optional removals took out"
              },
              "X-Target-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: the goal in bytes"
              },
              "X-Target-Met": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: true when the file fits the goal"
              },
              "X-Note": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: why the goal was not reached, in plain words"
              },
              "X-Picture-Bytes-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "98277"
              },
              "X-Picture-Bytes-Before": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "422137"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          },
          "503": {
            "description": "Busy: retry after the number of seconds in the Retry-After header"
          }
        }
      }
    },
    "/v1/pptx/compress/strong": {
      "post": {
        "summary": "Compress a PowerPoint (Strong level)",
        "operationId": "pptxCompressStrong",
        "description": "Re-saves the pictures at the Strong level, the smallest of the three: up to 110 dpi at JPEG quality 58. Fine on screen, soft in print. Pictures (JPEG, PNG, BMP) are re-saved smaller, unused slide layouts and the stored preview picture are removed, and the file is re-packed at maximum compression; text, charts, animations, audio and video stay exactly as they are, so the deck is still fully editable. Always returns a .pptx, even a deck with no pictures (the X-Note header says when it could not get smaller). Errors: 400 for a missing file or bad option; 422 with a plain reason when the file is not a readable .pptx or when the 25 second time budget runs out; 503 with Retry-After when two compressions are already running. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "removeNotes": {
                    "type": "boolean",
                    "description": "Also remove speaker notes first. Default false."
                  },
                  "removeThumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true; send false to keep it."
                  },
                  "removeUnusedLayouts": {
                    "type": "boolean",
                    "description": "Remove slide layouts no slide uses, and the pictures only they carry. Default true; send false to keep them."
                  },
                  "maxDpi": {
                    "type": "number",
                    "description": "Never keep pictures sharper than this many dpi, 48 to 300, on top of the level.",
                    "minimum": 48,
                    "maximum": 300
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "removeNotes": {
                    "type": "boolean",
                    "description": "Also remove speaker notes first. Default false."
                  },
                  "removeThumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true; send false to keep it."
                  },
                  "removeUnusedLayouts": {
                    "type": "boolean",
                    "description": "Remove slide layouts no slide uses, and the pictures only they carry. Default true; send false to keep them."
                  },
                  "maxDpi": {
                    "type": "number",
                    "description": "Never keep pictures sharper than this many dpi, 48 to 300, on top of the level.",
                    "minimum": 48,
                    "maximum": 300
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 90,086 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file you sent",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "90086"
              },
              "X-Reduction-Percent": {
                "schema": {
                  "type": "string"
                },
                "description": "How much smaller, in percent",
                "example": "80.7"
              },
              "X-Level": {
                "schema": {
                  "type": "string"
                },
                "description": "The picture setting used (default, medium, strong, or t1 to t6 between and beyond them in size mode)",
                "example": "strong"
              },
              "X-Pictures-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures in the deck",
                "example": "1"
              },
              "X-Pictures-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures re-saved smaller",
                "example": "1"
              },
              "X-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "What the optional removals took out"
              },
              "X-Target-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: the goal in bytes"
              },
              "X-Target-Met": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: true when the file fits the goal"
              },
              "X-Note": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: why the goal was not reached, in plain words"
              },
              "X-Picture-Bytes-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "43966"
              },
              "X-Picture-Bytes-Before": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "422137"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          },
          "503": {
            "description": "Busy: retry after the number of seconds in the Retry-After header"
          }
        }
      }
    },
    "/v1/pptx/compress/size": {
      "post": {
        "summary": "Compress a PowerPoint to a size",
        "operationId": "pptxCompressSize",
        "description": "Runs nine picture settings from the sharpest to the coarsest and returns the sharpest result that fits targetSize (X-Target-Met: true). If even the coarsest does not fit you get the smallest file it can make with X-Target-Met: false and X-Note in plain words. A deck already at or under the goal comes back unchanged (X-Level: none). Pictures (JPEG, PNG, BMP) are re-saved smaller, unused slide layouts and the stored preview picture are removed, and the file is re-packed at maximum compression; text, charts, animations, audio and video stay exactly as they are, so the deck is still fully editable. Always returns a .pptx, even a deck with no pictures (the X-Note header says when it could not get smaller). Errors: 400 for a missing file or bad option; 422 with a plain reason when the file is not a readable .pptx or when the 25 second time budget runs out; 503 with Retry-After when two compressions are already running. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "removeNotes": {
                    "type": "boolean",
                    "description": "Also remove speaker notes first. Default false."
                  },
                  "removeThumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true; send false to keep it."
                  },
                  "removeUnusedLayouts": {
                    "type": "boolean",
                    "description": "Remove slide layouts no slide uses, and the pictures only they carry. Default true; send false to keep them."
                  },
                  "maxDpi": {
                    "type": "number",
                    "description": "Never keep pictures sharper than this many dpi, 48 to 300, on top of the level.",
                    "minimum": 48,
                    "maximum": 300
                  },
                  "targetSize": {
                    "type": "string",
                    "description": "The size to reach: bytes, or text such as 10MB or 800KB (at least 1 KB).",
                    "example": "10MB"
                  }
                },
                "required": [
                  "file",
                  "targetSize"
                ]
              },
              "example": {
                "file": "sample.pptx",
                "targetSize": "10MB"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "removeNotes": {
                    "type": "boolean",
                    "description": "Also remove speaker notes first. Default false."
                  },
                  "removeThumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true; send false to keep it."
                  },
                  "removeUnusedLayouts": {
                    "type": "boolean",
                    "description": "Remove slide layouts no slide uses, and the pictures only they carry. Default true; send false to keep them."
                  },
                  "maxDpi": {
                    "type": "number",
                    "description": "Never keep pictures sharper than this many dpi, 48 to 300, on top of the level.",
                    "minimum": 48,
                    "maximum": 300
                  },
                  "targetSize": {
                    "type": "string",
                    "description": "The size to reach: bytes, or text such as 10MB or 800KB (at least 1 KB).",
                    "example": "10MB"
                  }
                },
                "required": [
                  "fileBase64",
                  "targetSize"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 90,086 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file you sent",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "90086"
              },
              "X-Reduction-Percent": {
                "schema": {
                  "type": "string"
                },
                "description": "How much smaller, in percent",
                "example": "80.7"
              },
              "X-Level": {
                "schema": {
                  "type": "string"
                },
                "description": "The picture setting used (default, medium, strong, or t1 to t6 between and beyond them in size mode)",
                "example": "strong"
              },
              "X-Pictures-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures in the deck",
                "example": "1"
              },
              "X-Pictures-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures re-saved smaller",
                "example": "1"
              },
              "X-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "What the optional removals took out"
              },
              "X-Target-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: the goal in bytes",
                "example": "102400"
              },
              "X-Target-Met": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: true when the file fits the goal",
                "example": "true"
              },
              "X-Note": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: why the goal was not reached, in plain words"
              },
              "X-Picture-Bytes-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "43966"
              },
              "X-Picture-Bytes-Before": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "422137"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          },
          "503": {
            "description": "Busy: retry after the number of seconds in the Retry-After header"
          }
        }
      }
    },
    "/v1/pptx/split": {
      "post": {
        "summary": "Split a PowerPoint into several presentations",
        "operationId": "pptxSplit",
        "description": "Returns ONE ZIP of .pptx files, each a complete editable deck that keeps its own slides' notes, pictures, charts and tables, named like talk_slide-01.pptx or talk_slides-1-3.pptx. mode: each (one file per slide; the default), every (every N slides, give every) or range (ranges such as 1-3,5,8-: one file per range, or one file with all of them when rangesAsFiles is false). At most 100 files; 25 second time budget. Errors: 400 for a missing option or a slide number that does not exist (the message says how many slides the deck has); 422 when the file is not a readable .pptx or the time budget runs out; 503 when busy. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "mode": {
                    "type": "string",
                    "description": "each, every or range. Default: range when ranges is sent, every when every is sent, else each.",
                    "enum": [
                      "each",
                      "every",
                      "range"
                    ]
                  },
                  "ranges": {
                    "type": "string",
                    "description": "range mode: comma-separated slides or ranges, for example 1-3,5,8- (8- means 8 to the end)",
                    "example": "1-3,5,8-"
                  },
                  "rangesAsFiles": {
                    "type": "boolean",
                    "description": "range mode: true (default) = one file per range; false = one file with all chosen slides."
                  },
                  "every": {
                    "type": "number",
                    "description": "every mode: slides per file, for example 5",
                    "minimum": 1
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "mode": {
                    "type": "string",
                    "description": "each, every or range. Default: range when ranges is sent, every when every is sent, else each.",
                    "enum": [
                      "each",
                      "every",
                      "range"
                    ]
                  },
                  "ranges": {
                    "type": "string",
                    "description": "range mode: comma-separated slides or ranges, for example 1-3,5,8- (8- means 8 to the end)",
                    "example": "1-3,5,8-"
                  },
                  "rangesAsFiles": {
                    "type": "boolean",
                    "description": "range mode: true (default) = one file per range; false = one file with all chosen slides."
                  },
                  "every": {
                    "type": "number",
                    "description": "every mode: slides per file, for example 5",
                    "minimum": 1
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/zip, 617,849 bytes.",
            "content": {
              "application/zip": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides in the deck",
                "example": "6"
              },
              "X-Parts": {
                "schema": {
                  "type": "string"
                },
                "description": "Files in the ZIP",
                "example": "6"
              },
              "X-Files": {
                "schema": {
                  "type": "string"
                },
                "description": "Their names, comma separated",
                "example": "sample_slide-01.pptx,sample_slide-02.pptx,sample_slide-03.pptx,sample_slide-04.pptx,sample_slide-05.pptx,sample_slide-06.pptx"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the ZIP",
                "example": "617849"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          },
          "503": {
            "description": "Busy: retry after the number of seconds in the Retry-After header"
          }
        }
      }
    },
    "/v1/pptx/organize": {
      "post": {
        "summary": "Reorder, delete and duplicate the slides of a PowerPoint",
        "operationId": "pptxOrganize",
        "description": "Returns a new editable .pptx; the slide master, layouts and theme stay as they were and every slide keeps its notes, pictures, charts and tables. All slide numbers are 1-based and refer to the ORIGINAL deck. order is the final sequence, for example 3,1,2 (a number twice makes a copy); remove deletes slides; duplicate puts a copy right after the original; removeHidden deletes every hidden slide. Order is applied first, then remove, then duplicate. 400 when a number does not exist, when every slide would be removed, or when nothing was asked. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "order": {
                    "type": "string",
                    "description": "Final order as slide numbers: a JSON array or comma-separated, for example [3,1,2] or 3,1,2"
                  },
                  "remove": {
                    "type": "string",
                    "description": "Slides to delete, for example [2,4] or 2,4"
                  },
                  "duplicate": {
                    "type": "string",
                    "description": "Slides to copy, for example [1] or 1"
                  },
                  "removeHidden": {
                    "type": "boolean",
                    "description": "Delete every slide that is hidden when presenting."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "order": {
                    "type": "string",
                    "description": "Final order as slide numbers: a JSON array or comma-separated, for example [3,1,2] or 3,1,2"
                  },
                  "remove": {
                    "type": "string",
                    "description": "Slides to delete, for example [2,4] or 2,4"
                  },
                  "duplicate": {
                    "type": "string",
                    "description": "Slides to copy, for example [1] or 1"
                  },
                  "removeHidden": {
                    "type": "boolean",
                    "description": "Delete every slide that is hidden when presenting."
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 33,250 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides-Before": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides before",
                "example": "6"
              },
              "X-Slides-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides after",
                "example": "1"
              },
              "X-Slides-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Original slides left out",
                "example": "5"
              },
              "X-Slides-Copied": {
                "schema": {
                  "type": "string"
                },
                "description": "Extra copies made",
                "example": "0"
              },
              "X-Final-Order": {
                "schema": {
                  "type": "string"
                },
                "description": "The slide numbers of the result, in order",
                "example": "1"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "33250"
              },
              "X-Reordered": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "false"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/merge": {
      "post": {
        "summary": "Merge PowerPoint presentations into one",
        "operationId": "pptxMerge",
        "description": "Joins two to ten presentations in the order sent into one editable .pptx (100 MB in all). Each deck keeps its own master, layouts and theme (several masters in one file), so slides look as they did; useFirstDesign=true puts later decks on the first deck's layouts when the layout names match, and is refused with the reason when they do not. Every deck must have the same slide size: a mismatch returns 422 with a plain message naming the decks and their sizes in inches (and the fields problems and slideSizes), so nothing is stretched. Comments of the second and later decks are left out. Errors: 400 for fewer than two files, more than ten or too much data; 422 for a size mismatch or a file that is not a readable .pptx (the message names it). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "files": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "binary"
                    },
                    "description": "Two to ten presentations (repeat the field). Slides join in the order sent."
                  },
                  "useFirstDesign": {
                    "type": "boolean",
                    "description": "Put every later deck on the first deck's layouts. Default false."
                  }
                },
                "required": [
                  "files"
                ]
              },
              "example": {
                "files": [
                  "a.pptx",
                  "b.pptx"
                ]
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "files": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "description": "File name, used in messages"
                        },
                        "base64": {
                          "type": "string",
                          "description": "The .pptx, base64 encoded"
                        }
                      },
                      "required": [
                        "base64"
                      ]
                    }
                  },
                  "useFirstDesign": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "files"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 926,279 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides in the result",
                "example": "12"
              },
              "X-Decks": {
                "schema": {
                  "type": "string"
                },
                "description": "Presentations merged",
                "example": "2"
              },
              "X-Per-Deck": {
                "schema": {
                  "type": "string"
                },
                "description": "name:slides for each deck",
                "example": "sample.pptx:6,sample.pptx:6"
              },
              "X-Masters": {
                "schema": {
                  "type": "string"
                },
                "description": "Slide masters in the result",
                "example": "2"
              },
              "X-Comments-Left-Out": {
                "schema": {
                  "type": "string"
                },
                "description": "Comments not carried over",
                "example": "0"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "926279"
              },
              "X-Notes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "Each file keeps its own design, so the merged file has 2 slide masters. Slides from different designs will look different.; Notes pages of the later files use the first file's notes master."
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/from-markdown": {
      "post": {
        "summary": "Make a PowerPoint from Markdown",
        "operationId": "pptxFromMarkdown",
        "description": "Turns Markdown (or an indented outline) into an editable .pptx with real title and body placeholders, so Outline view, the slide master and accessibility checks work. # Title makes the title slide (a short line under it is the subtitle), ## Heading a new slide, ### Heading a bold sub-heading, - item or 1. item bullets (indent two spaces for sub-bullets), | a | b | tables, Note: text speaker notes, --- ends a slide; **bold**, *italic*, `code` and [links](https://example.com) work. Pictures given by web address are never fetched (X-Warnings says so); use /v1/pptx/from-json to add pictures. mode outline reads a plain indented outline (first line = deck title). Send JSON {\"markdown\": \"...\"} or multipart with a markdown field or a .md file. 400 for empty text, an unknown theme or a bad brand colour. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "markdown": {
                    "type": "string",
                    "description": "The deck as Markdown (up to 1,000,000 characters). Or send a .md file in the 'file' field."
                  },
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "A Markdown file, instead of markdown. Up to 10 MB."
                  },
                  "mode": {
                    "type": "string",
                    "description": "markdown (default) or outline",
                    "enum": [
                      "markdown",
                      "outline"
                    ]
                  },
                  "theme": {
                    "type": "string",
                    "description": "clean (default), dark, corporate, warm or minimal",
                    "enum": [
                      "clean",
                      "dark",
                      "corporate",
                      "warm",
                      "minimal"
                    ]
                  },
                  "brand": {
                    "type": "string",
                    "description": "JSON object {\"color\":\"#0b6e4f\",\"headingFont\":\"Georgia\",\"bodyFont\":\"Calibri\",\"dark\":false}; replaces theme"
                  }
                },
                "required": []
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "markdown": {
                    "type": "string",
                    "description": "The deck as Markdown"
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "markdown",
                      "outline"
                    ]
                  },
                  "theme": {
                    "type": "string",
                    "enum": [
                      "clean",
                      "dark",
                      "corporate",
                      "warm",
                      "minimal"
                    ]
                  },
                  "brand": {
                    "type": "object",
                    "properties": {
                      "color": {
                        "type": "string",
                        "example": "#0b6e4f"
                      },
                      "headingFont": {
                        "type": "string"
                      },
                      "bodyFont": {
                        "type": "string"
                      },
                      "dark": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "color"
                    ]
                  }
                },
                "required": [
                  "markdown"
                ]
              },
              "example": {
                "markdown": "# Quarterly Review\nQ3 results and next steps\nNote: Welcome everyone.\n\n## What went well\n- Revenue up **12%**\n  - One new customer in healthcare\n- Support response time under 2 hours\n\n## Numbers\n| Metric | Q2 | Q3 |\n| --- | --- | --- |\n| Revenue | $1.2M | $1.34M |\n\n---\n\n## Next steps\n1. Hire a customer success lead\n2. Launch the new pricing page",
                "theme": "clean"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 84,174 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides made",
                "example": "4"
              },
              "X-Theme": {
                "schema": {
                  "type": "string"
                },
                "description": "The theme used",
                "example": "clean"
              },
              "X-Warning-Count": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of warnings",
                "example": "0"
              },
              "X-Warnings": {
                "schema": {
                  "type": "string"
                },
                "description": "Warnings joined with ' | ' (pictures not added, slides with too much text)"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "84174"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/from-json": {
      "post": {
        "summary": "Make a PowerPoint from JSON slides",
        "operationId": "pptxFromJson",
        "description": "Builds an editable .pptx from a JSON description of the slides: the strongest way for software and AI agents to produce a real deck. Body: {\"title\"?, \"theme\"?, \"brand\"?, \"slides\": [...]}. Each slide: title (text), subtitle, layout (\"title\" = cover, \"content\"), bullets (strings, or {\"text\", \"bullets\": [...]} for sub-bullets, five levels), numbered (true for 1. 2. 3.), text (a paragraph or a list of paragraphs, shown above the bullets), table ({\"header\": [...], \"rows\": [[...]]} or just rows; cells text, number, boolean or null), image ({\"data\": base64 or data: URI of a PNG, JPEG or GIF, \"alt\": \"what it shows\"}) and notes (speaker notes). A slide with only a title (and subtitle) is a cover when it is first or has a subtitle. With an image the text and table sit on the left and the picture on the right, keeping its shape; an image alone is centred. bullets, text and subtitle accept **bold**, *italic*, `code` and [links](https://example.com); titles and table cells are plain text. Pictures are never fetched from a web address: send base64, with alt text (X-Warnings reminds you when it is missing, and when a slide has no title or a table is too long for one slide). Limits: 200 slides, 40 bullets and 5000 characters per text, tables up to 60 rows and 12 columns (comfortable up to 14 rows), pictures 8 MB each and 24 MB in all. Themes: clean, dark, corporate, warm, minimal, or brand {\"color\": \"#0b6e4f\", \"headingFont\": \"Georgia\", \"bodyFont\": \"Calibri\", \"dark\": false}. Errors are 400 and name the field, for example \"slides[2].bullets[1] must be text or an object like {\"text\": \"...\", \"bullets\": [...]}.\" or \"slides[0] has an unknown field \"bulets\". Allowed fields: ...\". The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "description": "Deck title (the file's title property). Default: the first slide's title."
                  },
                  "theme": {
                    "type": "string",
                    "enum": [
                      "clean",
                      "dark",
                      "corporate",
                      "warm",
                      "minimal"
                    ],
                    "description": "Default clean. Ignored when brand is given."
                  },
                  "brand": {
                    "type": "object",
                    "description": "A theme made from a brand colour and fonts",
                    "properties": {
                      "color": {
                        "type": "string",
                        "example": "#0b6e4f"
                      },
                      "headingFont": {
                        "type": "string",
                        "example": "Georgia"
                      },
                      "bodyFont": {
                        "type": "string",
                        "example": "Calibri"
                      },
                      "dark": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "color"
                    ]
                  },
                  "slides": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 200,
                    "items": {
                      "type": "object",
                      "description": "One slide. Unknown fields are rejected.",
                      "properties": {
                        "title": {
                          "type": "string"
                        },
                        "subtitle": {
                          "type": "string"
                        },
                        "layout": {
                          "type": "string",
                          "enum": [
                            "title",
                            "content"
                          ]
                        },
                        "bullets": {
                          "type": "array",
                          "description": "Strings, or {text, bullets: [...]} objects for sub-bullets",
                          "items": {
                            "oneOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string"
                                  },
                                  "bullets": {
                                    "type": "array",
                                    "items": {}
                                  }
                                },
                                "required": [
                                  "text"
                                ]
                              }
                            ]
                          }
                        },
                        "numbered": {
                          "type": "boolean"
                        },
                        "text": {
                          "oneOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            }
                          ]
                        },
                        "table": {
                          "type": "object",
                          "properties": {
                            "header": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "rows": {
                              "type": "array",
                              "items": {
                                "type": "array",
                                "items": {
                                  "oneOf": [
                                    {
                                      "type": "string"
                                    },
                                    {
                                      "type": "number"
                                    },
                                    {
                                      "type": "boolean"
                                    }
                                  ]
                                }
                              }
                            }
                          },
                          "required": [
                            "rows"
                          ]
                        },
                        "image": {
                          "type": "object",
                          "properties": {
                            "data": {
                              "type": "string",
                              "description": "Base64 or data: URI of a PNG, JPEG or GIF"
                            },
                            "alt": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "data"
                          ]
                        },
                        "notes": {
                          "type": "string",
                          "description": "Speaker notes"
                        }
                      }
                    }
                  }
                },
                "required": [
                  "slides"
                ]
              },
              "example": {
                "title": "Q3 Review",
                "theme": "corporate",
                "slides": [
                  {
                    "title": "Q3 Review",
                    "subtitle": "Revenue and next steps"
                  },
                  {
                    "title": "Highlights",
                    "bullets": [
                      "Revenue up **12%** on last quarter",
                      {
                        "text": "Two new customers",
                        "bullets": [
                          "Healthcare",
                          "Logistics"
                        ]
                      },
                      "Support response time under 2 hours"
                    ],
                    "notes": "Mention the healthcare win by name."
                  },
                  {
                    "title": "Plan",
                    "numbered": true,
                    "bullets": [
                      "Hire a customer success lead",
                      "Launch the new pricing page",
                      "Review the plan in [our planning doc](https://example.com/plan)"
                    ]
                  },
                  {
                    "title": "Numbers at a glance",
                    "table": {
                      "header": [
                        "Metric",
                        "Q2",
                        "Q3"
                      ],
                      "rows": [
                        [
                          "Revenue",
                          "$1.2M",
                          "$1.34M"
                        ],
                        [
                          "New customers",
                          5,
                          7
                        ],
                        [
                          "Support tickets",
                          410,
                          380
                        ]
                      ]
                    }
                  },
                  {
                    "title": "The dashboard",
                    "text": "Live numbers for every team.",
                    "bullets": [
                      "Updated hourly",
                      "Exports to CSV"
                    ],
                    "image": {
                      "data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
                      "alt": "Screenshot of the dashboard"
                    }
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 104,513 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides made",
                "example": "5"
              },
              "X-Theme": {
                "schema": {
                  "type": "string"
                },
                "description": "The theme used",
                "example": "corporate"
              },
              "X-Warning-Count": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of warnings",
                "example": "0"
              },
              "X-Warnings": {
                "schema": {
                  "type": "string"
                },
                "description": "Warnings joined with ' | '"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "104513"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/from-csv": {
      "post": {
        "summary": "Make a PowerPoint from a CSV file",
        "operationId": "pptxFromCsv",
        "description": "Turns a CSV file into table slides: a cover with the title and the size of the table, then the header and up to rowsPerSlide rows (default 12, max 40) on each slide, titled \"Title (1 of 3)\", with the row range in the speaker notes. The first row holds the column names unless header is false. The delimiter (comma, semicolon or tab) is found from the first line unless you send delimiter. Cells are kept as plain text. At most 12 columns and 200 slides. Send JSON {\"csv\": \"...\"} or multipart with a CSV file (10 MB). 400 for an empty CSV, too many columns or rows, or a bad option. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The CSV file (or send the text in the csv field). Up to 10 MB."
                  },
                  "csv": {
                    "type": "string",
                    "description": "The CSV text, instead of a file"
                  },
                  "title": {
                    "type": "string",
                    "description": "Deck and slide title. Default Data."
                  },
                  "rowsPerSlide": {
                    "type": "number",
                    "description": "Data rows per slide, 1 to 40. Default 12.",
                    "minimum": 1,
                    "maximum": 40
                  },
                  "header": {
                    "type": "boolean",
                    "description": "The first row holds column names. Default true."
                  },
                  "titleSlide": {
                    "type": "boolean",
                    "description": "Add a cover slide. Default true."
                  },
                  "delimiter": {
                    "type": "string",
                    "description": "One character, or tab. Default: detected."
                  },
                  "theme": {
                    "type": "string",
                    "description": "clean (default), dark, corporate, warm or minimal",
                    "enum": [
                      "clean",
                      "dark",
                      "corporate",
                      "warm",
                      "minimal"
                    ]
                  },
                  "brand": {
                    "type": "string",
                    "description": "JSON object {\"color\":\"#0b6e4f\"}; replaces theme"
                  }
                },
                "required": []
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "csv": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "rowsPerSlide": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 40
                  },
                  "header": {
                    "type": "boolean"
                  },
                  "titleSlide": {
                    "type": "boolean"
                  },
                  "delimiter": {
                    "type": "string"
                  },
                  "theme": {
                    "type": "string",
                    "enum": [
                      "clean",
                      "dark",
                      "corporate",
                      "warm",
                      "minimal"
                    ]
                  },
                  "brand": {
                    "type": "object",
                    "properties": {
                      "color": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "color"
                    ]
                  }
                },
                "required": [
                  "csv"
                ]
              },
              "example": {
                "csv": "Region,Q2,Q3\nNorth,120,135\nSouth,98,101\nEast,143,160\nWest,87,92",
                "title": "Sales by region",
                "rowsPerSlide": 12,
                "theme": "corporate"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 83,777 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides made",
                "example": "2"
              },
              "X-Rows": {
                "schema": {
                  "type": "string"
                },
                "description": "Data rows",
                "example": "4"
              },
              "X-Delimiter": {
                "schema": {
                  "type": "string"
                },
                "description": "The delimiter used",
                "example": ","
              },
              "X-Theme": {
                "schema": {
                  "type": "string"
                },
                "description": "The theme used",
                "example": "corporate"
              },
              "X-Warnings": {
                "schema": {
                  "type": "string"
                },
                "description": "Warnings joined with ' | '"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "83777"
              },
              "X-Warning-Count": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "0"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/find-replace": {
      "post": {
        "summary": "Find and replace text in a PowerPoint",
        "operationId": "pptxFindReplace",
        "description": "Replaces text on every slide of a .pptx and returns the edited deck. A match is found even when PowerPoint split the words into several runs; the formatting of the first run is kept. Speaker notes are searched too (includeNotes, default true); the slide master and layouts only when includeTemplate is true. Slides in skipSlides are left alone. 422 when nothing matches, so a misspelling is noticed. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "find": {
                    "type": "string",
                    "description": "The text to look for (up to 500 characters)",
                    "example": "Acme Ltd"
                  },
                  "replace": {
                    "type": "string",
                    "description": "The new text (up to 5000 characters). Empty removes the match.",
                    "example": "Globex Inc"
                  },
                  "matchCase": {
                    "type": "boolean",
                    "description": "Match upper and lower case exactly. Default false."
                  },
                  "wholeWord": {
                    "type": "boolean",
                    "description": "Match whole words only. Default false."
                  },
                  "includeNotes": {
                    "type": "boolean",
                    "description": "Also change speaker notes. Default true."
                  },
                  "includeTemplate": {
                    "type": "boolean",
                    "description": "Also change the slide master and layouts. Default false."
                  },
                  "skipSlides": {
                    "type": "string",
                    "description": "Slides to leave alone, for example [2,4] or 2,4"
                  }
                },
                "required": [
                  "file",
                  "find"
                ]
              },
              "example": {
                "file": "sample.pptx",
                "find": "Acme Ltd"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "find": {
                    "type": "string",
                    "description": "The text to look for (up to 500 characters)",
                    "example": "Acme Ltd"
                  },
                  "replace": {
                    "type": "string",
                    "description": "The new text (up to 5000 characters). Empty removes the match.",
                    "example": "Globex Inc"
                  },
                  "matchCase": {
                    "type": "boolean",
                    "description": "Match upper and lower case exactly. Default false."
                  },
                  "wholeWord": {
                    "type": "boolean",
                    "description": "Match whole words only. Default false."
                  },
                  "includeNotes": {
                    "type": "boolean",
                    "description": "Also change speaker notes. Default true."
                  },
                  "includeTemplate": {
                    "type": "boolean",
                    "description": "Also change the slide master and layouts. Default false."
                  },
                  "skipSlides": {
                    "type": "string",
                    "description": "Slides to leave alone, for example [2,4] or 2,4"
                  }
                },
                "required": [
                  "fileBase64",
                  "find"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 467,932 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Replaced": {
                "schema": {
                  "type": "string"
                },
                "description": "Matches replaced",
                "example": "7"
              },
              "X-Slides-With-Matches": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides that held a match",
                "example": "6"
              },
              "X-Matches-On-Master-And-Layouts": {
                "schema": {
                  "type": "string"
                },
                "description": "Matches found on the master and layouts",
                "example": "0"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file you sent",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "467932"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/fonts": {
      "post": {
        "summary": "List the fonts a PowerPoint uses",
        "operationId": "pptxFonts",
        "description": "Returns JSON {\"fonts\": [...]}: each font's name, how many places use it, the slides that use it, whether the master, layouts or theme use it, whether it is the theme's heading or body font, and whether a copy is embedded. Use it before /v1/pptx/replace-fonts. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "fonts": [
                    {
                      "name": "Calibri",
                      "count": 4,
                      "slides": [],
                      "inTemplate": true,
                      "kinds": [
                        "latin"
                      ],
                      "embedded": false,
                      "themeRole": "headings"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/replace-fonts": {
      "post": {
        "summary": "Replace fonts in a PowerPoint",
        "operationId": "pptxReplaceFonts",
        "description": "Swaps fonts everywhere they are named: slides, notes, layouts, masters, the theme's heading and body fonts, charts and SmartArt. mapping is a JSON object {\"Old font\": \"New font\"}. Embedded copies of replaced fonts are removed. Text is not resized, so a wider font can make a line wrap. 422 when none of the named fonts is used. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "mapping": {
                    "type": "string",
                    "description": "JSON object mapping old font names to new ones",
                    "example": "{\"Calibri\":\"Arial\"}"
                  }
                },
                "required": [
                  "file",
                  "mapping"
                ]
              },
              "example": {
                "file": "sample.pptx",
                "mapping": "{\"Calibri\":\"Arial\"}"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "mapping": {
                    "type": "string",
                    "description": "JSON object mapping old font names to new ones",
                    "example": "{\"Calibri\":\"Arial\"}"
                  }
                },
                "required": [
                  "fileBase64",
                  "mapping"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 467,815 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Places-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "Places changed",
                "example": "4"
              },
              "X-Fonts-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "Fonts swapped",
                "example": "1"
              },
              "X-Embedded-Fonts-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Embedded fonts removed",
                "example": "0"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "467815"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/slide-numbers": {
      "post": {
        "summary": "Add or remove slide numbers in a PowerPoint",
        "operationId": "pptxSlideNumbers",
        "description": "Adds a real slide-number field to every slide (so the number follows when slides move), or removes the numbers the slides themselves carry (mode remove). Slides that already have a number are left alone. The total in format of-total is plain text. 422 when every slide already has a number, or when there is nothing to remove. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "mode": {
                    "type": "string",
                    "description": "add (default) or remove",
                    "enum": [
                      "add",
                      "remove"
                    ]
                  },
                  "position": {
                    "type": "string",
                    "description": "bottom-right (default), bottom-center, bottom-left or top-right",
                    "enum": [
                      "bottom-right",
                      "bottom-center",
                      "bottom-left",
                      "top-right"
                    ]
                  },
                  "format": {
                    "type": "string",
                    "description": "number (3), slide-number (Slide 3) or of-total (3 / 12). Default number.",
                    "enum": [
                      "number",
                      "slide-number",
                      "of-total"
                    ]
                  },
                  "startAt": {
                    "type": "number",
                    "description": "Number of the first slide, 0 to 9999. Default 1; 0 makes the second slide 1.",
                    "minimum": 0,
                    "maximum": 9999
                  },
                  "skipFirst": {
                    "type": "boolean",
                    "description": "Leave the first slide without a number."
                  },
                  "size": {
                    "type": "number",
                    "description": "Points, 8 to 40. Default 12.",
                    "minimum": 8,
                    "maximum": 40
                  },
                  "color": {
                    "type": "string",
                    "description": "Hex colour such as 595959"
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "mode": {
                    "type": "string",
                    "description": "add (default) or remove",
                    "enum": [
                      "add",
                      "remove"
                    ]
                  },
                  "position": {
                    "type": "string",
                    "description": "bottom-right (default), bottom-center, bottom-left or top-right",
                    "enum": [
                      "bottom-right",
                      "bottom-center",
                      "bottom-left",
                      "top-right"
                    ]
                  },
                  "format": {
                    "type": "string",
                    "description": "number (3), slide-number (Slide 3) or of-total (3 / 12). Default number.",
                    "enum": [
                      "number",
                      "slide-number",
                      "of-total"
                    ]
                  },
                  "startAt": {
                    "type": "number",
                    "description": "Number of the first slide, 0 to 9999. Default 1; 0 makes the second slide 1.",
                    "minimum": 0,
                    "maximum": 9999
                  },
                  "skipFirst": {
                    "type": "boolean",
                    "description": "Leave the first slide without a number."
                  },
                  "size": {
                    "type": "number",
                    "description": "Points, 8 to 40. Default 12.",
                    "minimum": 8,
                    "maximum": 40
                  },
                  "color": {
                    "type": "string",
                    "description": "Hex colour such as 595959"
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 469,102 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Added": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides numbered",
                "example": "6"
              },
              "X-Already-Numbered": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides that already had a number",
                "example": "0"
              },
              "X-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Numbers removed (remove mode)"
              },
              "X-First-Number": {
                "schema": {
                  "type": "string"
                },
                "description": "The first number shown",
                "example": "1"
              },
              "X-Last-Number": {
                "schema": {
                  "type": "string"
                },
                "description": "The last number shown",
                "example": "6"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "469102"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              },
              "X-Skipped-First": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "false"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/watermark": {
      "post": {
        "summary": "Add or remove a watermark in a PowerPoint",
        "operationId": "pptxWatermark",
        "description": "Stamps a text watermark (such as DRAFT or CONFIDENTIAL) or a PNG/JPEG picture on the slides, behind the content by default, or removes the watermarks this endpoint made (mode remove). Send text, or a picture (multipart file field 'picture', or JSON pictureBase64). 422 when there is no watermark to remove. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "mode": {
                    "type": "string",
                    "description": "add (default) or remove",
                    "enum": [
                      "add",
                      "remove"
                    ]
                  },
                  "text": {
                    "type": "string",
                    "description": "The watermark words (up to 80 characters)",
                    "example": "DRAFT"
                  },
                  "picture": {
                    "type": "string",
                    "format": "binary",
                    "description": "A PNG or JPEG, instead of text. Up to 10 MB."
                  },
                  "pictureBase64": {
                    "type": "string",
                    "description": "A PNG or JPEG as base64, instead of text (JSON requests)"
                  },
                  "color": {
                    "type": "string",
                    "description": "Text colour, hex. Default 808080."
                  },
                  "opacity": {
                    "type": "number",
                    "description": "Percent opaque, 5 to 100. Default 30.",
                    "minimum": 5,
                    "maximum": 100
                  },
                  "size": {
                    "type": "string",
                    "description": "Points (8 to 400) or auto. Default auto."
                  },
                  "rotation": {
                    "type": "number",
                    "description": "Degrees, -90 to 90; negative rises to the right. Default -45 for text, 0 for a picture.",
                    "minimum": -90,
                    "maximum": 90
                  },
                  "font": {
                    "type": "string",
                    "description": "Default Arial"
                  },
                  "bold": {
                    "type": "boolean",
                    "description": "Default true"
                  },
                  "widthPercent": {
                    "type": "number",
                    "description": "Picture width as a percent of the slide, 5 to 100. Default 50.",
                    "minimum": 5,
                    "maximum": 100
                  },
                  "place": {
                    "type": "string",
                    "description": "center (default), top, bottom, top-left, top-right, bottom-left or bottom-right",
                    "enum": [
                      "center",
                      "top",
                      "bottom",
                      "top-left",
                      "top-right",
                      "bottom-left",
                      "bottom-right"
                    ]
                  },
                  "layer": {
                    "type": "string",
                    "description": "behind (default) or front",
                    "enum": [
                      "behind",
                      "front"
                    ]
                  },
                  "slides": {
                    "type": "string",
                    "description": "Slides to mark, for example [1,3] or 1,3. Default all."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx",
                "picture": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "mode": {
                    "type": "string",
                    "description": "add (default) or remove",
                    "enum": [
                      "add",
                      "remove"
                    ]
                  },
                  "text": {
                    "type": "string",
                    "description": "The watermark words (up to 80 characters)",
                    "example": "DRAFT"
                  },
                  "picture": {
                    "type": "string",
                    "format": "binary",
                    "description": "A PNG or JPEG, instead of text. Up to 10 MB."
                  },
                  "pictureBase64": {
                    "type": "string",
                    "description": "A PNG or JPEG as base64, instead of text (JSON requests)"
                  },
                  "color": {
                    "type": "string",
                    "description": "Text colour, hex. Default 808080."
                  },
                  "opacity": {
                    "type": "number",
                    "description": "Percent opaque, 5 to 100. Default 30.",
                    "minimum": 5,
                    "maximum": 100
                  },
                  "size": {
                    "type": "string",
                    "description": "Points (8 to 400) or auto. Default auto."
                  },
                  "rotation": {
                    "type": "number",
                    "description": "Degrees, -90 to 90; negative rises to the right. Default -45 for text, 0 for a picture.",
                    "minimum": -90,
                    "maximum": 90
                  },
                  "font": {
                    "type": "string",
                    "description": "Default Arial"
                  },
                  "bold": {
                    "type": "boolean",
                    "description": "Default true"
                  },
                  "widthPercent": {
                    "type": "number",
                    "description": "Picture width as a percent of the slide, 5 to 100. Default 50.",
                    "minimum": 5,
                    "maximum": 100
                  },
                  "place": {
                    "type": "string",
                    "description": "center (default), top, bottom, top-left, top-right, bottom-left or bottom-right",
                    "enum": [
                      "center",
                      "top",
                      "bottom",
                      "top-left",
                      "top-right",
                      "bottom-left",
                      "bottom-right"
                    ]
                  },
                  "layer": {
                    "type": "string",
                    "description": "behind (default) or front",
                    "enum": [
                      "behind",
                      "front"
                    ]
                  },
                  "slides": {
                    "type": "string",
                    "description": "Slides to mark, for example [1,3] or 1,3. Default all."
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 470,048 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Marked": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides marked",
                "example": "6"
              },
              "X-Already-Marked": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides that already had one of these watermarks",
                "example": "0"
              },
              "X-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Watermarks removed (remove mode)"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "470048"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/resize": {
      "post": {
        "summary": "Change the slide size of a PowerPoint",
        "operationId": "pptxResize",
        "description": "Resizes the slides and scales shapes, pictures, tables and (unless scaleText is false) text, lines and spacing to match. Send preset (16x9, 4x3, 16x10, a4, letter) or width and height with a unit. mode fit (default) keeps the content's shape and centres it, fill covers the new area, stretch changes the shape. X-Shapes-Outside-Slide counts shapes that now reach outside the slide. 422 when the slides are already that size. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "preset": {
                    "type": "string",
                    "description": "16x9, 4x3, 16x10, a4 or letter (landscape)",
                    "enum": [
                      "16x9",
                      "4x3",
                      "16x10",
                      "a4",
                      "letter"
                    ]
                  },
                  "width": {
                    "type": "number",
                    "description": "Custom width, with height"
                  },
                  "height": {
                    "type": "number",
                    "description": "Custom height, with width"
                  },
                  "unit": {
                    "type": "string",
                    "description": "in (default), cm, mm or px",
                    "enum": [
                      "in",
                      "cm",
                      "mm",
                      "px"
                    ]
                  },
                  "mode": {
                    "type": "string",
                    "description": "fit (default), fill or stretch",
                    "enum": [
                      "fit",
                      "fill",
                      "stretch"
                    ]
                  },
                  "scaleText": {
                    "type": "boolean",
                    "description": "Scale text, lines and spacing too. Default true."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "preset": {
                    "type": "string",
                    "description": "16x9, 4x3, 16x10, a4 or letter (landscape)",
                    "enum": [
                      "16x9",
                      "4x3",
                      "16x10",
                      "a4",
                      "letter"
                    ]
                  },
                  "width": {
                    "type": "number",
                    "description": "Custom width, with height"
                  },
                  "height": {
                    "type": "number",
                    "description": "Custom height, with width"
                  },
                  "unit": {
                    "type": "string",
                    "description": "in (default), cm, mm or px",
                    "enum": [
                      "in",
                      "cm",
                      "mm",
                      "px"
                    ]
                  },
                  "mode": {
                    "type": "string",
                    "description": "fit (default), fill or stretch",
                    "enum": [
                      "fit",
                      "fill",
                      "stretch"
                    ]
                  },
                  "scaleText": {
                    "type": "boolean",
                    "description": "Scale text, lines and spacing too. Default true."
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 468,041 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-From": {
                "schema": {
                  "type": "string"
                },
                "description": "The old size",
                "example": "10 x 7.5 in (4:3)"
              },
              "X-To": {
                "schema": {
                  "type": "string"
                },
                "description": "The new size",
                "example": "13.33 x 7.5 in (16:9)"
              },
              "X-Slides": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides in the deck",
                "example": "6"
              },
              "X-Shapes-Scaled": {
                "schema": {
                  "type": "string"
                },
                "description": "Shapes scaled",
                "example": "3"
              },
              "X-Shapes-Outside-Slide": {
                "schema": {
                  "type": "string"
                },
                "description": "Shapes now partly or wholly outside the slide",
                "example": "0"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "468041"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              },
              "X-Text-Factor": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "1"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/extract/charts": {
      "post": {
        "summary": "Get the data behind the charts of a PowerPoint",
        "operationId": "pptxExtractCharts",
        "description": "Returns the numbers of every chart in the deck: format xlsx (default; one workbook with a sheet per chart), csv (a ZIP of CSV files; workbooks=true also adds each chart's own embedded workbook) or json (each chart's slide, title, type and table). Charts pasted as pictures have no data. 422 when the deck has no real charts. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "format": {
                    "type": "string",
                    "description": "xlsx (default), csv or json",
                    "enum": [
                      "xlsx",
                      "csv",
                      "json"
                    ]
                  },
                  "workbooks": {
                    "type": "boolean",
                    "description": "csv: also include the embedded workbooks. Default false."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "format": {
                    "type": "string",
                    "description": "xlsx (default), csv or json",
                    "enum": [
                      "xlsx",
                      "csv",
                      "json"
                    ]
                  },
                  "workbooks": {
                    "type": "boolean",
                    "description": "csv: also include the embedded workbooks. Default false."
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, 16,016 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/zip or application/json": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Charts": {
                "schema": {
                  "type": "string"
                },
                "description": "Charts found",
                "example": "1"
              },
              "X-Notes": {
                "schema": {
                  "type": "string"
                },
                "description": "Notes about charts with no cached values or a linked workbook",
                "example": "0"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/accessibility-check": {
      "post": {
        "summary": "Check a PowerPoint for accessibility problems",
        "operationId": "pptxAccessibilityCheck",
        "description": "Returns a JSON report (or CSV with format csv): pictures and charts without alt text or with a file name as alt text, slides with no title or an empty or duplicate title, text under 12 points, table header rows, merged cells, vague link text and reading-order problems. Each issue has its slide, a severity (error, warning, tip) and a plain message. The check reports only and changes nothing. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "format": {
                    "type": "string",
                    "description": "json (default) or csv",
                    "enum": [
                      "json",
                      "csv"
                    ]
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "format": {
                    "type": "string",
                    "description": "json (default) or csv",
                    "enum": [
                      "json",
                      "csv"
                    ]
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file.",
            "content": {
              "application/json or text/csv": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "issues": [
                    {
                      "kind": "missing-alt",
                      "severity": "error",
                      "slide": 6,
                      "message": "Slide 6: chart \"Chart 2\" has no alt text.",
                      "shapeId": "3",
                      "shapeName": "Chart 2",
                      "objectType": "chart",
                      "fix": "alt",
                      "id": "i2"
                    },
                    {
                      "kind": "alt-filename",
                      "severity": "warning",
                      "slide": 5,
                      "message": "Slide 5: the alt text of picture \"Picture 2\" is \"image.jpg\", which looks like a file name, not a description.",
                      "shapeId": "3",
                      "shapeName": "Picture 2",
                      "objectType": "picture",
                      "fix": "alt",
                      "id": "i1"
                    }
                  ],
                  "slides": [
                    {
                      "number": 1,
                      "title": "Python slide 1",
                      "hidden": false
                    },
                    {
                      "number": 2,
                      "title": "Python slide 2",
                      "hidden": false
                    },
                    {
                      "number": 3,
                      "title": "Python slide 3",
                      "hidden": false
                    },
                    "..."
                  ],
                  "counts": {
                    "error": 1,
                    "warning": 1,
                    "tip": 0
                  },
                  "okVisuals": 0,
                  "totalVisuals": 2,
                  "documentTitle": "Python made deck"
                }
              }
            },
            "headers": {
              "X-Errors": {
                "schema": {
                  "type": "string"
                },
                "description": "Errors found"
              },
              "X-Warnings": {
                "schema": {
                  "type": "string"
                },
                "description": "Warnings found"
              },
              "X-Tips": {
                "schema": {
                  "type": "string"
                },
                "description": "Tips"
              },
              "X-Visuals-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures and other visuals"
              },
              "X-Visuals-Ok": {
                "schema": {
                  "type": "string"
                },
                "description": "Visuals with alt text or marked decorative"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/repair": {
      "post": {
        "summary": "Repair a damaged PowerPoint",
        "operationId": "pptxRepair",
        "description": "Tries to mend a .pptx that PowerPoint says needs repair or will not open, and returns a new .pptx. It rebuilds a missing or wrong file list, a missing or inconsistent slide list, dead links to pictures, charts and layouts, duplicate slide ids and a damaged zip index; what cannot be saved is dropped and listed (X-Lost-Summary). A healthy file is returned unchanged with X-Changed: false. Old .ppt files and password-protected files cannot be repaired (422). 400 for a missing file; 422 with a plain message when the file is not a zip at all. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The damaged .pptx. Up to 50 MB."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 467,497 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "true when something was mended",
                "example": "false"
              },
              "X-Zip-Rescued": {
                "schema": {
                  "type": "string"
                },
                "description": "true when the zip index was damaged and the parts were read one by one",
                "example": "false"
              },
              "X-Slides": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides in the result",
                "example": "6"
              },
              "X-Fixed": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of fixes",
                "example": "0"
              },
              "X-Lost": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of pieces that could not be kept",
                "example": "0"
              },
              "X-Fixed-Summary": {
                "schema": {
                  "type": "string"
                },
                "description": "The first fixes, in plain words"
              },
              "X-Lost-Summary": {
                "schema": {
                  "type": "string"
                },
                "description": "The first losses, in plain words"
              },
              "X-Problems-Left": {
                "schema": {
                  "type": "string"
                },
                "description": "Problems the repaired file still has, if any"
              },
              "X-Note": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "Nothing was wrong that this tool can see, so the file is returned unchanged."
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/redact": {
      "post": {
        "summary": "Redact text and pictures in a PowerPoint",
        "operationId": "pptxRedact",
        "description": "Blacks out sensitive text and returns the redacted .pptx. Matches are replaced by block characters in the file's own text (not covered by a shape), on slides, notes, the master and layouts, charts, SmartArt, comments, alt text and link targets. presets: email, phone, ssn, card, url, ip, money, date. terms are exact words, regexes are JavaScript regular expressions. imageSlides ('all' or slide numbers) replaces pictures with a black stand-in of the same size; imageByAlt does so for pictures whose name or alt text matches. stripNotes, stripComments and stripMetadata remove those entirely. The result is read again; X-Remaining counts matches still in the file. Text inside pictures, video and audio cannot be found (X-Warnings). A deck with no match is returned unchanged with X-Changed: false. 400 when nothing to redact is asked for or a pattern is invalid. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "presets": {
                    "type": "string",
                    "description": "Kinds of text to remove: a JSON array or comma-separated, from email, phone, ssn, card, url, ip, money, date",
                    "example": "email,phone"
                  },
                  "terms": {
                    "type": "string",
                    "description": "Exact words or phrases: a JSON array or one per line"
                  },
                  "regexes": {
                    "type": "string",
                    "description": "Regular expressions: a JSON array or one per line"
                  },
                  "matchCase": {
                    "type": "boolean",
                    "description": "Default false"
                  },
                  "notes": {
                    "type": "boolean",
                    "description": "Search speaker notes. Default true."
                  },
                  "template": {
                    "type": "boolean",
                    "description": "Search the master and layouts. Default true."
                  },
                  "imageSlides": {
                    "type": "string",
                    "description": "all, or slide numbers whose pictures are blacked out, for example [2,5] or 2,5"
                  },
                  "imageByAlt": {
                    "type": "boolean",
                    "description": "Black out pictures whose name or alt text matches"
                  },
                  "stripNotes": {
                    "type": "boolean",
                    "description": "Remove all speaker notes"
                  },
                  "stripComments": {
                    "type": "boolean",
                    "description": "Remove all comments"
                  },
                  "stripMetadata": {
                    "type": "boolean",
                    "description": "Remove author and file details"
                  },
                  "dropChartWorkbooks": {
                    "type": "boolean",
                    "description": "Remove a chart's embedded workbook when it still holds a match. Default true."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "presets": {
                    "type": "string",
                    "description": "Kinds of text to remove: a JSON array or comma-separated, from email, phone, ssn, card, url, ip, money, date",
                    "example": "email,phone"
                  },
                  "terms": {
                    "type": "string",
                    "description": "Exact words or phrases: a JSON array or one per line"
                  },
                  "regexes": {
                    "type": "string",
                    "description": "Regular expressions: a JSON array or one per line"
                  },
                  "matchCase": {
                    "type": "boolean",
                    "description": "Default false"
                  },
                  "notes": {
                    "type": "boolean",
                    "description": "Search speaker notes. Default true."
                  },
                  "template": {
                    "type": "boolean",
                    "description": "Search the master and layouts. Default true."
                  },
                  "imageSlides": {
                    "type": "string",
                    "description": "all, or slide numbers whose pictures are blacked out, for example [2,5] or 2,5"
                  },
                  "imageByAlt": {
                    "type": "boolean",
                    "description": "Black out pictures whose name or alt text matches"
                  },
                  "stripNotes": {
                    "type": "boolean",
                    "description": "Remove all speaker notes"
                  },
                  "stripComments": {
                    "type": "boolean",
                    "description": "Remove all comments"
                  },
                  "stripMetadata": {
                    "type": "boolean",
                    "description": "Remove author and file details"
                  },
                  "dropChartWorkbooks": {
                    "type": "boolean",
                    "description": "Remove a chart's embedded workbook when it still holds a match. Default true."
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 467,497 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Text-Matches": {
                "schema": {
                  "type": "string"
                },
                "description": "Pieces of text blacked out",
                "example": "0"
              },
              "X-Matches-In-Notes": {
                "schema": {
                  "type": "string"
                },
                "description": "Of them, in speaker notes",
                "example": "0"
              },
              "X-Matches-In-Template": {
                "schema": {
                  "type": "string"
                },
                "description": "Of them, on the master or layouts",
                "example": "0"
              },
              "X-Matches-Elsewhere": {
                "schema": {
                  "type": "string"
                },
                "description": "Of them, in charts, SmartArt or comments",
                "example": "0"
              },
              "X-Pictures-Blacked": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures replaced",
                "example": "0"
              },
              "X-Alt-Text-Cleared": {
                "schema": {
                  "type": "string"
                },
                "description": "Alt texts cleared",
                "example": "0"
              },
              "X-Remaining": {
                "schema": {
                  "type": "string"
                },
                "description": "Matches still in the file after redaction (should be 0)",
                "example": "0"
              },
              "X-Remaining-Where": {
                "schema": {
                  "type": "string"
                },
                "description": "Where they are"
              },
              "X-Warnings": {
                "schema": {
                  "type": "string"
                },
                "description": "What this tool could not check, joined with ' | '"
              },
              "X-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "false when nothing matched",
                "example": "false"
              },
              "X-Chart-Workbooks-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "0"
              },
              "X-Hyperlinks-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "0"
              },
              "X-Note": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "Nothing matched, so the file is returned unchanged."
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/html-slideshow": {
      "post": {
        "summary": "Turn a PowerPoint into one HTML slideshow",
        "operationId": "pptxHtmlSlideshow",
        "description": "Returns ONE self-contained HTML file: each slide as readable text with its pictures inlined, arrow-key navigation, a grid (G) and optional speaker notes (N). No external files or scripts. Charts, SmartArt, video, audio and animation are not carried over (X-Not-Carried lists them). Notes are included only when includeNotes is true; hidden slides only when includeHidden is true. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "title": {
                    "type": "string",
                    "description": "Page title (up to 120 characters). Default: the deck's title."
                  },
                  "includeNotes": {
                    "type": "boolean",
                    "description": "Include speaker notes. Default false."
                  },
                  "includeHidden": {
                    "type": "boolean",
                    "description": "Include hidden slides. Default false."
                  },
                  "look": {
                    "type": "string",
                    "description": "deck (default, the deck's colours), light or dark",
                    "enum": [
                      "deck",
                      "light",
                      "dark"
                    ]
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "title": {
                    "type": "string",
                    "description": "Page title (up to 120 characters). Default: the deck's title."
                  },
                  "includeNotes": {
                    "type": "boolean",
                    "description": "Include speaker notes. Default false."
                  },
                  "includeHidden": {
                    "type": "boolean",
                    "description": "Include hidden slides. Default false."
                  },
                  "look": {
                    "type": "string",
                    "description": "deck (default, the deck's colours), light or dark",
                    "enum": [
                      "deck",
                      "light",
                      "dark"
                    ]
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, text/html, 574,385 bytes.",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides in the page",
                "example": "5"
              },
              "X-Pictures": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures inlined",
                "example": "1"
              },
              "X-Pictures-Left-Out": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures left out to keep the file a sensible size",
                "example": "0"
              },
              "X-Hidden-Slides-Left-Out": {
                "schema": {
                  "type": "string"
                },
                "description": "Hidden slides left out",
                "example": "1"
              },
              "X-Not-Carried": {
                "schema": {
                  "type": "string"
                },
                "description": "What was not carried over"
              },
              "X-Notes-Included": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "false"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "574385"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/to-template": {
      "post": {
        "summary": "Make a PowerPoint template from a presentation",
        "operationId": "pptxToTemplate",
        "description": "Returns a .potx template (or, with format pptx, a re-themed deck) and optionally changes the theme: colors is a JSON object of theme colours by key (dk1, lt1, dk2, lt2, accent1 to accent6, hlink, folHlink) as six-digit hex; headingFont, bodyFont and name set the fonts and the theme's name. keepSlides keeps all, the first or none of the slides; removeNotesAndAuthor strips notes, comments and the author. Shapes with their own fixed colour or font do not follow the theme (X-Fixed-Color-Shapes and X-Fixed-Font-Runs count them). The .potx is checked in LibreOffice; it has not been tried in desktop PowerPoint. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "name": {
                    "type": "string",
                    "description": "The theme's name (up to 80 characters)"
                  },
                  "colors": {
                    "type": "string",
                    "description": "JSON object, for example {\"accent1\":\"2563EB\"}"
                  },
                  "headingFont": {
                    "type": "string",
                    "description": "Heading font"
                  },
                  "bodyFont": {
                    "type": "string",
                    "description": "Body font"
                  },
                  "keepSlides": {
                    "type": "string",
                    "description": "all (default), first or none",
                    "enum": [
                      "all",
                      "first",
                      "none"
                    ]
                  },
                  "format": {
                    "type": "string",
                    "description": "potx (default) or pptx",
                    "enum": [
                      "potx",
                      "pptx"
                    ]
                  },
                  "removeNotesAndAuthor": {
                    "type": "boolean",
                    "description": "Remove notes, comments and the author's name from the kept slides"
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "name": {
                    "type": "string",
                    "description": "The theme's name (up to 80 characters)"
                  },
                  "colors": {
                    "type": "string",
                    "description": "JSON object, for example {\"accent1\":\"2563EB\"}"
                  },
                  "headingFont": {
                    "type": "string",
                    "description": "Heading font"
                  },
                  "bodyFont": {
                    "type": "string",
                    "description": "Body font"
                  },
                  "keepSlides": {
                    "type": "string",
                    "description": "all (default), first or none",
                    "enum": [
                      "all",
                      "first",
                      "none"
                    ]
                  },
                  "format": {
                    "type": "string",
                    "description": "potx (default) or pptx",
                    "enum": [
                      "potx",
                      "pptx"
                    ]
                  },
                  "removeNotesAndAuthor": {
                    "type": "boolean",
                    "description": "Remove notes, comments and the author's name from the kept slides"
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.template, 467,821 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.template (or the .pptx type with format pptx)": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Format": {
                "schema": {
                  "type": "string"
                },
                "description": "potx or pptx",
                "example": "potx"
              },
              "X-Colors-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "Theme colours changed",
                "example": "0"
              },
              "X-Fonts-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "Fonts changed",
                "example": ""
              },
              "X-Slides-Kept": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides kept",
                "example": "6"
              },
              "X-Slides-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides removed",
                "example": "0"
              },
              "X-Fixed-Color-Shapes": {
                "schema": {
                  "type": "string"
                },
                "description": "Colours fixed in the file that will not follow the theme",
                "example": "0"
              },
              "X-Fixed-Font-Runs": {
                "schema": {
                  "type": "string"
                },
                "description": "Font settings fixed in the file",
                "example": "0"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "467821"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/pptx/convert": {
      "post": {
        "summary": "Convert a presentation between PowerPoint, OpenDocument and PDF",
        "operationId": "pptxConvert",
        "description": "Reads a PowerPoint (.pptx, .ppt, .pps, .pot), OpenDocument (.odp) or Keynote (.key) file and returns it as pptx, odp, ppt or pdf (field to). The type is decided from the file's content, not its name. Converted on the server with LibreOffice; the file is deleted as soon as the response is sent. Layouts, fonts and animations can differ slightly after conversion (X-Note). A password-protected file, a file over 40 MB or a file that is not a presentation is refused with a plain message. 400 for a missing file, a bad 'to' or a file already in the target format; 422 when the file cannot be read; 503 with Retry-After when the converter is busy. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint",
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx, .ppt, .pps, .odp or .key). Up to 40 MB."
                  },
                  "to": {
                    "type": "string",
                    "description": "The format to produce",
                    "enum": [
                      "pptx",
                      "odp",
                      "ppt",
                      "pdf"
                    ],
                    "example": "pptx"
                  }
                },
                "required": [
                  "file",
                  "to"
                ]
              },
              "example": {
                "file": "sample.pptx",
                "to": "pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "to": {
                    "type": "string",
                    "description": "The format to produce",
                    "enum": [
                      "pptx",
                      "odp",
                      "ppt",
                      "pdf"
                    ],
                    "example": "pptx"
                  }
                },
                "required": [
                  "fileBase64",
                  "to"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 380,747 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation (or the odp, ppt or pdf type matching 'to')": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-From": {
                "schema": {
                  "type": "string"
                },
                "description": "What the file was: pptx, ppt, odp or key",
                "example": "pptx"
              },
              "X-To": {
                "schema": {
                  "type": "string"
                },
                "description": "The format produced",
                "example": "pdf"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file sent",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "380747"
              },
              "X-Seconds": {
                "schema": {
                  "type": "string"
                },
                "description": "Time the conversion took",
                "example": "2.7"
              },
              "X-Note": {
                "schema": {
                  "type": "string"
                },
                "description": "Reminder to check the result",
                "example": "Check the result before sharing it."
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/speech/voices": {
      "get": {
        "summary": "Text to Speech: list the voices",
        "operationId": "speechVoices",
        "description": "Lists the four voices (amy, lessac, ryan, alba) with language, accent and gender, the text limit for the calling key (maxCharacters: 500 on a trial key, 2000 on a paid plan), the speed range, the audio formats (mp3, wav), the call weight of a synthesize call (callWeight: 25) and, on a trial key, trialSynthesizeCalls (20). Needs an API key. Counts as one call. Stateless: the request is processed in memory and nothing is stored. Errors: 400 when a field is missing or invalid (the body says which), 401 without a valid X-API-Key header, 429 when the plan's call limit is reached.",
        "tags": [
          "Audio"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "voices": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "example": "amy"
                          },
                          "name": {
                            "type": "string",
                            "example": "Amy"
                          },
                          "language": {
                            "type": "string",
                            "example": "en-US"
                          },
                          "accent": {
                            "type": "string",
                            "example": "American"
                          },
                          "gender": {
                            "type": "string",
                            "enum": [
                              "female",
                              "male"
                            ]
                          },
                          "available": {
                            "type": "boolean",
                            "description": "false when the voice is not installed on the server right now"
                          }
                        },
                        "required": [
                          "id",
                          "name",
                          "language",
                          "accent",
                          "gender",
                          "available"
                        ]
                      }
                    },
                    "defaultVoice": {
                      "type": "string"
                    },
                    "maxCharacters": {
                      "type": "integer",
                      "description": "Characters allowed per synthesize request for this key"
                    },
                    "speed": {
                      "type": "object",
                      "properties": {
                        "min": {
                          "type": "number"
                        },
                        "max": {
                          "type": "number"
                        }
                      }
                    },
                    "formats": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "callWeight": {
                      "type": "integer",
                      "description": "Units one synthesize call counts against the monthly allowance"
                    },
                    "trialSynthesizeCalls": {
                      "type": "integer",
                      "description": "Synthesize calls a trial key gets in total (trial keys only)"
                    }
                  },
                  "required": [
                    "voices",
                    "defaultVoice",
                    "maxCharacters",
                    "speed",
                    "formats"
                  ]
                },
                "example": {
                  "voices": [
                    {
                      "id": "amy",
                      "name": "Amy",
                      "language": "en-US",
                      "accent": "American",
                      "gender": "female",
                      "available": true
                    }
                  ],
                  "defaultVoice": "amy",
                  "maxCharacters": 500,
                  "speed": {
                    "min": 0.5,
                    "max": 2
                  },
                  "formats": [
                    "mp3",
                    "wav"
                  ],
                  "callWeight": 25,
                  "trialSynthesizeCalls": 20
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          }
        }
      }
    },
    "/v1/speech/synthesize": {
      "post": {
        "summary": "Text to Speech: turn text into an MP3 or WAV file",
        "operationId": "speechSynthesize",
        "description": "Speaks the text with one of four voices (amy, lessac and ryan are American English, alba is British) and returns the audio file itself: MP3 by default, or WAV. Needs an API key; there is no key-less use. Headers on the answer: X-Audio-Seconds (length), X-Voice, X-Characters, X-Call-Weight. Limits: a synthesize call counts 25 calls against the plan's monthly allowance (a normal call counts 1). A trial key gets 20 synthesize calls in total (not per month) and up to 500 characters per request; paid plans allow up to 2000 characters per request and the weighted allowance. To keep the service responsive the server speaks 1 request at a time: others wait a few seconds, then get 429 with a Retry-After header (try again after that many seconds); a request that takes longer than 45 seconds, or arrives while the server is under heavy load, gets 503. Only successful calls are counted: rejected, busy and failed requests are never billed. Errors: 400 for text over the limit (code text_too_long), an unknown voice, a speed outside 0.5 to 2 or an unknown field; 401 without a valid X-API-Key; 413 when the audio would be over 10 MB; 429 when the trial is used up (code tts_trial_exhausted), the monthly allowance cannot cover 25 units (code tts_allowance) or the server is busy (code tts_busy); 503 when the server is busy or the voice is not installed. The text is spoken in memory and nothing is stored. Stateless: the request is processed in memory and nothing is stored.",
        "tags": [
          "Audio"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2000,
                    "description": "The text to speak. Up to 500 characters on a trial key and 2000 on a paid plan."
                  },
                  "voice": {
                    "type": "string",
                    "enum": [
                      "amy",
                      "lessac",
                      "ryan",
                      "alba"
                    ],
                    "default": "amy",
                    "description": "amy, lessac and ryan are American English; alba is British (Scottish)."
                  },
                  "speed": {
                    "type": "number",
                    "minimum": 0.5,
                    "maximum": 2,
                    "default": 1,
                    "description": "Speaking speed."
                  },
                  "format": {
                    "type": "string",
                    "enum": [
                      "mp3",
                      "wav"
                    ],
                    "default": "mp3"
                  },
                  "delivery": {
                    "type": "string",
                    "enum": [
                      "natural",
                      "plain"
                    ],
                    "default": "natural",
                    "description": "natural varies the pace and adds pauses between sentences; plain speaks it flat."
                  }
                },
                "required": [
                  "text"
                ],
                "additionalProperties": false
              },
              "example": {
                "text": "Welcome to FreeDailyPro. Your order has shipped.",
                "voice": "amy",
                "format": "mp3"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The audio file (audio/mpeg for mp3, audio/wav when format is wav)",
            "content": {
              "audio/mpeg": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "Content-Disposition": {
                "schema": {
                  "type": "string"
                },
                "description": "attachment; filename=speech.mp3 (or speech.wav)"
              },
              "X-Audio-Seconds": {
                "schema": {
                  "type": "string"
                },
                "description": "Length of the audio in seconds"
              },
              "X-Voice": {
                "schema": {
                  "type": "string"
                },
                "description": "The voice used"
              },
              "X-Characters": {
                "schema": {
                  "type": "string"
                },
                "description": "Characters spoken"
              },
              "X-Call-Weight": {
                "schema": {
                  "type": "string"
                },
                "description": "Units this call counted against the monthly allowance (25)"
              }
            }
          },
          "400": {
            "description": "Text over the limit for the key (500 characters on a trial key, 2000 on a paid plan), an unknown voice, a speed outside 0.5 to 2, or an unknown field; the body explains which"
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "403": {
            "description": "Not available through the RapidAPI channel; use an API key from the developer hub."
          },
          "413": {
            "description": "The audio would be larger than 10 MB. Use mp3 or a shorter text. Not billed."
          },
          "429": {
            "description": "Rate limit exceeded for your plan"
          },
          "503": {
            "description": "The server is busy or under heavy load, the request took longer than 45 seconds, or the voice is not installed. Retry-After says when to retry. Not billed.",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds to wait before retrying"
              }
            }
          }
        }
      }
    },
    "/v1/validate/iban": {
      "post": {
        "tags": [
          "Validation"
        ],
        "summary": "Validate an IBAN",
        "operationId": "validateIban",
        "description": "Checks the country's length from the IBAN registry and the mod 97-10 check digits. Returns the country, check digits, BBAN and the standard 4-character grouping. A wrong check digit or length comes back as valid:false with the reason. Nothing is stored.",
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "iban"
                ],
                "properties": {
                  "iban": {
                    "type": "string",
                    "description": "The IBAN, with or without spaces, any case."
                  }
                }
              },
              "example": {
                "iban": "GB82 WEST 1234 5698 7654 32"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "additionalProperties": true,
                      "description": "Fields depend on the check; always includes valid."
                    }
                  },
                  "required": [
                    "result"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: the body says which field.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "429": {
            "description": "Too many requests; see Retry-After.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/validate/bic": {
      "post": {
        "tags": [
          "Validation"
        ],
        "summary": "Validate a BIC / SWIFT code",
        "operationId": "validateBic",
        "description": "Checks the shape and ISO country, and splits the code into institution, country, location and branch. Also gives the 8 and 11-character forms and flags test BICs. Format only: it does not say whether the bank exists. Nothing is stored.",
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "bic"
                ],
                "properties": {
                  "bic": {
                    "type": "string",
                    "description": "8 or 11 characters."
                  }
                }
              },
              "example": {
                "bic": "DEUTDEFF"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "additionalProperties": true,
                      "description": "Fields depend on the check; always includes valid."
                    }
                  },
                  "required": [
                    "result"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: the body says which field.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "429": {
            "description": "Too many requests; see Retry-After.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/validate/routing-number": {
      "post": {
        "tags": [
          "Validation"
        ],
        "summary": "Validate a US ABA routing number",
        "operationId": "validateRoutingNumber",
        "description": "Checks the 3-7-1 checksum and returns the institution type from the prefix and the Federal Reserve district. It does not look up the bank's name. Nothing is stored.",
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "routingNumber"
                ],
                "properties": {
                  "routingNumber": {
                    "type": "string",
                    "description": "9 digits."
                  }
                }
              },
              "example": {
                "routingNumber": "021000021"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "additionalProperties": true,
                      "description": "Fields depend on the check; always includes valid."
                    }
                  },
                  "required": [
                    "result"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: the body says which field.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "429": {
            "description": "Too many requests; see Retry-After.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/validate/gtin": {
      "post": {
        "tags": [
          "Validation"
        ],
        "summary": "Validate a UPC, EAN, GTIN or ISBN-13",
        "operationId": "validateGtin",
        "description": "Checks the GS1 check digit and names the format (UPC-A, EAN-13, EAN-8, GTIN-14). When the digit is wrong it returns the digit it should be. Notes ISBN and ISSN prefixes. It does not look the product up. Nothing is stored.",
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "code"
                ],
                "properties": {
                  "code": {
                    "type": "string",
                    "description": "8, 12, 13 or 14 digits; spaces and hyphens are ignored."
                  }
                }
              },
              "example": {
                "code": "4006381333931"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "additionalProperties": true,
                      "description": "Fields depend on the check; always includes valid."
                    }
                  },
                  "required": [
                    "result"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: the body says which field.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "429": {
            "description": "Too many requests; see Retry-After.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/validate/vin": {
      "post": {
        "tags": [
          "Validation"
        ],
        "summary": "Validate and decode a VIN",
        "operationId": "validateVin",
        "description": "Checks length, the forbidden letters I, O and Q, and the position-9 check digit (required for North America, informational elsewhere). Returns the region, model year, manufacturer code, plant code and serial. It does not look up the make or model. Nothing is stored.",
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "vin"
                ],
                "properties": {
                  "vin": {
                    "type": "string",
                    "description": "17 characters."
                  }
                }
              },
              "example": {
                "vin": "1HGCM82633A004352"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "additionalProperties": true,
                      "description": "Fields depend on the check; always includes valid."
                    }
                  },
                  "required": [
                    "result"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: the body says which field.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "429": {
            "description": "Too many requests; see Retry-After.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/validate/email": {
      "post": {
        "tags": [
          "Validation"
        ],
        "summary": "Check an email address",
        "operationId": "validateEmail",
        "description": "Checks syntax (including international domains), flags disposable, role (info@, support@) and webmail-provider addresses, suggests a fix for common typos like gmial.com, and looks up the domain's mail records. It never contacts the mailbox, so it cannot confirm that an address exists. Nothing is stored.",
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "email"
                ],
                "properties": {
                  "email": {
                    "type": "string",
                    "description": "The address."
                  },
                  "checkMx": {
                    "type": "boolean",
                    "description": "Look up the domain's mail records (default true)."
                  }
                }
              },
              "example": {
                "email": "jane.doe@example.com",
                "checkMx": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "additionalProperties": true,
                      "description": "Fields depend on the check; always includes valid."
                    }
                  },
                  "required": [
                    "result"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: the body says which field.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "429": {
            "description": "Too many requests; see Retry-After.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/validate/phone": {
      "post": {
        "tags": [
          "Validation"
        ],
        "summary": "Validate and format a phone number",
        "operationId": "validatePhone",
        "description": "Uses Google's libphonenumber plans. Returns validity, country, the E.164, national and international formats, and the line type (mobile, fixed line and others). It does not call the number. Nothing is stored.",
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "phone"
                ],
                "properties": {
                  "phone": {
                    "type": "string",
                    "description": "With +country code, or national format plus defaultCountry."
                  },
                  "defaultCountry": {
                    "type": "string",
                    "description": "Two-letter country code such as US, used when the number has no +.",
                    "example": "US"
                  }
                }
              },
              "example": {
                "phone": "020 7946 0958",
                "defaultCountry": "GB"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "additionalProperties": true,
                      "description": "Fields depend on the check; always includes valid."
                    }
                  },
                  "required": [
                    "result"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: the body says which field.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "429": {
            "description": "Too many requests; see Retry-After.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/validate/gstin": {
      "post": {
        "tags": [
          "Validation"
        ],
        "summary": "Validate and decode an Indian GSTIN",
        "operationId": "validateGstin",
        "description": "Checks the format, the state code, the embedded PAN and the check character. Returns the state, PAN, holder type and entity number. It does not check the registration on the GST portal. Nothing is stored.",
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "gstin"
                ],
                "properties": {
                  "gstin": {
                    "type": "string",
                    "description": "15 characters."
                  }
                }
              },
              "example": {
                "gstin": "27AAPFU0939F1ZV"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "additionalProperties": true,
                      "description": "Fields depend on the check; always includes valid."
                    }
                  },
                  "required": [
                    "result"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: the body says which field.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "429": {
            "description": "Too many requests; see Retry-After.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/validate/pan": {
      "post": {
        "tags": [
          "Validation"
        ],
        "summary": "Validate an Indian PAN",
        "operationId": "validatePan",
        "description": "Checks the format and decodes the holder type (individual, company, firm and others). It does not check the PAN with the tax department. Nothing is stored.",
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "pan"
                ],
                "properties": {
                  "pan": {
                    "type": "string",
                    "description": "10 characters."
                  }
                }
              },
              "example": {
                "pan": "ABCPE1234F"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "object",
                      "additionalProperties": true,
                      "description": "Fields depend on the check; always includes valid."
                    }
                  },
                  "required": [
                    "result"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid input: the body says which field.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "429": {
            "description": "Too many requests; see Retry-After.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    }
  }
}