REST API · MCP

Your workflow. Real paper.

Use REST for your software or MCP for your assistant. Both share your credit, prices and access limits.

Access & payment

Send your personal access key as Authorization: Bearer. Validity, revocation and order/daily spending limits also apply to REST. Top up in your account or request a checkout link after confirming the preview and price.

https://die-internetausdrucker.de/v1

Price estimate without uploading

Already know the print page count? Get a price immediately, including postage and VAT. Supply the complete page count including the address sheet (one page for simplex, two for duplex). The prepared document receives its final quote afterwards.

curl -X POST https://die-internetausdrucker.de/v1/price \
  -H 'Authorization: Bearer YOUR_ACCESS_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"letter":{"specification":{"pages":402,"color":"1","mode":"duplex","shipping":"national"}}}'

Endpoints & workflow

Endpoint	Purpose
`GET /v1/balance`	Credit and limits
`GET/POST /v1/price`	Price estimate from page count
`POST /v1/uploads`	Prepare PDF/Office upload, then send file using PUT
`POST /v1/printjobs`	Submit base64 PDF as a draft for preparation
`GET /v1/printjobs`	List own documents; 50 per page
`GET /v1/printjobs/{id}`	Preparation and order status
`POST /v1/printjobs/{id}/delivery`	Add delivery address and receive a new document ID
`GET/POST /v1/printjobs/{id}/quote`	Get the final prepared document quote
`POST /v1/printjobs/{id}/submit`	Explicitly confirm PDF hash and price; order using credit or checkout

Compatibility & limits

The balance, price and printjobs endpoints use a familiar letter/specification structure. This is a documented subset with an explicit preview and confirmation step, not a drop-in replacement for every provider option. IDs are strings. National A4 printing, black/white or colour, simplex/duplex and automatic envelope/parcel selection are supported. Registered mail, international shipping, scheduled dispatch, forced C4, serial letters, backgrounds, attachments, bank forms and cancellation are currently rejected rather than silently ignored.

Default mode is test: no paid orders. Submission requires auth.mode=live, quote_id, preview_confirmed=true, confirmed_pdf_sha256, confirmed_amount_cents, idempotency_key and payment (wallet or checkout), plus an enabled live shop. Uploads up to 100 MiB; base64 and final print PDF up to 50 MB. Up to 120 requests/minute per access key; combined MCP action limits also apply.

Alternatively use auth.apiKey = SHA-256 hex digest of your access key and auth.apiSecret = the access key. Never send credentials in a URL.