{
  "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 to PDF with page size, orientation, auto-fit, scaling, headers, locale formats, and optional 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": [
                  "Delimiter",
                  "File"
                ],
                "type": "object",
                "properties": {
                  "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"
                    }
                  },
                  "Delimiter": {
                    "type": "string",
                    "description": "Set fields separator.",
                    "default": ",",
                    "x-ca-featured": true,
                    "x-ca-label": "Fields separator",
                    "x-ca-group": "CSV",
                    "x-ca-type": "String",
                    "x-ca-representation": "Default"
                  },
                  "PageOrientation": {
                    "enum": [
                      "default",
                      "portrait",
                      "landscape"
                    ],
                    "type": "string",
                    "description": "Page orientation.",
                    "default": "default",
                    "x-ca-featured": false,
                    "x-ca-label": "Page orientation",
                    "x-ca-group": "Page Options",
                    "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.",
                    "default": "default",
                    "x-ca-featured": false,
                    "x-ca-label": "Page size",
                    "x-ca-group": "Page Options",
                    "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"
                    }
                  },
                  "AutoFitColumns": {
                    "type": "boolean",
                    "description": "Auto fit column widths to reduce unnecessary empty space in the table.",
                    "default": false,
                    "x-ca-featured": false,
                    "x-ca-label": "Auto fit columns",
                    "x-ca-group": "CSV",
                    "x-ca-type": "Bool",
                    "x-ca-representation": "Default"
                  },
                  "FitToPage": {
                    "type": "boolean",
                    "description": "Scale the table down so all columns fit the page width on a single page across. Switches to landscape when the table is too wide for portrait and trims the margins. A chosen PageOrientation is left unchanged.",
                    "default": false,
                    "x-ca-featured": false,
                    "x-ca-label": "Fit to page",
                    "x-ca-group": "CSV",
                    "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": "CSV",
                    "x-ca-type": "Integer",
                    "x-ca-representation": "Default",
                    "x-ca-range": {
                      "from": "10",
                      "to": "300"
                    }
                  },
                  "HeaderOnEachPage": {
                    "type": "boolean",
                    "description": "Repeat the first CSV row at the top of every page when the table spans multiple pages.",
                    "default": false,
                    "x-ca-featured": false,
                    "x-ca-label": "Header on Each Page",
                    "x-ca-group": "CSV",
                    "x-ca-type": "Bool",
                    "x-ca-representation": "Default"
                  },
                  "PdfaVersion": {
                    "enum": [
                      "none",
                      "pdfA1b",
                      "pdfA2b",
                      "pdfA2u",
                      "pdfA3b",
                      "pdfA3u",
                      "pdfA4",
                      "pdfA4e",
                      "pdfA4f"
                    ],
                    "type": "string",
                    "description": "Set the PDF/A version of the output. Select None to keep a regular PDF.",
                    "default": "none",
                    "x-ca-featured": false,
                    "x-ca-label": "PDF/A version",
                    "x-ca-group": "PDF Output",
                    "x-ca-type": "Collection",
                    "x-ca-representation": "Dropdown",
                    "x-ca-values": {
                      "none": "None",
                      "pdfA1b": "PDF/A-1b",
                      "pdfA2b": "PDF/A-2b",
                      "pdfA2u": "PDF/A-2u",
                      "pdfA3b": "PDF/A-3b",
                      "pdfA3u": "PDF/A-3u",
                      "pdfA4": "PDF/A-4",
                      "pdfA4e": "PDF/A-4e",
                      "pdfA4f": "PDF/A-4f"
                    }
                  },
                  "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"
                  }
                }
              }
            }
          }
        },
        "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.\n",
      "x-ca-overview-markdown": "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-keywords": "",
      "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"
  }
}