openapi: 3.1.0
info:
  title: DocRaptor Async Documents API
  description: DocRaptor's HTML-to-PDF and HTML-to-Excel document generation REST API, powered by Prince XML. Supports synchronous document generation, async document generation with status polling, document hosting, and document listings. HTTP Basic authentication uses the API key as the username with no password.
  version: '1.0'
servers:
- url: https://api.docraptor.com
  description: DocRaptor API
- url: https://docraptor.com
  description: DocRaptor legacy host
security:
- basicAuth: []
tags:
- name: Documents
paths:
  /docs:
    post:
      tags:
      - Documents
      summary: Create a document synchronously
      description: Generate a PDF, XLS, or XLSX document immediately and return the binary content. Test documents are unlimited and free but watermarked.
      operationId: createDoc
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Doc'
      responses:
        '200':
          description: Binary document content
          content:
            application/pdf:
              schema:
                type: string
                format: binary
            application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
              schema:
                type: string
                format: binary
  /docs/{document_id}:
    get:
      tags:
      - Documents
      summary: Retrieve a previously generated document
      operationId: getDoc
      parameters:
      - name: document_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Document content
          content:
            application/pdf:
              schema:
                type: string
                format: binary
components:
  schemas:
    Doc:
      type: object
      properties:
        document_content:
          type: string
          description: HTML to convert
        document_url:
          type: string
          format: uri
          description: URL of HTML page to convert
        name:
          type: string
        type:
          type: string
          enum:
          - pdf
          - xls
          - xlsx
        test:
          type: boolean
          description: Free watermarked test mode
        javascript:
          type: boolean
          description: Enable JavaScript processing
        prince_options:
          type: object
          description: PDF styling/formatting options
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: API key as username, no password