Documentation

Getting started

PolyQuote is a simple API for pricing 3D prints. You send the details of your print — filament type, weight, time — and you get back a recommended sale price that covers your material, electricity, and chosen markup. No spreadsheets, no guesswork.

You can be up and running in three steps:

1. Sign up. Head to api.polyformprints.co.uk and pick a plan. There's a free tier — no credit card needed.
2. Check your email. Your API key arrives instantly. It starts with pp_ followed by a string of letters and numbers.
3. Make your first request. See the quote endpoint below for a copy-paste example.

Authentication

Every request to the paid /quote endpoint must include your API key in a header called x-api-key. That's the only authentication step — no OAuth, no tokens to refresh.

x-api-key: pp_your_key_here

Keep your key private. Anyone who has it can spend your monthly call quota. Don't paste it into public chats, GitHub repos, or client-side JavaScript on a public website.

If you think your key has been exposed, email [email protected] and we'll rotate it for you straight away.

Endpoints

All requests go to this base URL:

https://3d-print-quote-api.polyform-api.workers.dev

The quote endpoint

POST /quote — requires authentication.

This is the main workhorse. Send your print details, get a price back.

Parameters

Example request

curl -X POST https://3d-print-quote-api.polyform-api.workers.dev/quote \
  -H "Content-Type: application/json" \
  -H "x-api-key: pp_your_key_here" \
  -d '{
    "filament_type": "PETG",
    "weight_grams": 85,
    "print_hours": 3.5,
    "markup_percent": 120,
    "quantity": 1,
    "printer_wattage": 200,
    "labour_cost_per_hour": 0,
    "shipping_cost": 2.85,
    "vat_percent": 0,
    "platform": "etsy"
  }'

Example response

{
  "input": {
    "filament_type": "PETG",           // The filament type you sent
    "weight_grams": 85,                 // The weight you sent
    "print_hours": 3.5,                 // The print time you sent
    "markup_percent": 120,              // The markup you sent
    "quantity": 1,                      // The quantity you sent
    "kwh_rate": 0.29,                   // Electricity rate used
    "filament_price_per_kg": 14,        // Filament price used (default or yours)
    "failure_rate_percent": 0,          // Failure rate buffer applied
    "packaging_cost": 0,                // Packaging cost per unit
    "printer_depreciation_per_hour": 0, // Depreciation cost per hour
    "printer_wattage": 200,             // Printer power consumption in watts
    "labour_cost_per_hour": 0,          // Hourly labour rate
    "shipping_cost": 2.85,              // Flat shipping cost per unit
    "vat_percent": 0,                   // VAT percentage applied
    "platform": "etsy"                  // Platform selected
  },
  "costs": {
    "material_cost_gbp": 1.19,         // Filament cost for this print
    "electricity_cost_gbp": 0.20,      // Electricity cost for this print
    "packaging_cost_gbp": 0,           // Packaging cost
    "depreciation_cost_gbp": 0,        // Printer wear cost for this print
    "labour_cost_gbp": 0,              // Labour cost (print_hours x rate)
    "total_base_cost_gbp": 1.39,       // Total before markup
    "shipping_cost_gbp": 2.85,         // Shipping (added after markup)
    "vat_gbp": 0                       // VAT amount applied
  },
  "recommended_price": {
    "GBP": 5.91,                       // Recommended sale price in GBP
    "USD": 7.51,                       // Approximate USD equivalent
    "EUR": 6.91                        // Approximate EUR equivalent
  },
  "currency": "GBP",
  "platform_fees": {
    "platform": "etsy",
    "transaction_fee_gbp": 0.38,       // Etsy 6.5% transaction fee
    "listing_fee_gbp": 0.16,           // Etsy listing fee ($0.20, live FX rate)
    "payment_processing_gbp": 0.44,    // Etsy 4% + £0.20 payment processing
    "regulatory_fee_gbp": 0.10,
    "total_platform_fees_gbp": 1.08    // Total fees on this sale
  },
  "calls_remaining": 4999              // Calls left in your monthly quota
}

The demo endpoint

POST /demo/quote — no authentication needed.

The demo endpoint accepts exactly the same parameters as the quote endpoint and runs exactly the same pricing calculation. It's the easiest way to kick the tyres before signing up — or to embed a live calculator on your own site.

Limits

The demo is capped at 5 requests per IP address per hour. When you hit the limit you'll get a 429 response with a friendly message and a sign-up link.

How the response differs

Two extra fields, and one missing field:

• "demo": true — confirms this came from the demo endpoint
• "demo_requests_remaining" — how many demo calls you have left this hour
• No calls_remaining — that's for paying customers
• A "cta" field nudges you toward signing up for a real key

Example response

{
  "input": { /* same as /quote */ },
  "costs": { /* same as /quote */ },
  "recommended_price": {
    "GBP": 3.43,
    "USD": 4.36,
    "EUR": 4.01
  },
  "recommended_price_gbp": 3.43,
  "currency": "GBP",
  "demo": true,
  "demo_requests_remaining": 4,
  "cta": "Want unlimited quotes? Sign up free at https://api.polyformprints.co.uk"
}

CSV endpoint (Google Sheets)

GET /demo/quote/csv — no authentication needed.

Returns a two-row CSV (headers + values) designed for use with Google Sheets' IMPORTDATA function. Same demo rate limit as the POST endpoint: 5 requests per IP per hour.

All parameters are passed as query string values rather than a JSON body.

Parameters

Accepts the same parameters as the quote endpoint, passed as query parameters: filament_type, weight_grams, print_hours, markup_percent, failure_rate_percent, packaging_cost, printer_depreciation_per_hour, printer_wattage, labour_cost_per_hour, shipping_cost, vat_percent.

Example URL

https://3d-print-quote-api.polyform-api.workers.dev/demo/quote/csv?filament_type=PETG&weight_grams=85&print_hours=3.5&markup_percent=120

Google Sheets formula

=IMPORTDATA("https://3d-print-quote-api.polyform-api.workers.dev/demo/quote/csv?filament_type=PETG&weight_grams=85&print_hours=3.5&markup_percent=120")

Returns headers in row 1 and values in row 2. You can make the formula dynamic by referencing cell values instead of hardcoded parameters.

CSV columns

filament_type, weight_grams, print_hours, markup_percent, material_cost_gbp, electricity_cost_gbp, packaging_cost_gbp, depreciation_cost_gbp, labour_cost_gbp, shipping_cost_gbp, vat_gbp, total_base_cost_gbp, recommended_price_gbp, demo_requests_remaining

Error codes

Errors always come back as JSON with an error field describing what went wrong.

Pricing & limits

Your call limit resets on the same date each month as your subscription start date — so a plan started on the 13th resets on the 13th every month.

Sign up or change plan ->
Manage your subscription (Stripe portal) -> Try the API in Postman ->