{
  "openapi": "3.0.1",
  "info": {
    "title": "ConvertAPI",
    "description": "# High-Performance File Conversion API\nConvert Word, Excel, PowerPoint, HTML, PDF and Image formats with our powerful file conversion service.\nWe support more than [200 file types.]( https://www.convertapi.com/doc/file-formats)",
    "termsOfService": "https://www.convertapi.com/terms",
    "contact": {
      "url": "https://www.convertapi.com/support",
      "email": "support@convertapi.com"
    },
    "license": {
      "name": "Apache 2.0",
      "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
    },
    "version": "v2"
  },
  "servers": [
    {
      "url": "https://v2.convertapi.com"
    },
    {
      "url": "https://eu-v2.convertapi.com"
    },
    {
      "url": "https://uk-v2.convertapi.com"
    },
    {
      "url": "https://us-v2.convertapi.com"
    },
    {
      "url": "https://ca-v2.convertapi.com"
    },
    {
      "url": "https://as-v2.convertapi.com"
    },
    {
      "url": "https://au-v2.convertapi.com"
    }
  ],
  "paths": {
    "/convert/csv/to/pdf": {
      "summary": "CSV to PDF API",
      "description": "Convert CSV tables to PDF. Set page size and orientation, auto‑fit columns/pages, apply scaling, headers, locale formats, and PDF/A.",
      "post": {
        "tags": [
          "Conversion"
        ],
        "externalDocs": {
          "description": "Read more about the converter",
          "url": "https://www.convertapi.com/csv-to-pdf"
        },
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "required": [
                  "File"
                ],
                "type": "object",
                "properties": {
                  "Timeout": {
                    "maximum": 1200,
                    "minimum": 10,
                    "type": "integer",
                    "description": "Conversion timeout in seconds.",
                    "default": 900,
                    "x-ca-featured": false,
                    "x-ca-label": "Timeout",
                    "x-ca-group": "Execution",
                    "x-ca-type": "Integer",
                    "x-ca-representation": "Default",
                    "x-ca-range": {
                      "from": "10",
                      "to": "1200"
                    }
                  },
                  "StoreFile": {
                    "type": "boolean",
                    "description": "When the `StoreFile` parameter is set to `True`, your converted file is written to ConvertAPI’s encrypted, temporary storage and made available via a time-limited secure download URL, valid for up to 3 hours. After this period, the file is permanently deleted.\r\n\r\nWhen `StoreFile` is set to `False`, conversion happens entirely in-memory. The raw file bytes are streamed back in the API response without touching disk or external storage, ensuring maximum security and zero persistence so that only you can access the content.\r\n",
                    "default": false,
                    "x-ca-featured": false,
                    "x-ca-label": "Store file",
                    "x-ca-group": "Output",
                    "x-ca-type": "Bool",
                    "x-ca-representation": "Default"
                  },
                  "File": {
                    "type": "string",
                    "description": "File to be converted. Value can be URL or file content.",
                    "format": "binary",
                    "x-ca-featured": true,
                    "x-ca-label": "File",
                    "x-ca-group": "Input",
                    "x-ca-type": "File",
                    "x-ca-representation": "Default",
                    "x-ca-allowed-extensions": [
                      "csv"
                    ]
                  },
                  "FileName": {
                    "type": "string",
                    "description": "The `FileName` property defines the name of the output file(s) generated by the file conversion API, ensuring safe and\r\nunique file naming. It sanitizes input filenames to remove potentially harmful characters, automatically appends the\r\ncorrect file extension based on the target format, and includes an indexing feature to distinguish multiple output files\r\nfrom a single input. For example, converting `report.docx` to PDF format might result in `report.pdf` for a single file,\r\nor `report_0.pdf`, `report_1.pdf` for multiple files, ensuring each output file is uniquely identifiable.",
                    "x-ca-featured": false,
                    "x-ca-label": "Output file name",
                    "x-ca-group": "Output",
                    "x-ca-type": "String",
                    "x-ca-representation": "Default",
                    "x-ca-range": {
                      "from": "1",
                      "to": "200"
                    }
                  },
                  "Password": {
                    "type": "string",
                    "description": "Sets the password to open protected documents.",
                    "x-ca-featured": false,
                    "x-ca-label": "Open Password",
                    "x-ca-group": "Excel",
                    "x-ca-type": "String",
                    "x-ca-representation": "Default"
                  },
                  "WorksheetActive": {
                    "type": "boolean",
                    "description": "Set to convert active worksheet. If value is set False all worksheet will be converted.",
                    "default": false,
                    "x-ca-featured": false,
                    "x-ca-label": "Worksheet Active",
                    "x-ca-group": "Excel",
                    "x-ca-type": "Bool",
                    "x-ca-representation": "Default"
                  },
                  "WorksheetIndex": {
                    "maximum": 2000,
                    "minimum": 1,
                    "type": "integer",
                    "description": "Set worksheet index(number) to convert. If value is not set all worksheet will be converted.",
                    "x-ca-featured": false,
                    "x-ca-label": "Worksheet Index",
                    "x-ca-group": "Excel",
                    "x-ca-type": "Integer",
                    "x-ca-representation": "Default",
                    "x-ca-range": {
                      "from": "1",
                      "to": "2000"
                    }
                  },
                  "WorksheetName": {
                    "type": "string",
                    "description": "Set worksheet name to convert. If value is not set all worksheet will be converted.",
                    "x-ca-featured": false,
                    "x-ca-label": "Worksheet Name",
                    "x-ca-group": "Excel",
                    "x-ca-type": "String",
                    "x-ca-representation": "Default"
                  },
                  "ConvertMetadata": {
                    "type": "boolean",
                    "description": "Convert document metadata like Title, Author, Keywords to PDF metadata.",
                    "default": true,
                    "x-ca-featured": false,
                    "x-ca-label": "Convert metadata",
                    "x-ca-group": "Excel",
                    "x-ca-type": "Bool",
                    "x-ca-representation": "Default"
                  },
                  "PageOrientation": {
                    "enum": [
                      "default",
                      "portrait",
                      "landscape"
                    ],
                    "type": "string",
                    "description": "Page orientation.\n * `default` - Default\n * `portrait` - Portrait\n * `landscape` - Landscape",
                    "default": "default",
                    "x-ca-featured": false,
                    "x-ca-label": "Page orientation",
                    "x-ca-group": "Excel",
                    "x-ca-type": "Collection",
                    "x-ca-representation": "Dropdown",
                    "x-ca-values": {
                      "default": "Default",
                      "portrait": "Portrait",
                      "landscape": "Landscape"
                    }
                  },
                  "PageSize": {
                    "enum": [
                      "default",
                      "letter",
                      "lettersmall",
                      "tabloid",
                      "ledger",
                      "legal",
                      "statement",
                      "executive",
                      "a3",
                      "a4",
                      "a4small",
                      "a5",
                      "b4",
                      "b5"
                    ],
                    "type": "string",
                    "description": "Page size.\n * `default` - Default\n * `letter` - Letter\n * `lettersmall` - Letter Small\n * `tabloid` - Tabloid\n * `ledger` - Ledger\n * `legal` - Legal\n * `statement` - Statement\n * `executive` - Executive\n * `a3` - A3\n * `a4` - A4\n * `a4small` - A4 Small\n * `a5` - A5\n * `b4` - B4\n * `b5` - B5",
                    "default": "default",
                    "x-ca-featured": false,
                    "x-ca-label": "Page size",
                    "x-ca-group": "Excel",
                    "x-ca-type": "Collection",
                    "x-ca-representation": "Dropdown",
                    "x-ca-values": {
                      "default": "Default",
                      "letter": "Letter",
                      "lettersmall": "Letter Small",
                      "tabloid": "Tabloid",
                      "ledger": "Ledger",
                      "legal": "Legal",
                      "statement": "Statement",
                      "executive": "Executive",
                      "a3": "A3",
                      "a4": "A4",
                      "a4small": "A4 Small",
                      "a5": "A5",
                      "b4": "B4",
                      "b5": "B5"
                    }
                  },
                  "AutoColumnFit": {
                    "type": "boolean",
                    "description": "Auto fit columns to reduce unnecessary empty space in table.",
                    "default": false,
                    "x-ca-featured": false,
                    "x-ca-label": "Auto Column Fit",
                    "x-ca-group": "Excel",
                    "x-ca-type": "Bool",
                    "x-ca-representation": "Default"
                  },
                  "AutoPageFit": {
                    "type": "boolean",
                    "description": "Automatically enlarges page size, switches to landscape when needed, trims margins, and finally scales the sheet to one-page width. If `PageSize` or `PageOrientation` are chosen, those choices are left unchanged.",
                    "default": false,
                    "x-ca-featured": false,
                    "x-ca-label": "Auto Page Fit",
                    "x-ca-group": "Excel",
                    "x-ca-type": "Bool",
                    "x-ca-representation": "Default"
                  },
                  "ClearPrintArea": {
                    "type": "boolean",
                    "description": "Clear the print area in the converting document.",
                    "default": false,
                    "x-ca-featured": false,
                    "x-ca-label": "Clear Print Area",
                    "x-ca-group": "Excel",
                    "x-ca-type": "Bool",
                    "x-ca-representation": "Default"
                  },
                  "Scale": {
                    "maximum": 300,
                    "minimum": 10,
                    "type": "integer",
                    "description": "Set content scale value in percentage.",
                    "x-ca-featured": false,
                    "x-ca-label": "Scale Content",
                    "x-ca-group": "Excel",
                    "x-ca-type": "Integer",
                    "x-ca-representation": "Default",
                    "x-ca-range": {
                      "from": "10",
                      "to": "300"
                    }
                  },
                  "HeaderOnEachPage": {
                    "type": "boolean",
                    "description": "Ensures the header row is repeated on all pages when the sheet's content spans multiple pages in the PDF output. If a table is detected in the sheet, its header row is used; otherwise, the first row with data is treated as the header.",
                    "default": false,
                    "x-ca-featured": false,
                    "x-ca-label": "Header on Each Page",
                    "x-ca-group": "Excel",
                    "x-ca-type": "Bool",
                    "x-ca-representation": "Default"
                  },
                  "ThousandsSeparator": {
                    "type": "string",
                    "description": "Thousands separator.",
                    "default": ",",
                    "x-ca-featured": false,
                    "x-ca-label": "Thousands separator",
                    "x-ca-group": "Formatting Options",
                    "x-ca-type": "String",
                    "x-ca-representation": "Default"
                  },
                  "DecimalSeparator": {
                    "type": "string",
                    "description": "Decimal separator.",
                    "default": ".",
                    "x-ca-featured": false,
                    "x-ca-label": "Decimal separator",
                    "x-ca-group": "Formatting Options",
                    "x-ca-type": "String",
                    "x-ca-representation": "Default"
                  },
                  "DateFormat": {
                    "enum": [
                      "us",
                      "iso",
                      "eu",
                      "german",
                      "japanese"
                    ],
                    "type": "string",
                    "description": "Sets the date format for output document, overriding the default US locale (M/d/yyyy) to ensure consistency regardless of regional Excel settings.\n * `us` - US (M/d/yyyy)\n * `iso` - ISO (yyyy-MM-dd)\n * `eu` - EU (dd/MM/yyyy)\n * `german` - German (dd.MM.yyyy)\n * `japanese` - Japanese (yyyy/MM/dd)",
                    "default": "us",
                    "x-ca-featured": false,
                    "x-ca-label": "Date Format",
                    "x-ca-group": "Formatting Options",
                    "x-ca-type": "Collection",
                    "x-ca-representation": "Dropdown",
                    "x-ca-values": {
                      "us": "US (M/d/yyyy)",
                      "iso": "ISO (yyyy-MM-dd)",
                      "eu": "EU (dd/MM/yyyy)",
                      "german": "German (dd.MM.yyyy)",
                      "japanese": "Japanese (yyyy/MM/dd)"
                    }
                  },
                  "Pdfa": {
                    "type": "boolean",
                    "description": "Create PDF/A-1b compliant document.",
                    "default": false,
                    "x-ca-featured": false,
                    "x-ca-label": "Create PDF/A",
                    "x-ca-group": "PDF Output",
                    "x-ca-type": "Bool",
                    "x-ca-representation": "Default"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ConversionCost": {
                      "type": "integer",
                      "description": "This amount will be deducted from your balance after the conversion.",
                      "format": "int32",
                      "example": 1
                    },
                    "Files": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "FileName": {
                            "type": "string",
                            "description": "Name of the converted file.",
                            "example": "myfile.pdf"
                          },
                          "FileExt": {
                            "type": "string",
                            "description": "File type (file name extension)",
                            "example": "pdf"
                          },
                          "FileSize": {
                            "type": "integer",
                            "description": "File size",
                            "format": "int32",
                            "example": 111955
                          },
                          "FileId": {
                            "type": "string",
                            "description": "File ID",
                            "example": "25811safe8e61dd3f51ef00ee5f58b92"
                          },
                          "Url": {
                            "type": "string",
                            "description": "File URL",
                            "example": "https://v2.convertapi.com/d/v01plsb72o0cmdooq90w4d1lnqsf6oy4/myfile.pdf"
                          },
                          "FileData": {
                            "type": "string",
                            "description": "Base64 encoded file data",
                            "format": "base64",
                            "example": "JVBERi0xLjcKJb662+4KMSAwIG9iago8PC9UeXBlIC9DYXRhbG9n..."
                          }
                        }
                      }
                    }
                  },
                  "externalDocs": {
                    "url": "https://www.convertapi.com/doc/content-types#applicationjson-1"
                  }
                }
              },
              "multipart/mixed": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "externalDocs": {
                    "url": "https://www.convertapi.com/doc/content-types#multipartmixed"
                  }
                },
                "example": "--43cf1475-ab15-4c6b-b5ee-e2cbcedfe92f\nConversionCost: 1\nContent-Type: application/octet-stream\nContent-Disposition: attachment; filename=\"my_file.pdf\"; size=8475\n\n--FILE CONTENT--\n--43cf1475-ab15-4c6b-b5ee-e2cbcedfe92f--\n"
              },
              "application/octet-stream": {
                "schema": {
                  "type": "string",
                  "format": "binary",
                  "externalDocs": {
                    "url": "https://www.convertapi.com/doc/content-types#applicationoctet-stream-1"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "415": {
            "$ref": "#/components/responses/415"
          },
          "500": {
            "$ref": "#/components/responses/500"
          },
          "503": {
            "$ref": "#/components/responses/503"
          }
        },
        "security": [
          {
            "secret": [ ]
          },
          {
            "token": [ ]
          },
          {
            "jwt": [ ]
          }
        ]
      },
      "x-ca-overview": "Convert CSV data into clean, shareable PDF documents using the Excel rendering engine. Control page orientation and page size, auto‑fit columns or entire pages, clear print areas, and apply custom scaling to match layout constraints. Add a header on each page and optionally preserve document metadata during conversion. Normalize locale with thousands/decimal separators and date formats for consistent presentation across regions. Open password‑protected inputs when needed and select or create a target worksheet context as part of the rendering pipeline. Enable PDF/A for long‑term preservation and process single files or batches for predictable, repeatable results.",
      "x-ca-meta-title": "CSV to PDF Conversion API – Convert CSV tables to PDF.",
      "x-ca-meta-description": "Convert CSV to PDF. Control page size/orientation, auto‑fit, scaling, headers, locale separators and date formats, metadata, and PDF/A.",
      "x-ca-source-formats": "csv",
      "x-ca-destination-formats": "pdf",
      "x-ca-tags": [
        "spreadsheet",
        "office",
        "pdf"
      ]
    }
  },
  "components": {
    "schemas": {
      "fileId": {
        "maxLength": 32,
        "minLength": 32,
        "type": "string",
        "description": "Uploaded File ID",
        "example": "25811safe8e61dd3f51ef00ee5f58b92"
      },
      "error": {
        "type": "object",
        "properties": {
          "Code": {
            "type": "integer",
            "description": "Error message code",
            "format": "int32",
            "example": 4000
          },
          "Message": {
            "type": "string",
            "description": "Error message text",
            "example": "Parameter validation error."
          }
        },
        "externalDocs": {
          "url": "https://www.convertapi.com/doc/response-codes"
        }
      }
    },
    "responses": {
      "400": {
        "description": "Malformed request",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error"
            }
          }
        }
      },
      "401": {
        "description": "Authentication error",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error"
            }
          }
        }
      },
      "415": {
        "description": "File type error",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error"
            }
          }
        }
      },
      "500": {
        "description": "Conversion failure",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error"
            }
          }
        }
      },
      "503": {
        "description": "Conversion rate limit error",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error"
            }
          }
        }
      }
    },
    "parameters": {
      "fileId": {
        "name": "fileId",
        "in": "path",
        "description": "File ID",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/fileId"
        }
      },
      "src": {
        "name": "src",
        "in": "path",
        "description": "Source file format (docx, pdf, jpg etc.)",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "dst": {
        "name": "dst",
        "in": "path",
        "description": "Destination file format (docx, pdf, jpg etc.)",
        "required": true,
        "schema": {
          "type": "string"
        }
      }
    },
    "headers": {
      "content-disposition": {
        "description": "File information ([docummentation](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Disposition))",
        "schema": {
          "type": "string"
        }
      },
      "file-name": {
        "description": "File name",
        "schema": {
          "type": "string"
        }
      },
      "file-ext": {
        "description": "File name extension",
        "schema": {
          "type": "string"
        }
      },
      "file-size": {
        "description": "File size",
        "schema": {
          "type": "integer"
        }
      }
    },
    "securitySchemes": {
      "secret": {
        "type": "http",
        "description": "[Get `Secret`](https://www.convertapi.com/a/secret)",
        "scheme": "bearer"
      },
      "token": {
        "type": "http",
        "description": "[Get `Token`](https://www.convertapi.com/a/api-tokens)",
        "scheme": "bearer"
      },
      "jwt": {
        "type": "http",
        "description": "[Get `JWT`](https://www.convertapi.com/a/jwt-tokens)",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "tags": [
    {
      "name": "Conversion",
      "description": "File Conversion API call",
      "externalDocs": {
        "description": "File Conversion related operations",
        "url": "https://www.convertapi.com/doc/content-types"
      }
    },
    {
      "name": "File Server",
      "description": "ConvertAPI temporary file storage",
      "externalDocs": {
        "description": "File Server related operations",
        "url": "https://www.convertapi.com/doc/upload"
      }
    },
    {
      "name": "User",
      "description": "API User",
      "externalDocs": {
        "description": "API User related operations",
        "url": "https://www.convertapi.com/doc/user"
      }
    }
  ],
  "externalDocs": {
    "description": "Find out more about ConvertAPI",
    "url": "https://www.convertapi.com/doc"
  }
}