{"openapi":"3.1.0","info":{"title":"QuoAPI – PDF & Document Conversion API","version":"1.3.0","description":"Canonical QuoAPI public API contract. Provider details and internal routes are intentionally excluded."},"servers":[{"url":"https://api.quoapi.com"}],"tags":[{"name":"document-conversion-api","description":"Convert, merge, split and optimize documents and PDFs."}],"paths":{"/v1/document/convert":{"post":{"operationId":"document_convert","summary":"Convert document","description":"Convert a document to another format.","tags":["document-conversion-api"],"security":[{"BearerAuth":["document.convert"]}],"x-quoapi-capability":"document.convert","x-quoapi-contract-version":"1.3.0:document.convert","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"to":{"type":"string","x-quoapi-widget":"select","title":"To","default":"pdf","enum":["standard","express"]},"file":{"type":"string","x-quoapi-widget":"file","title":"File","format":"binary"},"country":{"type":"string","pattern":"^[A-Z]{2}$","x-quoapi-widget":"country","x-quoapi-hidden":true,"description":"Optional ISO 3166-1 alpha-2 routing context."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","x-quoapi-widget":"currency","x-quoapi-hidden":true,"description":"Optional ISO 4217 commercial context."}},"additionalProperties":false,"required":["to","file"]},"example":{"to":"pdf"}}}},"responses":{"200":{"description":"Canonical response","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","additionalProperties":true,"description":"Canonical QuoAPI response data for this capability."},"request_id":{"type":"string"}}}}}},"4XX":{"description":"Canonical client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Canonical service error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/pdf/merge":{"post":{"operationId":"pdf_merge","summary":"Merge PDFs","description":"Merge multiple PDFs into one document.","tags":["document-conversion-api"],"security":[{"BearerAuth":["pdf.merge"]}],"x-quoapi-capability":"pdf.merge","x-quoapi-contract-version":"1.3.0:pdf.merge","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"files":{"type":"string","x-quoapi-widget":"file","title":"Files","format":"binary"},"country":{"type":"string","pattern":"^[A-Z]{2}$","x-quoapi-widget":"country","x-quoapi-hidden":true,"description":"Optional ISO 3166-1 alpha-2 routing context."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","x-quoapi-widget":"currency","x-quoapi-hidden":true,"description":"Optional ISO 4217 commercial context."}},"additionalProperties":false,"required":["files"]},"example":{}}}},"responses":{"200":{"description":"Canonical response","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","additionalProperties":true,"description":"Canonical QuoAPI response data for this capability."},"request_id":{"type":"string"}}}}}},"4XX":{"description":"Canonical client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Canonical service error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/pdf/split":{"post":{"operationId":"pdf_split","summary":"Split PDF","description":"Split selected pages or page ranges.","tags":["document-conversion-api"],"security":[{"BearerAuth":["pdf.split"]}],"x-quoapi-capability":"pdf.split","x-quoapi-contract-version":"1.3.0:pdf.split","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","x-quoapi-widget":"file","title":"File","format":"binary"},"pages":{"type":"string","x-quoapi-widget":"text","title":"Pages","default":"1-2"},"country":{"type":"string","pattern":"^[A-Z]{2}$","x-quoapi-widget":"country","x-quoapi-hidden":true,"description":"Optional ISO 3166-1 alpha-2 routing context."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","x-quoapi-widget":"currency","x-quoapi-hidden":true,"description":"Optional ISO 4217 commercial context."}},"additionalProperties":false,"required":["file","pages"]},"example":{"pages":"1-2"}}}},"responses":{"200":{"description":"Canonical response","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","additionalProperties":true,"description":"Canonical QuoAPI response data for this capability."},"request_id":{"type":"string"}}}}}},"4XX":{"description":"Canonical client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Canonical service error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/pdf/compress":{"post":{"operationId":"pdf_compress","summary":"Compress PDF","description":"Optimize PDF size.","tags":["document-conversion-api"],"security":[{"BearerAuth":["pdf.compress"]}],"x-quoapi-capability":"pdf.compress","x-quoapi-contract-version":"1.3.0:pdf.compress","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","x-quoapi-widget":"file","title":"File","format":"binary"},"quality":{"type":"string","x-quoapi-widget":"select","title":"Quality","default":"balanced","enum":["balanced","small","high"]},"country":{"type":"string","pattern":"^[A-Z]{2}$","x-quoapi-widget":"country","x-quoapi-hidden":true,"description":"Optional ISO 3166-1 alpha-2 routing context."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","x-quoapi-widget":"currency","x-quoapi-hidden":true,"description":"Optional ISO 4217 commercial context."}},"additionalProperties":false,"required":["file","quality"]},"example":{"quality":"balanced"}}}},"responses":{"200":{"description":"Canonical response","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","additionalProperties":true,"description":"Canonical QuoAPI response data for this capability."},"request_id":{"type":"string"}}}}}},"4XX":{"description":"Canonical client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Canonical service error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/pdf/to_image":{"post":{"operationId":"pdf_to_image","summary":"PDF to image","description":"Render PDF pages as images.","tags":["document-conversion-api"],"security":[{"BearerAuth":["pdf.to_image"]}],"x-quoapi-capability":"pdf.to_image","x-quoapi-contract-version":"1.3.0:pdf.to_image","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","x-quoapi-widget":"file","title":"File","format":"binary"},"format":{"type":"string","x-quoapi-widget":"select","title":"Format","default":"png","enum":["EN16931","XRechnung","ZUGFeRD","KSeF"]},"country":{"type":"string","pattern":"^[A-Z]{2}$","x-quoapi-widget":"country","x-quoapi-hidden":true,"description":"Optional ISO 3166-1 alpha-2 routing context."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","x-quoapi-widget":"currency","x-quoapi-hidden":true,"description":"Optional ISO 4217 commercial context."}},"additionalProperties":false,"required":["file","format"]},"example":{"format":"png"}}}},"responses":{"200":{"description":"Canonical response","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","additionalProperties":true,"description":"Canonical QuoAPI response data for this capability."},"request_id":{"type":"string"}}}}}},"4XX":{"description":"Canonical client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Canonical service error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/image/to_pdf":{"post":{"operationId":"image_to_pdf","summary":"Image to PDF","description":"Combine images into a PDF.","tags":["document-conversion-api"],"security":[{"BearerAuth":["image.to_pdf"]}],"x-quoapi-capability":"image.to_pdf","x-quoapi-contract-version":"1.3.0:image.to_pdf","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"files":{"type":"string","x-quoapi-widget":"file","title":"Files","format":"binary"},"country":{"type":"string","pattern":"^[A-Z]{2}$","x-quoapi-widget":"country","x-quoapi-hidden":true,"description":"Optional ISO 3166-1 alpha-2 routing context."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","x-quoapi-widget":"currency","x-quoapi-hidden":true,"description":"Optional ISO 4217 commercial context."}},"additionalProperties":false,"required":["files"]},"example":{}}}},"responses":{"200":{"description":"Canonical response","content":{"application/json":{"schema":{"type":"object","required":["data","request_id"],"properties":{"data":{"type":"object","additionalProperties":true,"description":"Canonical QuoAPI response data for this capability."},"request_id":{"type":"string"}}}}}},"4XX":{"description":"Canonical client error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"5XX":{"description":"Canonical service error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"QuoAPI API key"}},"schemas":{"ErrorResponse":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id","details"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}}