Partner API

Authentication

Requests must include header X-Printables-Key (or Authorization: Bearer …). Issue keys with php artisan printables:api-key.

Start with GET /api/v1/services to discover process codes and floors, then post quotes.

Endpoints

• GET /api/v1/services — active processes + rate floors JSON
• POST /api/v1/quotes — create a quote (same payload as the storefront form) JSON
• POST /api/v1/quotes/volume-ladder — unit costs across quantities JSON

Create quote example

POST https://printables.com.au/api/v1/quotes
Content-Type: application/json
X-Printables-Key: your-key

{
  "service": "fdm",
  "quantity": 2,
  "options": {
    "filament_sku": "PLA-BLK",
    "layer_height": 0.2,
    "infill": 0.2
  }
}

Multipart uploads use the same field names as the storefront (file + options). Response includes uuid, totals in cents, and a shareable quote URL.

Volume ladder example

POST https://printables.com.au/api/v1/quotes/volume-ladder
Content-Type: application/json

{
  "service": "vinyl_print",
  "options": {
    "width_m": 1.2,
    "length_m": 2,
    "material_code": "VINYL-CAST-GLOSS",
    "laminate": true
  },
  "quantities": [1, 10, 25, 50, 100]
}

Response includes a ladder array with descending unit costs and lead-time labels. Quotes created via API are normal Quote rows — share, PDF, checkout and portals work the same as the website.

Try it

From a shell with a key:

curl -sS "https://printables.com.au/api/v1/services" \
  -H "Accept: application/json" \
  -H "X-Printables-Key: $PRINTABLES_API_KEY"