POLYFORM PRINTS

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
  }'

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 (default or yours)
  },
  "costs": {
    "material_cost_gbp": 1.36,     // Filament cost for this print
    "electricity_cost_gbp": 0.20,  // Electricity cost for this print
    "total_base_cost_gbp": 1.56    // Material + electricity, before markup
  },
  "recommended_price_gbp": 3.43,   // Your suggested sale price
  "currency": "GBP",                // Always GBP for now
  "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,
  "currency": "GBP",
  "demo": true,
  "demo_requests_remaining": 4,
  "cta": "Want unlimited quotes? Sign up free at https://api.polyformprints.co.uk"
}

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) →