convertfilefast-com Conversion API

openapi: 3.2.0
info:
  title: ConvertFileFast Conversion API
  description: '## ConvertFileFast API


    API for converting files to PDF format.


    ### Supported Formats


    | Format | Extension | Description |

    |--------|-----------|-------------|

    | Excel | .xlsx | Excel spreadsheets |

    | Word | .doc, .docx | Word documents |

    | PowerPoint | .pptx | PowerPoint presentations |

    | ZIP | .zip | Batch conversion of multiple files |

    | Text | .txt | Plain text files |

    | RTF | .rtf | Rich Text Format |

    | ODT | .odt | OpenDocument Text |


    ### Authentication


    All conversion endpoints require an API Key.


    **Option 1: X-API-Key header**

    ```

    X-API-Key: your-api-key

    ```


    **Option 2: Authorization Bearer**

    ```

    Authorization: Bearer your-api-key

    ```


    ### Quick Example


    ```bash

    curl -X POST "https://api.convertfilefast.com/v1/convert" \

    -H "X-API-Key: your-api-key" \

    -F "file=@document.docx" \

    -o document_converted.pdf

    ```'
  contact:
    name: API Support
    email: support@convertfilefast.com
  license:
    name: MIT License
    url: https://opensource.org/licenses/MIT
  version: 1.0.0
tags:
- name: Conversion
paths:
  /v1/convert:
    post:
      tags:
      - Conversion
      summary: Convert file to PDF
      description: 'Convert an uploaded file to PDF format.


        **Supported formats:** .xlsx, .doc, .docx, .ppt, .pptx, .zip, .txt, .rtf, .odt


        **Security validations:** magic bytes verification, filename sanitization,

        zip bomb protection, file content validation, timeout protection.


        For .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.


        **Supported formats:** .xlsx, .doc, .docx, .ppt, .pptx, .zip, .txt, .rtf, .odt


        **Requirements:**

        - URL must use HTTP or HTTPS

        - File must be publicly accessible

        - Maximum download size: based on your plan limits

        - 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: []
components:
  schemas:
    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
    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.
    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
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key