PDF Converter Documentation

Convert financial PDFs into structured Excel files with preserved tables and clean, analysis-ready data.

Overview

The PDF Converter transforms financial PDF documents into structured Excel spreadsheets. It preserves table layouts, handles scanned documents via OCR, and outputs clean data that is ready for analysis, reconciliation, or reporting.

Supported Formats

PDF to Excel (.xlsx) — digital and scanned documents
Bank statements with transaction tables
Invoices and receipt breakdowns
Financial reports with data tables
Batch conversion support

API Reference

Convert PDF tables to Excel spreadsheets via our REST API. Upload a PDF document; the engine extracts all detected tables and returns a structured .xlsx file.

POST https://server.gimele.com/api/v1/pdfconverter

Integrate this endpoint into your applications to seamlessly upload a PDF file and receive an Excel workbook with extracted tables.

You can create a developer account to get an api key fromhere.

Headers

Authorization: Bearer <your-api-key>
Content-Type: multipart/form-data

Form Data Parameters

Parameter	Type	Required	Description
file	File	Yes	PDF file to convert (must end in .pdf)
password	string	No	PDF password for encrypted documents

curl -X POST https://server.gimele.com/api/v1/pdfconverter \
  -H "Authorization: Bearer $GIMELE_API_KEY" \
  -F "file=@./bank-statement.pdf" \
  -F "password=mypassword"

Success Response (200 OK)

Returns the Excel file as a binary stream.
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
Content-Disposition: attachment; filename="{basename}.xlsx"

Error Responses

400 Bad Request — Not a PDF

{
 "detail": "File must be a PDF"
}

→ Fix: Upload files with a .pdf extension only

400 Bad Request — No Tables Found

{
 "detail": "No tables found in PDF"
}

→ Fix: Ensure the PDF contains extractable table structures (not plain paragraphs or scanned images without OCR)

500 Internal Server Error — Conversion Failed

{
 "detail": "Error converting PDF: [error details]"
}

→ Fix: Verify the PDF is not corrupted; if encrypted, provide the correct password via the password parameter