Letter API documentation (REST, v1)

curl -X POST https://www.briefsenden.com/api/v1/letters/simple \
  -H "X-Api-Key: bv_test_xxx" \
  -F "file=@invoice.pdf" \
  -F "recipientLine1=Max Mustermann" \
  -F "recipientLine2=Musterstraße 1" \
  -F "recipientZip=12345" \
  -F "recipientCity=Berlin" \
  -F "color=bw" \
  -F "duplex=simplex"

import requests

url = "https://www.briefsenden.com/api/v1/letters/simple"
headers = {"X-Api-Key": "bv_test_xxx"}

files = {"file": open("invoice.pdf", "rb")}
data = {
    "recipientLine1": "Max Mustermann",
    "recipientLine2": "Musterstraße 1",
    "recipientZip": "12345",
    "recipientCity": "Berlin",
    "color": "bw",
    "duplex": "simplex",
}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())

// Node.js 18+, as an ES module (e.g. letter.mjs) – fetch, FormData and Blob are built in
import fs from "node:fs";

const form = new FormData();
form.append("file", new Blob([fs.readFileSync("invoice.pdf")], { type: "application/pdf" }), "invoice.pdf");
form.append("recipientLine1", "Max Mustermann");
form.append("recipientLine2", "Musterstraße 1");
form.append("recipientZip", "12345");
form.append("recipientCity", "Berlin");
form.append("color", "bw");
form.append("duplex", "simplex");

const response = await fetch("https://www.briefsenden.com/api/v1/letters/simple", {
  method: "POST",
  headers: { "X-Api-Key": "bv_test_xxx" },
  body: form,
});
console.log(await response.json());

$ch = curl_init("https://www.briefsenden.com/api/v1/letters/simple");

$postFields = [
    "file"           => new CURLFile("invoice.pdf", "application/pdf"),
    "recipientLine1" => "Max Mustermann",
    "recipientLine2" => "Musterstraße 1",
    "recipientZip"   => "12345",
    "recipientCity"  => "Berlin",
    "color"          => "bw",
    "duplex"         => "simplex",
];

curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $postFields,
    CURLOPT_HTTPHEADER     => ["X-Api-Key: bv_test_xxx"],
    CURLOPT_RETURNTRANSFER => true,
]);

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

echo $response;