Developer API

const form = new FormData();
form.append('file', fileInput.files[0]);
form.append('output_format', 'pdf');

const response = await fetch('https://filum.se/api/v1/convert', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
  },
  body: form,
});

const result = await response.json();

if (result.success) {
  const { download_url, expires_at } = result.data;
  // download_url is a signed URL valid until expires_at
  window.location.assign(download_url);
} else {
  throw new Error(result.error.human_readable_message);
}

import requests

with open('document.docx', 'rb') as f:
    response = requests.post(
        'https://filum.se/api/v1/convert',
        headers={'Authorization': 'Bearer YOUR_API_KEY'},
        files={'file': ('document.docx', f, 'application/octet-stream')},
        data={'output_format': 'pdf'},
    )

result = response.json()

if result['success']:
    print('Download:', result['data']['download_url'])
    print('Expires:', result['data']['expires_at'])
else:
    print('Error:', result['error']['human_readable_message'])

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL            => 'https://filum.se/api/v1/convert',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS     => [
        'file'          => new CURLFile('/path/to/document.docx'),
        'output_format' => 'pdf',
    ],
]);

$response = curl_exec($curl);
curl_close($curl);

$result = json_decode($response, true);

if ($result['success']) {
    echo 'Download: ' . $result['data']['download_url'];
} else {
    echo 'Error: ' . $result['error']['human_readable_message'];
}

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"mime/multipart"
	"net/http"
	"os"
	"path/filepath"
)

func main() {
	f, err := os.Open("document.docx")
	if err != nil {
		panic(err)
	}
	defer f.Close()

	var body bytes.Buffer
	w := multipart.NewWriter(&body)
	fw, _ := w.CreateFormFile("file", filepath.Base(f.Name()))
	io.Copy(fw, f)
	w.WriteField("output_format", "pdf")
	w.Close()

	req, _ := http.NewRequest("POST", "https://filum.se/api/v1/convert", &body)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", w.FormDataContentType())

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var result map[string]any
	json.NewDecoder(resp.Body).Decode(&result)

	if result["success"] == true {
		data := result["data"].(map[string]any)
		fmt.Printf("Download: %s\n", data["download_url"])
	}
}

curl -X POST https://filum.se/api/v1/convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@document.docx" \
  -F "output_format=pdf"

Convert a file to another format. Returns the converted file with metadata headers. All request fields are sent as multipart/form-data.

Request fields

Response headers