{"openapi":"3.1.0","info":{"title":"ConvertFileFast API","description":"\n## ConvertFileFast API\n\nAPI for converting files to PDF format.\n\n### Supported Formats\n\n| Format | Extension | Description |\n|--------|-----------|-------------|\n| Excel | .xlsx | Excel spreadsheets |\n| Word | .doc, .docx | Word documents |\n| PowerPoint | .pptx | PowerPoint presentations |\n| ZIP | .zip | Batch conversion of multiple files |\n| Text | .txt | Plain text files |\n| RTF | .rtf | Rich Text Format |\n| ODT | .odt | OpenDocument Text |\n\n### Authentication\n\nAll conversion endpoints require an API Key.\n\n**Option 1: X-API-Key header**\n```\nX-API-Key: your-api-key\n```\n\n**Option 2: Authorization Bearer**\n```\nAuthorization: Bearer your-api-key\n```\n\n### Quick Example\n\n```bash\ncurl -X POST \"https://api.convertfilefast.com/v1/convert\" \\\n  -H \"X-API-Key: your-api-key\" \\\n  -F \"file=@document.docx\" \\\n  -o document_converted.pdf\n```\n","contact":{"name":"API Support","email":"support@convertfilefast.com"},"license":{"name":"MIT License","url":"https://opensource.org/licenses/MIT"},"version":"1.0.0"},"paths":{"/v1/convert":{"post":{"tags":["Conversion"],"summary":"Convert file to PDF","description":"Convert an uploaded file to PDF format.\n\n**Supported formats:** .xlsx, .doc, .docx, .ppt, .pptx, .zip, .txt, .rtf, .odt\n\n**Security validations:** magic bytes verification, filename sanitization,\nzip bomb protection, file content validation, timeout protection.\n\nFor .zip files, returns a ZIP containing all successfully converted PDFs.","operationId":"convert_file_v1_convert_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_convert_file_v1_convert_post"}}},"required":true},"responses":{"200":{"description":"File converted successfully","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}},"application/zip":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Bad Request - Invalid file or unsupported format"},"401":{"description":"Unauthorized - Invalid or missing API key"},"413":{"description":"Payload Too Large - File size exceeds limit"},"500":{"description":"Internal Server Error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v1/convert/from-url":{"post":{"tags":["Conversion"],"summary":"Convert file from URL to PDF","description":"Download a file from a URL and convert it to PDF format.\n\n**Supported formats:** .xlsx, .doc, .docx, .ppt, .pptx, .zip, .txt, .rtf, .odt\n\n**Requirements:**\n- URL must use HTTP or HTTPS\n- File must be publicly accessible\n- Maximum download size: based on your plan limits\n- Download timeout: 120 seconds","operationId":"convert_from_url_v1_convert_from_url_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConvertFromUrlRequest"}}},"required":true},"responses":{"200":{"description":"File downloaded and converted successfully","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}},"application/zip":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Bad Request - Invalid URL, download failed, or invalid file"},"401":{"description":"Unauthorized - Invalid or missing API key"},"413":{"description":"Payload Too Large - File size exceeds limit"},"500":{"description":"Internal Server Error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/docx-to-pdf":{"post":{"tags":["Documents to PDF"],"summary":"Convert DOCX to PDF","description":"Upload a DOCX (or DOC) file or provide a URL to convert to PDF.\n\nUses LibreOffice headless with python-docx+reportlab fallback.","operationId":"docx_to_pdf_v2_convert_docx_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_docx_to_pdf_v2_convert_docx_to_pdf_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"413":{"description":"File size exceeds plan limit"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/docx-to-txt":{"post":{"tags":["Documents to PDF","Documents to Text"],"summary":"Convert DOCX to plain text","description":"Upload a DOCX file or provide a URL to extract its text as UTF-8 plain text.\n\nParagraphs and tables are kept in document order (table cells separated by tabs). Formatting, images, headers and footers are dropped.","operationId":"docx_to_txt_v2_convert_docx_to_txt_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_docx_to_txt_v2_convert_docx_to_txt_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"text/plain; charset=utf-8":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"413":{"description":"File size exceeds plan limit"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/xlsx-to-pdf":{"post":{"tags":["Documents to PDF"],"summary":"Convert XLSX to PDF","description":"Upload an XLSX file or provide a URL to convert to PDF.\n\nUses openpyxl + reportlab to render all sheets.","operationId":"xlsx_to_pdf_v2_convert_xlsx_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_xlsx_to_pdf_v2_convert_xlsx_to_pdf_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"413":{"description":"File size exceeds plan limit"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/pptx-to-pdf":{"post":{"tags":["Documents to PDF"],"summary":"Convert PPTX to PDF","description":"Upload a PPTX file or provide a URL to convert to PDF.\n\nUses LibreOffice headless with python-pptx+reportlab fallback.","operationId":"pptx_to_pdf_v2_convert_pptx_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_pptx_to_pdf_v2_convert_pptx_to_pdf_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"413":{"description":"File size exceeds plan limit"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/ppt-to-pdf":{"post":{"tags":["Documents to PDF"],"summary":"Convert PPT to PDF","description":"Upload a PPT (legacy PowerPoint) file or provide a URL to convert to PDF.\n\nUses LibreOffice headless.","operationId":"ppt_to_pdf_v2_convert_ppt_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_ppt_to_pdf_v2_convert_ppt_to_pdf_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"413":{"description":"File size exceeds plan limit"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/doc-to-pdf":{"post":{"tags":["Documents to PDF"],"summary":"Convert DOC to PDF","description":"Upload a DOC file or provide a URL to convert to PDF.\n\nUses LibreOffice headless with python-docx+reportlab fallback.","operationId":"doc_to_pdf_v2_convert_doc_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_doc_to_pdf_v2_convert_doc_to_pdf_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"413":{"description":"File size exceeds plan limit"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/rtf-to-pdf":{"post":{"tags":["Documents to PDF"],"summary":"Convert RTF to PDF","description":"Upload an RTF file or provide a URL to convert to PDF.\n\nUses LibreOffice headless.","operationId":"rtf_to_pdf_v2_convert_rtf_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_rtf_to_pdf_v2_convert_rtf_to_pdf_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"413":{"description":"File size exceeds plan limit"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/odt-to-pdf":{"post":{"tags":["Documents to PDF"],"summary":"Convert ODT to PDF","description":"Upload an ODT file or provide a URL to convert to PDF.\n\nUses LibreOffice headless.","operationId":"odt_to_pdf_v2_convert_odt_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_odt_to_pdf_v2_convert_odt_to_pdf_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"413":{"description":"File size exceeds plan limit"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/txt-to-pdf":{"post":{"tags":["Documents to PDF"],"summary":"Convert TXT to PDF","description":"Upload a plain text file or provide a URL to convert to PDF.\n\nUses reportlab for rendering.","operationId":"txt_to_pdf_v2_convert_txt_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_txt_to_pdf_v2_convert_txt_to_pdf_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"413":{"description":"File size exceeds plan limit"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/csv-to-pdf":{"post":{"tags":["Documents to PDF"],"summary":"Convert CSV to PDF","description":"Upload a CSV file or provide a URL to convert to a formatted PDF table.\n\nUses reportlab with bold headers and alternating row colors.","operationId":"csv_to_pdf_v2_convert_csv_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_csv_to_pdf_v2_convert_csv_to_pdf_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"413":{"description":"File size exceeds plan limit"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/html-to-pdf":{"post":{"tags":["HTML to PDF"],"summary":"Convert HTML to PDF","description":"Convert HTML content to PDF using WeasyPrint.\n\nAccepts **JSON body** (`application/json`) with `content`, `css`, `options` fields OR\n**multipart/form-data** with `file` (.html) + optional `css` + optional `options` (JSON string).\n\nThe `options` object supports: `page_size` (A4, A3, A5, letter, legal), `orientation` (portrait, landscape), and margin fields.","operationId":"html_to_pdf_v2_convert_html_to_pdf_post","responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid or missing input"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/markdown-to-pdf":{"post":{"tags":["HTML to PDF"],"summary":"Convert Markdown to PDF","description":"Convert Markdown content to PDF using markdown-it-py and WeasyPrint.\n\nAccepts **JSON body** (`application/json`) with `content`, `css`, `options` fields OR\n**multipart/form-data** with `file` (.md) + optional `css` + optional `options` (JSON string).","operationId":"markdown_to_pdf_v2_convert_markdown_to_pdf_post","responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid or missing input"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/url-to-pdf":{"post":{"tags":["HTML to PDF"],"summary":"Convert URL to PDF","description":"Fetch a public web page and render it to PDF using WeasyPrint.\n\nAccepts **JSON body** (`application/json`) with `url` and optional `options` fields OR\n**multipart/form-data** with `url` as a form field.\n\nSSRF protection is applied: private/reserved IP addresses are blocked.","operationId":"url_to_pdf_v2_convert_url_to_pdf_post","responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid URL, SSRF attempt blocked, or fetch failed"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error (WeasyPrint failure)"}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/pdf-to-jpg":{"post":{"tags":["PDF to Others"],"summary":"Convert PDF to JPEG image(s)","description":"Convert one or all pages of a PDF to JPEG images.\n\n- If `page` is specified, returns a single `image/jpeg` response.\n- If `page` is omitted, converts all pages and returns an `application/zip` archive with files named `page_001.jpg`, etc.\n\nDPI is validated against the global maximum (600) AND your plan's limit.","operationId":"pdf_to_jpg_v2_convert_pdf_to_jpg_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_pdf_to_jpg_v2_convert_pdf_to_jpg_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/jpeg":{},"application/zip":{}}},"400":{"description":"Invalid PDF, DPI too high, or page out of range"},"401":{"description":"Unauthorized"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/pdf-to-png":{"post":{"tags":["PDF to Others"],"summary":"Convert PDF to PNG image(s)","description":"Convert one or all pages of a PDF to PNG images.\n\n- If `page` is specified, returns a single `image/png` response.\n- If `page` is omitted, converts all pages and returns an `application/zip` archive with files named `page_001.png`, etc.\n\nDPI is validated against the global maximum (600) AND your plan's limit.","operationId":"pdf_to_png_v2_convert_pdf_to_png_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_pdf_to_png_v2_convert_pdf_to_png_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/png":{},"application/zip":{}}},"400":{"description":"Invalid PDF, DPI too high, or page out of range"},"401":{"description":"Unauthorized"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/pdf-to-txt":{"post":{"tags":["PDF to Others"],"summary":"Extract text from a PDF","description":"Extract plain text from one or all pages of a PDF file.\n\nReturns a `text/plain` response with page separators (`--- Page N ---`) between pages.\n\nThe `pages` parameter accepts formats like `1,3,5-7` or `1-5`.","operationId":"pdf_to_txt_v2_convert_pdf_to_txt_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_pdf_to_txt_v2_convert_pdf_to_txt_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}},"text/plain":{}}},"400":{"description":"Invalid PDF or page range"},"401":{"description":"Unauthorized"},"500":{"description":"Internal extraction error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/pdf-to-docx":{"post":{"tags":["PDF to Others"],"summary":"Convert PDF to DOCX","description":"Convert a PDF file to a DOCX (Word) document using LibreOffice headless.\n\nAccepts `file` (PDF) OR `url` as form fields.","operationId":"pdf_to_docx_v2_convert_pdf_to_docx_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_pdf_to_docx_v2_convert_pdf_to_docx_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/vnd.openxmlformats-officedocument.wordprocessingml.document":{}}},"400":{"description":"Invalid PDF or bad URL"},"401":{"description":"Unauthorized"},"500":{"description":"Internal conversion error (LibreOffice failure)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/pdf-to-xlsx":{"post":{"tags":["PDF to Others"],"summary":"Extract PDF tables to XLSX","description":"Extract tables from a PDF and return an Excel XLSX workbook.\n\nEach page is written to a separate sheet named 'Page N'.\n\nThe `pages` parameter accepts formats like `1,3,5-7` or `1-5`.","operationId":"pdf_to_xlsx_v2_convert_pdf_to_xlsx_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_pdf_to_xlsx_v2_convert_pdf_to_xlsx_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{}}},"400":{"description":"Invalid PDF, bad URL, or invalid page range"},"401":{"description":"Unauthorized"},"500":{"description":"Internal extraction error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/pdf-to-csv":{"post":{"tags":["PDF to Others"],"summary":"Extract PDF tables to CSV","description":"Extract tables from a PDF and return a single CSV file.\n\nPages are separated by `--- Page N ---` markers.\n\nThe `pages` parameter accepts formats like `1,3,5-7` or `1-5`.","operationId":"pdf_to_csv_v2_convert_pdf_to_csv_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_pdf_to_csv_v2_convert_pdf_to_csv_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}},"text/csv":{}}},"400":{"description":"Invalid PDF, bad URL, or invalid page range"},"401":{"description":"Unauthorized"},"500":{"description":"Internal extraction error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/pdf/merge":{"post":{"tags":["PDF Operations"],"summary":"Merge multiple PDFs into one","description":"Merge two or more PDF files into a single PDF document.\n\nRequires at least 2 PDF files. The plan limit for merge is checked against `v2_merge_max_files`.","operationId":"merge_pdfs_v2_pdf_merge_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_merge_pdfs_v2_pdf_merge_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Less than 2 files, plan limit exceeded, or invalid PDF"},"401":{"description":"Unauthorized"},"500":{"description":"Internal error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/pdf/split":{"post":{"tags":["PDF Operations"],"summary":"Split PDF pages into individual files","description":"Extract specific pages from a PDF and return them as individual PDF files in a ZIP archive.\n\nThe `pages` parameter accepts formats like: `1,3,5-7` or `1-3,8,10-12`.","operationId":"split_pdf_v2_pdf_split_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_split_pdf_v2_pdf_split_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/zip":{}}},"400":{"description":"Invalid pages or non-PDF file"},"401":{"description":"Unauthorized"},"500":{"description":"Internal error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/pdf/compress":{"post":{"tags":["PDF Operations"],"summary":"Compress a PDF file","description":"Reduce the file size of a PDF.\n\nQuality presets:\n- `low`: aggressive compression (image_quality=40)\n- `medium`: balanced (image_quality=65)\n- `high`: better quality (image_quality=80)\n- `maximum`: minimal compression (image_quality=95)\n\nResponse includes `X-Original-Size`, `X-Compressed-Size`, and `X-Compression-Ratio` headers.","operationId":"compress_pdf_v2_pdf_compress_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_compress_pdf_v2_pdf_compress_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid quality or non-PDF file"},"401":{"description":"Unauthorized"},"500":{"description":"Internal error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/pdf/rotate":{"post":{"tags":["PDF Operations"],"summary":"Rotate pages in a PDF","description":"Rotate pages in a PDF by 90, 180, or 270 degrees.\n\nIf `pages` is omitted, all pages are rotated. The `pages` parameter accepts formats like: `1,3,5-7`.","operationId":"rotate_pdf_v2_pdf_rotate_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_rotate_pdf_v2_pdf_rotate_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid angle, pages, or non-PDF file"},"401":{"description":"Unauthorized"},"500":{"description":"Internal error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/pdf/protect":{"post":{"tags":["PDF Operations"],"summary":"Add password protection to a PDF","description":"Add password protection to a PDF file.\n\nThe `password` field is required and must not be empty.","operationId":"protect_pdf_v2_pdf_protect_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_protect_pdf_v2_pdf_protect_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Missing password, or non-PDF file"},"401":{"description":"Unauthorized"},"500":{"description":"Internal error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/pdf/unlock":{"post":{"tags":["PDF Operations"],"summary":"Remove password protection from a PDF","description":"Remove password protection from a PDF file.\n\nReturns 400 if the PDF is not encrypted, or if the password is incorrect.","operationId":"unlock_pdf_v2_pdf_unlock_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_unlock_pdf_v2_pdf_unlock_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"PDF not protected, wrong password, or non-PDF file"},"401":{"description":"Unauthorized"},"500":{"description":"Internal error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/pdf/extract-text":{"post":{"tags":["PDF Operations"],"summary":"Extract text and tables from a PDF","description":"Extract text content and optionally tables from a PDF file.\n\nReturns a JSON response with the `ExtractTextResponse` structure.\n\n`page_number` in the response starts at 1 (1-based). `total_pages` reflects the total number of pages in the PDF, not just the requested pages.","operationId":"extract_text_from_pdf_v2_pdf_extract_text_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_extract_text_from_pdf_v2_pdf_extract_text_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid pages or non-PDF file"},"401":{"description":"Unauthorized"},"500":{"description":"Internal error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/jpg-to-png":{"post":{"tags":["Image Conversion"],"summary":"Convert JPG to PNG","description":"Upload a JPG/JPEG file or provide a URL to convert to PNG.","operationId":"jpg_to_png_v2_convert_jpg_to_png_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_jpg_to_png_v2_convert_jpg_to_png_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/png":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/png-to-jpg":{"post":{"tags":["Image Conversion"],"summary":"Convert PNG to JPG","description":"Upload a PNG file or provide a URL to convert to JPG.","operationId":"png_to_jpg_v2_convert_png_to_jpg_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_png_to_jpg_v2_convert_png_to_jpg_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/jpeg":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/heic-to-jpg":{"post":{"tags":["Image Conversion"],"summary":"Convert HEIC to JPG","description":"Upload a HEIC/HEIF file or provide a URL to convert to JPG.","operationId":"heic_to_jpg_v2_convert_heic_to_jpg_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_heic_to_jpg_v2_convert_heic_to_jpg_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/jpeg":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/heic-to-png":{"post":{"tags":["Image Conversion"],"summary":"Convert HEIC to PNG","description":"Upload a HEIC/HEIF file or provide a URL to convert to PNG.","operationId":"heic_to_png_v2_convert_heic_to_png_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_heic_to_png_v2_convert_heic_to_png_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/png":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/webp-to-jpg":{"post":{"tags":["Image Conversion"],"summary":"Convert WebP to JPG","description":"Upload a WebP file or provide a URL to convert to JPG.","operationId":"webp_to_jpg_v2_convert_webp_to_jpg_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_webp_to_jpg_v2_convert_webp_to_jpg_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/jpeg":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/webp-to-png":{"post":{"tags":["Image Conversion"],"summary":"Convert WebP to PNG","description":"Upload a WebP file or provide a URL to convert to PNG.","operationId":"webp_to_png_v2_convert_webp_to_png_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_webp_to_png_v2_convert_webp_to_png_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/png":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/avif-to-jpg":{"post":{"tags":["Image Conversion"],"summary":"Convert AVIF to JPG","description":"Upload an AVIF file or provide a URL to convert to JPG.","operationId":"avif_to_jpg_v2_convert_avif_to_jpg_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_avif_to_jpg_v2_convert_avif_to_jpg_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/jpeg":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/avif-to-png":{"post":{"tags":["Image Conversion"],"summary":"Convert AVIF to PNG","description":"Upload an AVIF file or provide a URL to convert to PNG.","operationId":"avif_to_png_v2_convert_avif_to_png_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_avif_to_png_v2_convert_avif_to_png_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/png":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/svg-to-png":{"post":{"tags":["Image Conversion"],"summary":"Convert SVG to PNG","description":"Upload an SVG file or provide a URL to convert to PNG.","operationId":"svg_to_png_v2_convert_svg_to_png_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_svg_to_png_v2_convert_svg_to_png_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/png":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/svg-to-jpg":{"post":{"tags":["Image Conversion"],"summary":"Convert SVG to JPG","description":"Upload an SVG file or provide a URL to convert to JPG.","operationId":"svg_to_jpg_v2_convert_svg_to_jpg_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_svg_to_jpg_v2_convert_svg_to_jpg_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/jpeg":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/bmp-to-jpg":{"post":{"tags":["Image Conversion"],"summary":"Convert BMP to JPG","description":"Upload a BMP file or provide a URL to convert to JPG.","operationId":"bmp_to_jpg_v2_convert_bmp_to_jpg_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_bmp_to_jpg_v2_convert_bmp_to_jpg_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/jpeg":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/bmp-to-png":{"post":{"tags":["Image Conversion"],"summary":"Convert BMP to PNG","description":"Upload a BMP file or provide a URL to convert to PNG.","operationId":"bmp_to_png_v2_convert_bmp_to_png_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_bmp_to_png_v2_convert_bmp_to_png_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/png":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/tiff-to-jpg":{"post":{"tags":["Image Conversion"],"summary":"Convert TIFF to JPG","description":"Upload a TIFF/TIF file or provide a URL to convert to JPG.","operationId":"tiff_to_jpg_v2_convert_tiff_to_jpg_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_tiff_to_jpg_v2_convert_tiff_to_jpg_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/jpeg":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/tiff-to-png":{"post":{"tags":["Image Conversion"],"summary":"Convert TIFF to PNG","description":"Upload a TIFF/TIF file or provide a URL to convert to PNG.","operationId":"tiff_to_png_v2_convert_tiff_to_png_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_tiff_to_png_v2_convert_tiff_to_png_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/png":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/jpg-to-webp":{"post":{"tags":["Image Conversion"],"summary":"Convert JPG to WebP","description":"Upload a JPG/JPEG file or provide a URL to convert to WebP.","operationId":"jpg_to_webp_v2_convert_jpg_to_webp_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_jpg_to_webp_v2_convert_jpg_to_webp_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/webp":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/png-to-webp":{"post":{"tags":["Image Conversion"],"summary":"Convert PNG to WebP","description":"Upload a PNG file or provide a URL to convert to WebP.","operationId":"png_to_webp_v2_convert_png_to_webp_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_png_to_webp_v2_convert_png_to_webp_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/webp":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/jpg-to-pdf":{"post":{"tags":["Images to PDF"],"summary":"Convert JPG to PDF","description":"Upload a JPG/JPEG file or provide a URL to convert to PDF.","operationId":"jpg_to_pdf_v2_convert_jpg_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_jpg_to_pdf_v2_convert_jpg_to_pdf_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/png-to-pdf":{"post":{"tags":["Images to PDF"],"summary":"Convert PNG to PDF","description":"Upload a PNG file or provide a URL to convert to PDF.","operationId":"png_to_pdf_v2_convert_png_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_png_to_pdf_v2_convert_png_to_pdf_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/heic-to-pdf":{"post":{"tags":["Images to PDF"],"summary":"Convert HEIC to PDF","description":"Upload a HEIC/HEIF file or provide a URL to convert to PDF.","operationId":"heic_to_pdf_v2_convert_heic_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_heic_to_pdf_v2_convert_heic_to_pdf_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/webp-to-pdf":{"post":{"tags":["Images to PDF"],"summary":"Convert WebP to PDF","description":"Upload a WebP file or provide a URL to convert to PDF.","operationId":"webp_to_pdf_v2_convert_webp_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_webp_to_pdf_v2_convert_webp_to_pdf_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/avif-to-pdf":{"post":{"tags":["Images to PDF"],"summary":"Convert AVIF to PDF","description":"Upload an AVIF file or provide a URL to convert to PDF.","operationId":"avif_to_pdf_v2_convert_avif_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_avif_to_pdf_v2_convert_avif_to_pdf_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/svg-to-pdf":{"post":{"tags":["Images to PDF"],"summary":"Convert SVG to PDF","description":"Upload an SVG file or provide a URL to convert to PDF.","operationId":"svg_to_pdf_v2_convert_svg_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_svg_to_pdf_v2_convert_svg_to_pdf_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/bmp-to-pdf":{"post":{"tags":["Images to PDF"],"summary":"Convert BMP to PDF","description":"Upload a BMP file or provide a URL to convert to PDF.","operationId":"bmp_to_pdf_v2_convert_bmp_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_bmp_to_pdf_v2_convert_bmp_to_pdf_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/tiff-to-pdf":{"post":{"tags":["Images to PDF"],"summary":"Convert TIFF to PDF","description":"Upload a TIFF/TIF file or provide a URL to convert to PDF.","operationId":"tiff_to_pdf_v2_convert_tiff_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_tiff_to_pdf_v2_convert_tiff_to_pdf_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/images-to-pdf":{"post":{"tags":["Images to PDF"],"summary":"Convert multiple images to PDF","description":"Upload multiple image files (JPG, PNG, BMP, TIFF, HEIC, WebP, AVIF, SVG) to combine them into a single multi-page PDF.\n\nThe `page_size` parameter controls how each image is placed:\n- `fit` (default): each page is sized to fit the image exactly.\n- `A4`: images are placed on A4 pages (210 x 297 mm).\n- `letter`: images are placed on US Letter pages (8.5 x 11 in).\n\nThe maximum number of files is determined by your plan.","operationId":"images_to_pdf_v2_convert_images_to_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_images_to_pdf_v2_convert_images_to_pdf_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/pdf":{}}},"400":{"description":"Invalid file, unsupported type, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/image/resize":{"post":{"tags":["Image Operations"],"summary":"Resize an image","description":"Resize an image to specified dimensions.\n\nAt least one of `width` or `height` must be provided. If only one dimension is given, the other is calculated proportionally.\n\n**Fit modes:**\n- `contain`: resize to fit inside the dimensions without cropping (preserves aspect ratio)\n- `cover`: resize and crop to fill exactly (may crop edges)\n- `fill`: stretch to exactly width x height (ignores aspect ratio)\n\nThe `format` field controls the output image format. Defaults to the source format.","operationId":"resize_image_v2_image_resize_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_resize_image_v2_image_resize_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"image/png":{},"image/jpeg":{},"image/webp":{}}},"400":{"description":"Invalid file, unsupported type, bad URL, or invalid parameters"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/image/compress":{"post":{"tags":["Image Operations"],"summary":"Compress an image","description":"Compress an image to reduce its file size.\n\nThe `quality` parameter (1-100) controls compression aggressiveness for lossy formats (JPEG, WebP). For PNG, it maps to the compression level.\n\nOptional `max_width` and `max_height` parameters will downscale the image proportionally if it exceeds those dimensions before compressing.\n\n**Response headers:**\n- `X-Original-Size`: original file size in bytes\n- `X-Compressed-Size`: compressed file size in bytes\n- `X-Compression-Ratio`: percentage size reduction (e.g. '42%')","operationId":"compress_image_v2_image_compress_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_compress_image_v2_image_compress_post"}}}},"responses":{"200":{"description":"Successful Response","headers":{"X-Original-Size":{"description":"Original file size in bytes","schema":{"type":"string"}},"X-Compressed-Size":{"description":"Compressed file size in bytes","schema":{"type":"string"}},"X-Compression-Ratio":{"description":"Percentage size reduction","schema":{"type":"string"}}},"content":{"image/png":{},"image/jpeg":{},"image/webp":{}}},"400":{"description":"Invalid file, unsupported type, bad URL, or invalid parameters"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/json-to-csv":{"post":{"tags":["Data Conversion"],"summary":"Convert JSON to CSV","description":"Convert a JSON array of objects to a CSV file.\n\nAccepts **JSON body** (`application/json`) with `data` (list of objects) and optional `delimiter` fields OR\n**multipart/form-data** with `file` (.json) OR `url`.","operationId":"json_to_csv_v2_convert_json_to_csv_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_json_to_csv_v2_convert_json_to_csv_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"text/csv":{}}},"400":{"description":"Invalid JSON, not a list of objects, or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/csv-to-json":{"post":{"tags":["Data Conversion"],"summary":"Convert CSV to JSON","description":"Convert a CSV file to a JSON array of objects.\n\nAccepts **multipart/form-data** with `file` (.csv) OR `url`.\n\nReturns `application/json` with a list of objects.","operationId":"csv_to_json_endpoint_v2_convert_csv_to_json_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_csv_to_json_endpoint_v2_convert_csv_to_json_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Invalid CSV or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/csv-to-xlsx":{"post":{"tags":["Data Conversion"],"summary":"Convert CSV to XLSX","description":"Convert a CSV file to an Excel XLSX workbook.\n\nAccepts **multipart/form-data** with `file` (.csv) OR `url`.","operationId":"csv_to_xlsx_endpoint_v2_convert_csv_to_xlsx_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_csv_to_xlsx_endpoint_v2_convert_csv_to_xlsx_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{}}},"400":{"description":"Invalid CSV or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/convert/xlsx-to-csv":{"post":{"tags":["Data Conversion"],"summary":"Convert XLSX to CSV","description":"Convert an Excel XLSX workbook (active sheet) to a CSV file.\n\nAccepts **multipart/form-data** with `file` (.xlsx) OR `url`.","operationId":"xlsx_to_csv_endpoint_v2_convert_xlsx_to_csv_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_xlsx_to_csv_endpoint_v2_convert_xlsx_to_csv_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"text/csv":{}}},"400":{"description":"Invalid XLSX or bad URL"},"401":{"description":"Unauthorized - invalid or missing API key"},"429":{"description":"Rate limit or monthly limit exceeded"},"500":{"description":"Internal conversion error"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/feedback":{"post":{"tags":["Feedback"],"summary":"Report a bug, missing feature, or quality issue","description":"Receive structured feedback, store it, and create/link a kanban card.","operationId":"submit_feedback_v2_feedback_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_submit_feedback_v2_feedback_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/billing/status":{"get":{"tags":["Billing"],"summary":"Get Billing Status","description":"Return the user's current plan and credit summary.","operationId":"get_billing_status_v2_billing_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/billing/checkout/subscription":{"post":{"tags":["Billing"],"summary":"Create Subscription Checkout","description":"Create a hosted Stripe Checkout link for a subscription plan.","operationId":"create_subscription_checkout_v2_billing_checkout_subscription_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionCheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/billing/checkout/credits":{"post":{"tags":["Billing"],"summary":"Create Credit Checkout","description":"Create a hosted Stripe Checkout link for one-time credit packs.","operationId":"create_credit_checkout_v2_billing_checkout_credits_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditCheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/billing/portal":{"post":{"tags":["Billing"],"summary":"Create Billing Portal Link","description":"Create a Stripe Billing Portal link for an existing customer.","operationId":"create_billing_portal_link_v2_billing_portal_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/v2/billing/auto-recharge":{"get":{"tags":["Billing"],"summary":"Get Auto Recharge Status","description":"Return the user's auto-recharge settings and recent attempt history\n(plan-002 Trilha A, US-011), including the manual payment link for any\nattempt that required authentication or was declined.","operationId":"get_auto_recharge_status_v2_billing_auto_recharge_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]},"post":{"tags":["Billing"],"summary":"Update Auto Recharge Settings","description":"Turn automatic recharge on/off and/or change the trigger threshold.\nReturns the same shape as GET /auto-recharge.","operationId":"update_auto_recharge_settings_v2_billing_auto_recharge_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutoRechargeUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]},{"APIKeyHeader":[]}]}},"/health":{"get":{"tags":["Health"],"summary":"Health check","description":"Health check endpoint for monitoring and load balancers.","operationId":"health_check_health_get","responses":{"200":{"description":"API is healthy","content":{"application/json":{"schema":{},"example":{"status":"ok"}}}}}}},"/v1/info":{"get":{"tags":["Information"],"summary":"API information and supported formats","description":"Get API information including supported formats and limits.","operationId":"api_info_v1_info_get","responses":{"200":{"description":"API information","content":{"application/json":{"schema":{},"example":{"api_name":"ConvertFileFast API","version":"1.0.0","supported_formats":["xlsx","doc","docx","pptx","zip","txt","rtf","odt"],"max_file_size_mb":50,"documentation_url":"/v1/docs"}}}}}}}},"components":{"schemas":{"AutoRechargeUpdateRequest":{"properties":{"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled","description":"Turn automatic recharge on or off. Omit to leave unchanged."},"threshold_credits":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":0.0},{"type":"null"}],"title":"Threshold Credits","description":"Balance at which auto-recharge fires. Omit to leave unchanged."}},"type":"object","title":"AutoRechargeUpdateRequest"},"Body_avif_to_jpg_v2_convert_avif_to_jpg_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"AVIF file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of AVIF file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_avif_to_jpg_v2_convert_avif_to_jpg_post"},"Body_avif_to_pdf_v2_convert_avif_to_pdf_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"AVIF file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of AVIF file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_avif_to_pdf_v2_convert_avif_to_pdf_post"},"Body_avif_to_png_v2_convert_avif_to_png_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"AVIF file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of AVIF file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_avif_to_png_v2_convert_avif_to_png_post"},"Body_bmp_to_jpg_v2_convert_bmp_to_jpg_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"BMP file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of BMP file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_bmp_to_jpg_v2_convert_bmp_to_jpg_post"},"Body_bmp_to_pdf_v2_convert_bmp_to_pdf_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"BMP file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of BMP file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_bmp_to_pdf_v2_convert_bmp_to_pdf_post"},"Body_bmp_to_png_v2_convert_bmp_to_png_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"BMP file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of BMP file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_bmp_to_png_v2_convert_bmp_to_png_post"},"Body_compress_image_v2_image_compress_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"Image file to compress"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of image file to compress"},"quality":{"type":"integer","title":"Quality","description":"Compression quality (1-100, higher = better quality)","default":85},"format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Format","description":"Output format: jpeg, png, webp, etc. Defaults to source format."},"max_width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Width","description":"Maximum output width in pixels (downscales proportionally if exceeded)"},"max_height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Height","description":"Maximum output height in pixels (downscales proportionally if exceeded)"}},"type":"object","title":"Body_compress_image_v2_image_compress_post"},"Body_compress_pdf_v2_pdf_compress_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"PDF file to compress"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of PDF file to compress"},"quality":{"type":"string","title":"Quality","description":"Compression quality: low, medium, high, maximum","default":"medium"},"remove_metadata":{"type":"boolean","title":"Remove Metadata","description":"Remove PDF metadata to reduce size further","default":false}},"type":"object","title":"Body_compress_pdf_v2_pdf_compress_post"},"Body_convert_file_v1_convert_post":{"properties":{"file":{"type":"string","format":"binary","title":"File","description":"File to convert to PDF"}},"type":"object","required":["file"],"title":"Body_convert_file_v1_convert_post"},"Body_csv_to_json_endpoint_v2_convert_csv_to_json_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"CSV file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of CSV file to convert"},"delimiter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delimiter","description":"CSV column delimiter (default: comma)","default":","}},"type":"object","title":"Body_csv_to_json_endpoint_v2_convert_csv_to_json_post"},"Body_csv_to_pdf_v2_convert_csv_to_pdf_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"CSV file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of CSV file to convert"}},"type":"object","title":"Body_csv_to_pdf_v2_convert_csv_to_pdf_post"},"Body_csv_to_xlsx_endpoint_v2_convert_csv_to_xlsx_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"CSV file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of CSV file to convert"}},"type":"object","title":"Body_csv_to_xlsx_endpoint_v2_convert_csv_to_xlsx_post"},"Body_doc_to_pdf_v2_convert_doc_to_pdf_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"DOC file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of DOC file to convert"}},"type":"object","title":"Body_doc_to_pdf_v2_convert_doc_to_pdf_post"},"Body_docx_to_pdf_v2_convert_docx_to_pdf_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"DOCX or DOC file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of DOCX or DOC file to convert"}},"type":"object","title":"Body_docx_to_pdf_v2_convert_docx_to_pdf_post"},"Body_docx_to_txt_v2_convert_docx_to_txt_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"DOCX file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of DOCX file to convert"}},"type":"object","title":"Body_docx_to_txt_v2_convert_docx_to_txt_post"},"Body_extract_text_from_pdf_v2_pdf_extract_text_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"PDF file to extract text from"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of PDF file to extract text from"},"pages":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pages","description":"Pages to extract (e.g. '1-5'). If omitted, extracts all pages."},"extract_tables":{"type":"boolean","title":"Extract Tables","description":"If true, also extract tables from each page","default":true}},"type":"object","title":"Body_extract_text_from_pdf_v2_pdf_extract_text_post"},"Body_heic_to_jpg_v2_convert_heic_to_jpg_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"HEIC or HEIF file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of HEIC/HEIF file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_heic_to_jpg_v2_convert_heic_to_jpg_post"},"Body_heic_to_pdf_v2_convert_heic_to_pdf_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"HEIC or HEIF file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of HEIC/HEIF file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_heic_to_pdf_v2_convert_heic_to_pdf_post"},"Body_heic_to_png_v2_convert_heic_to_png_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"HEIC or HEIF file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of HEIC/HEIF file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_heic_to_png_v2_convert_heic_to_png_post"},"Body_images_to_pdf_v2_convert_images_to_pdf_post":{"properties":{"files":{"items":{"type":"string","format":"binary"},"type":"array","title":"Files","description":"Image files to combine into a PDF"},"page_size":{"type":"string","title":"Page Size","description":"Page size: 'fit', 'A4', or 'letter'","default":"fit"}},"type":"object","required":["files"],"title":"Body_images_to_pdf_v2_convert_images_to_pdf_post"},"Body_jpg_to_pdf_v2_convert_jpg_to_pdf_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"JPG or JPEG file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of JPG/JPEG file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_jpg_to_pdf_v2_convert_jpg_to_pdf_post"},"Body_jpg_to_png_v2_convert_jpg_to_png_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"JPG or JPEG file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of JPG/JPEG file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100, applies to lossy formats)","default":90}},"type":"object","title":"Body_jpg_to_png_v2_convert_jpg_to_png_post"},"Body_jpg_to_webp_v2_convert_jpg_to_webp_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"JPG or JPEG file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of JPG/JPEG file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_jpg_to_webp_v2_convert_jpg_to_webp_post"},"Body_json_to_csv_v2_convert_json_to_csv_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"JSON file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of JSON file to convert"},"delimiter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delimiter","description":"CSV column delimiter (default: comma)","default":","}},"type":"object","title":"Body_json_to_csv_v2_convert_json_to_csv_post"},"Body_merge_pdfs_v2_pdf_merge_post":{"properties":{"files":{"items":{"type":"string","format":"binary"},"type":"array","title":"Files","description":"PDF files to merge (minimum 2)"}},"type":"object","required":["files"],"title":"Body_merge_pdfs_v2_pdf_merge_post"},"Body_odt_to_pdf_v2_convert_odt_to_pdf_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"ODT file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of ODT file to convert"}},"type":"object","title":"Body_odt_to_pdf_v2_convert_odt_to_pdf_post"},"Body_pdf_to_csv_v2_convert_pdf_to_csv_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"PDF file to extract tables from"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of PDF file to extract tables from"},"pages":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pages","description":"Pages to extract (e.g. '1,3,5-7'). If omitted, processes all pages."}},"type":"object","title":"Body_pdf_to_csv_v2_convert_pdf_to_csv_post"},"Body_pdf_to_docx_v2_convert_pdf_to_docx_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"PDF file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of PDF file to convert"},"pages":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pages","description":"Page range (e.g. '1-3,5')"}},"type":"object","title":"Body_pdf_to_docx_v2_convert_pdf_to_docx_post"},"Body_pdf_to_jpg_v2_convert_pdf_to_jpg_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"PDF file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of PDF file to convert"},"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page","description":"1-based page number. If omitted, all pages are converted and returned as ZIP."},"dpi":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Dpi","description":"Resolution in DPI (default 150, max 600)."},"quality":{"type":"integer","title":"Quality","description":"JPEG quality (1-100, default 90).","default":90}},"type":"object","title":"Body_pdf_to_jpg_v2_convert_pdf_to_jpg_post"},"Body_pdf_to_png_v2_convert_pdf_to_png_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"PDF file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of PDF file to convert"},"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page","description":"1-based page number. If omitted, all pages are converted and returned as ZIP."},"dpi":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Dpi","description":"Resolution in DPI (default 150, max 600)."},"quality":{"type":"integer","title":"Quality","description":"Quality hint (1-100). For PNG the value is used as compress level hint.","default":90}},"type":"object","title":"Body_pdf_to_png_v2_convert_pdf_to_png_post"},"Body_pdf_to_txt_v2_convert_pdf_to_txt_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"PDF file to extract text from"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of PDF file to extract text from"},"pages":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pages","description":"Pages to extract (e.g. '1,3,5-7'). If omitted, extracts all pages."}},"type":"object","title":"Body_pdf_to_txt_v2_convert_pdf_to_txt_post"},"Body_pdf_to_xlsx_v2_convert_pdf_to_xlsx_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"PDF file to extract tables from"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of PDF file to extract tables from"},"pages":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pages","description":"Pages to extract (e.g. '1,3,5-7'). If omitted, processes all pages."}},"type":"object","title":"Body_pdf_to_xlsx_v2_convert_pdf_to_xlsx_post"},"Body_png_to_jpg_v2_convert_png_to_jpg_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"PNG file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of PNG file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_png_to_jpg_v2_convert_png_to_jpg_post"},"Body_png_to_pdf_v2_convert_png_to_pdf_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"PNG file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of PNG file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_png_to_pdf_v2_convert_png_to_pdf_post"},"Body_png_to_webp_v2_convert_png_to_webp_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"PNG file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of PNG file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_png_to_webp_v2_convert_png_to_webp_post"},"Body_ppt_to_pdf_v2_convert_ppt_to_pdf_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"PPT file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of PPT file to convert"}},"type":"object","title":"Body_ppt_to_pdf_v2_convert_ppt_to_pdf_post"},"Body_pptx_to_pdf_v2_convert_pptx_to_pdf_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"PPTX file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of PPTX file to convert"}},"type":"object","title":"Body_pptx_to_pdf_v2_convert_pptx_to_pdf_post"},"Body_protect_pdf_v2_pdf_protect_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"PDF file to protect"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of PDF file to protect"},"password":{"type":"string","title":"Password","description":"Password to protect the PDF"}},"type":"object","required":["password"],"title":"Body_protect_pdf_v2_pdf_protect_post"},"Body_resize_image_v2_image_resize_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"Image file to resize"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of image file to resize"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width","description":"Target width in pixels"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height","description":"Target height in pixels"},"fit":{"type":"string","title":"Fit","description":"Fit mode: contain, cover, or fill","default":"contain"},"format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Format","description":"Output format: jpeg, png, webp, etc."}},"type":"object","title":"Body_resize_image_v2_image_resize_post"},"Body_rotate_pdf_v2_pdf_rotate_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"PDF file to rotate"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of PDF file to rotate"},"angle":{"type":"integer","title":"Angle","description":"Rotation angle: 90, 180, or 270 degrees"},"pages":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pages","description":"Pages to rotate (e.g. '1,3,5-7'). If omitted, all pages are rotated."}},"type":"object","required":["angle"],"title":"Body_rotate_pdf_v2_pdf_rotate_post"},"Body_rtf_to_pdf_v2_convert_rtf_to_pdf_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"RTF file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of RTF file to convert"}},"type":"object","title":"Body_rtf_to_pdf_v2_convert_rtf_to_pdf_post"},"Body_split_pdf_v2_pdf_split_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"PDF file to split"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of PDF file to split"},"pages":{"type":"string","title":"Pages","description":"Page range string, e.g. '1,3,5-7' or '1-5'"}},"type":"object","required":["pages"],"title":"Body_split_pdf_v2_pdf_split_post"},"Body_submit_feedback_v2_feedback_post":{"properties":{"summary":{"type":"string","title":"Summary","description":"What went wrong or what is missing."},"category":{"type":"string","title":"Category","description":"bug | missing_conversion | quality | other","default":"other"},"tool":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tool","description":"Tool/conversion involved, e.g. 'convert_file docx-to-pdf'."},"context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context","description":"Extra detail: error message, input format, expected vs actual."}},"type":"object","required":["summary"],"title":"Body_submit_feedback_v2_feedback_post"},"Body_svg_to_jpg_v2_convert_svg_to_jpg_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"SVG file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of SVG file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_svg_to_jpg_v2_convert_svg_to_jpg_post"},"Body_svg_to_pdf_v2_convert_svg_to_pdf_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"SVG file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of SVG file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_svg_to_pdf_v2_convert_svg_to_pdf_post"},"Body_svg_to_png_v2_convert_svg_to_png_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"SVG file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of SVG file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_svg_to_png_v2_convert_svg_to_png_post"},"Body_tiff_to_jpg_v2_convert_tiff_to_jpg_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"TIFF or TIF file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of TIFF/TIF file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_tiff_to_jpg_v2_convert_tiff_to_jpg_post"},"Body_tiff_to_pdf_v2_convert_tiff_to_pdf_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"TIFF or TIF file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of TIFF/TIF file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_tiff_to_pdf_v2_convert_tiff_to_pdf_post"},"Body_tiff_to_png_v2_convert_tiff_to_png_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"TIFF or TIF file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of TIFF/TIF file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_tiff_to_png_v2_convert_tiff_to_png_post"},"Body_txt_to_pdf_v2_convert_txt_to_pdf_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"TXT file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of TXT file to convert"}},"type":"object","title":"Body_txt_to_pdf_v2_convert_txt_to_pdf_post"},"Body_unlock_pdf_v2_pdf_unlock_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"PDF file to unlock"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of PDF file to unlock"},"password":{"type":"string","title":"Password","description":"Password to unlock the PDF"}},"type":"object","required":["password"],"title":"Body_unlock_pdf_v2_pdf_unlock_post"},"Body_webp_to_jpg_v2_convert_webp_to_jpg_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"WebP file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of WebP file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_webp_to_jpg_v2_convert_webp_to_jpg_post"},"Body_webp_to_pdf_v2_convert_webp_to_pdf_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"WebP file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of WebP file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_webp_to_pdf_v2_convert_webp_to_pdf_post"},"Body_webp_to_png_v2_convert_webp_to_png_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"WebP file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of WebP file to convert"},"quality":{"type":"integer","title":"Quality","description":"Output quality (1-100)","default":90}},"type":"object","title":"Body_webp_to_png_v2_convert_webp_to_png_post"},"Body_xlsx_to_csv_endpoint_v2_convert_xlsx_to_csv_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"XLSX file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of XLSX file to convert"},"sheet_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sheet Name","description":"Sheet name to export (default: active sheet)"}},"type":"object","title":"Body_xlsx_to_csv_endpoint_v2_convert_xlsx_to_csv_post"},"Body_xlsx_to_pdf_v2_convert_xlsx_to_pdf_post":{"properties":{"file":{"anyOf":[{"type":"string","format":"binary"},{"type":"null"}],"title":"File","description":"XLSX file to convert"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"URL of XLSX file to convert"}},"type":"object","title":"Body_xlsx_to_pdf_v2_convert_xlsx_to_pdf_post"},"ConvertFromUrlRequest":{"properties":{"url":{"type":"string","title":"Url","description":"URL of the file to download and convert to PDF","examples":["https://example.com/file.xlsx"]}},"type":"object","required":["url"],"title":"ConvertFromUrlRequest","description":"Schema for URL-based file conversion request."},"CreditCheckoutRequest":{"properties":{"pack_id":{"type":"string","enum":["pack_1000","pack_10000"],"title":"Pack Id","description":"Credit pack to buy."},"currency":{"type":"string","title":"Currency","description":"Preferred currency: usd, brl, eur, or gbp.","default":"usd"}},"type":"object","required":["pack_id"],"title":"CreditCheckoutRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"SubscriptionCheckoutRequest":{"properties":{"plan_id":{"type":"string","enum":["pro","scale"],"title":"Plan Id","description":"Plan to subscribe to."},"annual":{"type":"boolean","title":"Annual","description":"Use annual billing instead of monthly.","default":false},"currency":{"type":"string","title":"Currency","description":"Preferred currency: usd, brl, eur, or gbp.","default":"usd"}},"type":"object","required":["plan_id"],"title":"SubscriptionCheckoutRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"},"APIKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}}}}