API Reference — v1.0
7 GET 48 POST 55 endpoints WS
docs.md — LLM-readable reference
DB
Companies
7 endpoints
GET
Organization lookup — name, ICO, DIC, ICDPH, address
cin | search: string
GET
Search organization stakeholders (shareholders)
search | cin | organization: string
GET
Search statutory representatives
search | cin | organization: string
GET
Full organization detail with stakeholders & statutory members
cin | search: string
GET
Fuzzy name similarity search
name: string
GET
Search tax liabilities by name or CIN
search | cin: string
GET
Search active VAT registrations
search | cin: string
EXT
Extract
3 endpoints
POST
/v1/extract/text
Extract text from files. Optionally process through AI with a custom prompt (summarize, reformat, translate). Files are optional — omit them to use the endpoint as a pure AI prompt. Optional model overrides the default mistralai/mistral-small-2603.
{key: string, files?: [{base64: string}], prompt?: string, model?: string}text/plain
playground
POST
/v1/extract/json
Extract text from files, then return structured JSON via AI (optional prompt for desired structure). Files are optional — omit them to use the endpoint as a pure AI prompt. Optional model overrides the default mistralai/mistral-small-2603.
{key: string, prompt?: string, model?: string, files?: [{base64: string}]}application/json
playground
POST
/v1/extract/xml
Extract text from files, then return structured XML via AI (optional prompt for desired structure). Files are optional — omit them to use the endpoint as a pure AI prompt. Optional model overrides the default mistralai/mistral-small-2603.
{key: string, prompt?: string, model?: string, files?: [{base64: string}]}application/xml
playground
FMT
JSON / XML
3 endpoints
POST
/v1/json/xml
Convert JSON to XML
{rootName: string, json: object}string
playground
POST
/v1/xml/json
Convert XML to JSON
{xml: string}object
playground
POST
/v1/xml/xzep
Extract document from XZeP XML envelope
{base64: string, name: string}{filename, base64}
playground
IMG
Image
2 endpoints
POST
/v1/image/resize
Resize image to specific dimensions
{image: base64, width: number, height: number, format: "jpg"|"png"|"icon"}{base64}
playground
POST
/v1/image/extract
Extract foreground images from PDF or image
{files: base64[]}base64[]
playground
ODT
FODT
2 endpoints
POST
/v1/fodt/pdf
Convert FODT to PDF, optional password encryption
{base64: string, password?: string}{base64}
playground
POST
/v1/fodt/fill
Fill FODT template with values and convert to PDF
{base64: string, values: object, password?: string}{base64}
playground
ZIP
ZIP / ASiCE
1 endpoint
POST
/v1/zip/asice
Extract documents from ASiCE container
{base64: string}[{filename, base64}]
playground
XLS
XLS / XLSX
7 endpoints
POST
/v1/xls2/append
Append rows to existing XLSX workbook
{base64: string, data: any[][]}{base64}
playground
POST
/v1/xls/read
Read XLS/XLSX file
{base64: string}{workbook: object, sheet_names: string[]}
playground
POST
/v1/xls/sheets
Create multi-sheet XLS
{sheets: [{name: string, data: any[][]}]}{base64}
playground
POST
/v1/xls/from_array
Convert 2D array to XLS
{data: any[][]}{base64}
playground
POST
/v1/xls/from_json
Convert JSON array of objects to XLS
{json: object[]}{base64}
playground
POST
/v1/xls/from_json_array
Convert array of objects to XLS (keys as headers)
{array: object[]}{base64}
playground
POST
/v1/xls/pdf
Convert XLS/XLSX to PDF
{base64: string, password?: string}{base64}
playground
DOC
DOCX
2 endpoints
POST
/v1/doc/fill
Fill DOCX template with values
{base64: string, values: object}{base64}
playground
POST
/v1/doc/pdf
Fill DOCX template and convert to PDF
{base64: string, values: object, password?: string}{base64}
playground
HTM
HTML / MJML
2 endpoints
POST
/v1/html/pdf
Convert HTML to PDF
{body: base64, header?: base64, footer?: base64, options?: object, password?: string}{base64}
playground
POST
/v1/mjml/html
Compile MJML email markup to responsive HTML (XML string or JSON object)
{mjml?: string, object?: string}text/html
playground
FOP
FOP (XSL-FO)
1 endpoint
POST
/v1/fop/pdf
Generate PDF from XML data + XSL-FO template using Apache FOP
{base64Xml: string, base64XslFo: string}{base64}
playground
INV
ISDOC
2 endpoints
POST
/v1/isdoc/export
Attach ISDOC XML invoice to PDF
{base64: string, invoice: object}{base64}
playground
POST
/v1/isdoc/extract
Extract ISDOC invoice from PDF/ISDOCX/ISDOC
{filename: string, base64: string}object
playground
PDF
PDF
10 endpoints
POST
/v1/pdf/create
Create native PDF from pdfmake JSON definition
{json: object}base64
playground
POST
/v1/pdf/reduce
Reduce PDF file size
{base64: string}{base64}
playground
POST
/v1/pdf/qr
Read QR codes from PDF pages
{base64: string}[{page, qr_codes, base64}]
playground
POST
/v1/pdf/barcodes
Read barcodes from PDF pages
{base64: string}[{page, barcodes, buffer}]
playground
POST
/v1/pdf/extract
Extract specific pages from PDF
{base64: string, pages: number[][]}string[]
playground
POST
/v1/pdf/combine
Combine multiple PDFs into one
{buffers: string[]}{base64}
playground
POST
/v1/pdf/password/remove
Remove PDF password
{base64: string, password: string}{base64}
playground
POST
/v1/pdf/password/add
Add password to PDF
{base64: string, password: string, old_password?: string}{base64}
playground
POST
/v1/pdf/images
Convert PDF pages to JPEG images (auto DPI, each under 200KB)
{base64: string}{images: base64[]}
playground
POST
/v1/pdf/fill
Fill PDF form fields
{base64: string, values: object, password?: string}{base64}
playground
PHD
Pohoda
11 endpoints
POST
/v1/pohoda/invoice/amazon
Convert Amazon transaction CSV to POHODA XML invoices (OSS/VAT/export classification)
{base64: string, ico: string, company: string, series: string, series_oss: string, last_number?: int, last_number_oss?: int}{xml, count, warnings}
playground
POST
/v1/pohoda/invoice/mrp
Convert MRP K/S XML invoices to POHODA XML format
{base64: string, ico: string, company: string}{xml, count, warnings}
playground
POST
/v1/pohoda/invoice/money_s3
Convert MoneyS3 XML invoices to POHODA XML format (auto-detect issued/received)
{base64: string, type?: "auto"|"issued"|"received"}{xml, count, type, invoices, warnings}
playground
POST
/v1/pohoda/invoice
Upload any file, extract invoice data, generate Pohoda XML
{key: string, ico: string, files: [{base64: string}], prompt?: string}{xml, warnings, extracted}
playground
POST
/v1/pohoda/bank
Upload any file, extract bank data, generate Pohoda XML
{key: string, ico: string, files: [{base64: string}], prompt?: string}{xml, warnings, extracted}
playground
POST
/v1/pohoda/internal
Upload any file, extract internal document data, generate Pohoda XML
{key: string, ico: string, files: [{base64: string}], prompt?: string}{xml, warnings, extracted}
playground
POST
/v1/pohoda/cash
Upload any file, extract cash register data, generate Pohoda XML
{key: string, ico: string, files: [{base64: string}], prompt?: string}{xml, warnings, extracted}
playground
POST
/v1/pohoda/absence
Upload any file, extract absence/leave data, generate Pohoda XML
{key: string, ico: string, files: [{base64: string}], prompt?: string}{xml, warnings, extracted}
playground
POST
/v1/pohoda/wages
Upload any file, extract wage element data, generate Pohoda XML
{key: string, ico: string, files: [{base64: string}], prompt?: string}{xml, warnings, extracted}
playground
POST
/v1/pohoda/workload
Upload any file, extract work schedule data, generate Pohoda XML
{key: string, ico: string, files: [{base64: string}], prompt?: string}{xml, warnings, extracted}
playground
POST
/v1/pohoda/employees
Upload any file, extract employee absence/wages/workload data, generate unified Pohoda XML
{key: string, ico: string, files: [{base64: string}], prompt?: string}{xml, warnings, extracted}
playground
PEP
Peppol BIS 3.0
3 endpoints
POST
/v1/pohoda/peppol
Convert a single POHODA XML invoice to Peppol BIS 3.0 UBL 2.1 XML
{base64: string, currency?: string, supplier_name?: string, supplier_ico?: string, supplier_dic?: string, supplier_street?: string, supplier_city?: string, supplier_zip?: string, supplier_country?: string, supplier_iban?: string, supplier_bic?: string, supplier_email?: string, supplier_phone?: string, customer_reference?: string, customer_country?: string, wrap_sbdh?: bool}{base64: xml, warnings, output_warnings, schematron_warnings}
playground
POST
/v1/peppol/pohoda
Convert Peppol BIS 3.0 UBL 2.1 Invoice/CreditNote XML to POHODA XML (dataPack)
{base64: string, ico?: string, invoice_type?: "issuedInvoice"|"receivedInvoice"}{base64, count, warnings, output_warnings}
playground
POST
/v1/peppol/validate
Validate Peppol BIS 3.0 UBL XML against XSD + Schematron (CEN EN16931 + PEPPOL EN16931)
{base64: string}{valid: bool, xsd_errors, schematron_errors, schematron_warnings}
playground
WS
WebSocket
1 endpoint
WS
/ws
Persistent WebSocket connection — all REST endpoints available via request/response messages with ID correlation. Server pings every 27s; see docs.md for protocol details.
{id: string, endpoint: string, method: GET|POST, query?: object, params?: object}{id: string, status: number, content_type: string, data: any, error: string|null}
example payload
{"id":"tax-1","endpoint":"/v1/tax","method":"GET","query":{"cin":"53887557"}}
{"id":"tax-1","status":200,"content_type":"application/json","data":[...],"error":null}