Professional 3D Printing Service

Turn your
ideas into objects.

Upload your STL, OBJ, or 3MF, get an instant quote in seconds, and receive your part — shipped or ready for pickup.

Upload & Quote → Track Order

⚡Instant quoting

📦Standard & Express

🏭PLA · ABS · PETG · Resin

💳UPI · Instant payment

Sort by:

⏳

Loading catalog…

Available Materials

Loading materials…

Upload & Quote

Drop your 3D model file and we'll analyse dimensions and volume in your browser — instantly.

☁️

Drag & drop your 3D model here

.STL .OBJ .3MF

or browse files · max 50 MB

Checkout

Review your order, fill in details, and pay via UPI.

Order Summary

Checkout

Review your cart, fill in details, and pay via UPI.

Order Summary

Track Your Order

Enter your Order ID or tracking number to see live status.

📦

Loading model…

◈ About Us

Affordable 3D Printing
for Everyone

Born from a passion for making — built to bring professional 3D printing within reach of students, creators, and everyday people.

500+

Orders Delivered

20+

Materials & Finishes

3–5 Days

Average Delivery

100%

Transparent Pricing

Our Story

Why We Built PrintForge Studio

3D printing has long been a technology reserved for large companies and well-funded labs. We believe that shouldn't be the case. PrintForge Studio was built to bridge that gap — giving students, small businesses, and everyday people access to professional-grade 3D printing without needing to own an expensive machine or understand complex software.

◈

Our Mission

To make professional 3D printing as simple as uploading a file — affordable, fast, and available to everyone across India.

Who We Serve

3D Printing for Every Need

🎓

Students & Makers

Bring your project ideas to life without expensive equipment. Prototypes, models, science projects — print exactly what you need, one piece at a time.

🎁

Personalised Gifting

Create one-of-a-kind gifts that no shop can offer. Custom figurines, name plates, keepsakes — printed with precision and delivered to your door.

🔧

Repair & Replace

Stop throwing things away when a part breaks. We can print replacement clips, brackets, knobs, and fittings that are no longer available anywhere.

Why 3D Printing?

Traditional manufacturing requires thousands of units to be cost-effective. 3D printing makes every single print cost-effective — no tooling, no minimums, no waste.

No Minimums

Order even 1 piece

Any Shape

Geometry with no limits

Fast Turnaround

Ready in days, not weeks

Ready to print something amazing?

Upload your file, get an instant quote, and we'll handle the rest.

Start Your Print →

Support Centre

Contact & Support

Have a question about your order, a print, or anything else? We're here to help — typically within 1 business day.

Send us a message

We'll get back to you as soon as possible.

Start Your Print →

PrintForge Admin

Management

Dashboard

Loading stats…

Recent Orders

Loading…

Orders

Loading orders…

Print Config

Printer Types

Loading printers…

🖨️

Print Config Guide

This section controls everything about your printing infrastructure — which printers you have, what materials they support, and how incoming orders are automatically routed. All settings here directly affect order pricing, compatibility checks, and the smart printer assignment algorithm.

🔄 How an Order Flows

Customer uploads STL / selects catalog model

File is parsed for dimensions (X × Y × Z mm) and volume (cm³). Both values drive compatibility checks and pricing.

Compatibility check against all active printers

The system checks that at least one printer supports the selected material AND the model fits within its build volume. Orders for incompatible combinations are blocked before checkout.

Instant price quote generated

Cost = material weight × cost/kg + electricity (wattage × print time) + base service fee + overhead + margin + optional priority/express surcharges + GST. Configure rates in Cost Engine.

Smart printer assignment at checkout

The algorithm scores all eligible printers and picks the best one. See the Smart Assignment section below for scoring details.

Admin reviews, prints, and ships

Order status advances through: pending → confirmed → printing → post_processing → shipped → delivered. The assigned printer is shown in the order detail and can be changed at any time.

✓

Customer receives tracking & delivery confirmation

Email notifications sent at each key stage. Tracking number and UPI payment QR delivered automatically.

🖨️ Printer Setup — Field Reference

Field	What it does
Name / Brand	Displayed on the order detail badge and in the picker. Use a recognisable label, e.g. Bambu X1C — Studio 1.
Supported Materials	Comma-separated material names (e.g. `PLA,PETG,ABS`). Orders for materials not in this list are rejected for this printer. Must match names defined in Material Types.
Bed X / Y / Z (mm)	Maximum build volume. An order whose model dimensions exceed any axis is automatically excluded from this printer during assignment. Leave at 0 to skip that axis check.
Nozzle (mm)	Informational only — displayed in the printer list. Common values: 0.4 mm (standard), 0.6 mm (fast/draft), 0.2 mm (fine detail).
Printer Power (W)	Average power draw in Watts. Used in the electricity cost formula: `cost = (wattage / 1000) × print_hours × electricity_rate`. Also feeds the wattage efficiency scoring in assignment (lower watt = greener = small bonus).
Print Speed (cm³/hr)	Volumetric flow rate. Used to estimate print time: `hours = volume_cm3 / print_speed`. Higher speed = shorter estimated time = lower electricity cost in quote.
Printer Pincode	6-digit Indian PIN code for this printer's physical location. The smart assignment algorithm uses this to score proximity to the customer's delivery PIN. Printers closer to the customer score higher.
Printer Address	Human-readable street/studio address. Shown on the order detail for the admin's reference. Not shared with customers.
Active toggle	Inactive printers are completely excluded from all assignment, compatibility checks, and API responses. Use this to temporarily take a printer offline without deleting its configuration.

🧮 Smart Printer Assignment Algorithm

Every incoming order automatically scores all active printers and selects the highest-scoring eligible printer. You can always override the assignment from the order detail page.

Hard Filters (must pass — no score)

Printer is active
Printer's material list includes the ordered material
Model fits within all three bed dimensions (X, Y, Z)

Printers that fail any hard filter are excluded entirely and shown in red in the picker.

Scoring (100 pts total)

📍 PIN Proximity0–50 pts
⚖️ Load Balance0–30 pts
⚡ Wattage Efficiency0–20 pts

Tie-break: fewest active jobs wins.

📍 PIN Proximity Scoring (0–50 pts)

Compares the printer's PIN code against the customer's delivery PIN. Indian 6-digit PINs encode geography in their prefix digits.

Match level	Example	Score
Exact same PIN	712136 = 712136	50
Same sub-district (4-digit prefix)	7121xx = 7121xx	40
Same district (3-digit prefix)	712xxx = 712xxx	30
Same postal circle (2-digit prefix)	71xxxx = 71xxxx	15
Same zone (1-digit prefix)	7xxxxx = 7xxxxx	5
No match / PIN missing	—	0

⚖️ Load Balance Scoring (0–30 pts)

Score = max(0, 30 − active_jobs × 5). A printer with 0 active jobs scores 30. At 6+ active jobs the score floors at 0. "Active jobs" = orders in pending, confirmed, printing, or post_processing status assigned to this printer.

⚡ Wattage Efficiency Scoring (0–20 pts)

Score = max(0, 20 − floor((wattage − 150) / 25)). A 150 W printer scores 20; a 350 W printer scores 12; a 650 W+ printer scores 0. This gently favours more energy-efficient hardware when all else is equal.

🧪 Materials Guide

Add all materials your studio supports in the Material Types tab. Each material needs a name (all-caps, e.g. PLA), density, cost per kg, and available colours. These values are used directly in price calculations.

Material	Best for	Density (g/cm³)	Temp (°C)	Notes
PLA	Prototypes, decorative, low-stress parts	1.24	190–220	Easiest to print. Biodegradable. Not heat-resistant (>60 °C deforms). Low warp — no enclosure needed.
ABS	Functional parts, snap-fits, engineering	1.04	220–250	Heat-resistant (~100 °C). Strong and machinable. High warp — needs heated bed + enclosure. Fumes require ventilation.
PETG	Food-safe containers, outdoor, functional	1.27	230–250	Great balance of strength and ease. Water-resistant. Slight stringing. Heat-resistant up to ~80 °C.
RESIN	High-detail miniatures, jewellery, dental	1.10–1.20	—	SLA/MSLA printing. Extremely high resolution. Requires post-cure UV lamp. Brittle; not for structural use. PPE required.
TPU	Flexible parts, gaskets, phone cases	1.20	220–240	Rubber-like flexibility. Excellent impact absorption. Needs direct-drive extruder. Slow print speeds recommended.
NYLON	Gears, hinges, load-bearing parts	1.14	240–270	High strength, wear-resistant, self-lubricating. Hygroscopic — must be kept dry. Needs enclosure.
ASA	Outdoor signage, automotive, UV-stable	1.07	240–260	UV and weather-resistant ABS alternative. Similar print settings to ABS. Better colour stability outdoors.

* Densities and temperatures are typical ranges. Your material supplier's spec sheet takes precedence. Use the correct density in Material Types to ensure accurate weight and cost calculations.

🔳 Infill Percentage Guide

Infill is the internal structure density of a print. Higher infill = more material + more time = higher cost. Customers select infill during checkout. Volume billed is adjusted by infill fraction.

5–15%

Draft / Display

Hollow feel. Great for figurines, vases, art. Fast & cheap.

20–30%

Standard

Good balance. Suitable for most non-structural consumer parts.

40–60%

Functional

Noticeably heavier & stronger. Enclosures, brackets, tool holders.

80–100%

Engineering

Near-solid. Maximum strength. Gears, load-bearing parts. High cost.

🚀 Fulfillment Modes

📦Standard (ship)

Default mode. Order is printed and shipped to the customer's address via India Post. Shipping cost is calculated by weight and pincodes using Regular Post or Speed Post rates.

⚡Express+surcharge

Jump-the-queue print service. An express surcharge (configured in Cost Engine) is added on top of the standard quote. Useful for deadline-sensitive orders.

🏪Pickup

Customer collects from your studio. No shipping cost is charged. The delivery PIN field at checkout is hidden. You still need to confirm the order and mark it as shipped/delivered when picked up.

🔴Priority Print+surcharge

Customer's order is printed before all non-priority jobs regardless of queue position. A priority surcharge (set in Cost Engine) is added. Can be combined with any fulfillment mode.

Catalog Models

Loading catalog…

Cost Engine

🧪 Material Types

Define materials and their physical properties and cost. Colors are configured per-printer in Print Config.

Loading materials…

⚙️ Equipment

Electricity cost settings

Electricity Rate (INR/kWh)

Printer Power and Print Speed are configured per-printer in the Printers section.

💼 Business

Fees, overhead, and margins

Base Setup Fee (INR)

Overhead (%)

Margin (%)

⚡ Priority Print Surcharge (%)

GST Rate (%)

👁 Customer-facing Display

Electricity, setup fee, overhead & margin are hidden from customers and consolidated into two visible line items.

Printing Cost Split (%)

This percentage of the hidden costs shows as Printing cost; the remainder adds to Material cost. Default: 60.

How it works (example at 60 %):

Material cost (actual)₹10

Hidden costs (elec + setup + overhead + margin)₹40

→ Customer sees "Material cost"₹26 (10 + 40×40%)

→ Customer sees "Printing cost"₹24 (40×60%)

Default Preview Color

The color used for the 3D model preview before a customer picks a color. Also the default selection in the quote form.

📐 Pricing Formula

Each order price is computed bottom-up: material weight → electricity consumption → overhead → margin → optional priority surcharge → GST. Shipping is added separately and is never taxed here.

/* effective volume accounts for shell (always solid) + infill portion */

eff_vol = vol × (infill/100 × 0.7 + 0.3)

weight_kg = eff_vol × density / 1000

material_cost = weight_kg × mat_kg_price

/* print speed is cm³/hr at 20% infill; scales linearly with infill */

print_time_hrs = (vol / print_speed) × (infill / 20)

elec_cost = (printer_w / 1000) × print_time_hrs × elec_kwh

base = material_cost + elec_cost + base_fee

with_overhead = base × (1 + overhead_pct / 100)

unit_price = ceil(with_overhead × (1 + margin_pct / 100))

/* priority surcharge applied per unit, before GST */

priority_surcharge = priority ? ceil(unit_price × priority_pct / 100) : 0

print_subtotal = (unit_price + priority_surcharge) × quantity

gst_amount = print_subtotal × gst_rate / 100

grand_total = print_subtotal + gst_amount + shipping_cost

Shipping

Shipping Partners

Speed Post Rates

GST applied per row · click Save to update

Zone	Label	≤50g (₹)	≤200g (₹)	≤500g (₹)	+500g (₹)	GST %

Regular Post Rates

GST applied per row · click Save to update

Zone	Label	≤50g (₹)	≤200g (₹)	≤500g (₹)	+500g (₹)	GST %

PIN Prefix Database

Prefix	State / Region	Latitude	Longitude	Zone

Users

Loading users...

Store Profile

Contact Details

Phone

Business Hours

Address

Street Address

City

State

Pincode

Country

Legal & Registration

GST Number

CIN / Registration No.

Social Media Links

Facebook

Instagram

Twitter / X

YouTube

Hero Section

Headline

Tagline

Stats Strip

Story & Mission

Our Story

Mission Statement

Who We Serve Cards

🎓 Students & Makers

🎁 Personalised Gifting

🔧 Repair & Replace

Create discount codes, schedule promos, and configure the homepage popup announcement.

Loading coupons…

Rate Limiter

Control how many requests each IP can make per window. Changes take effect immediately without restarting the server.

🌐

General API Limiter

Applied to all /api/* routes except auth and upload endpoints.

Window (minutes)

Max Requests per Window

📁

Upload / Checkout Limiter

Applied to POST /api/checkout (file upload + order placement).

Window (minutes)

Max Uploads per Window

🛡️

Bypass Roles

Users with these roles are exempt from general and upload rate limits. Auth endpoints are never bypassed.

admin moderator customer

⚠️

The auth limiter (login / register / password reset) is always enforced regardless of bypass role, to prevent credential stuffing attacks.

API Reference

Complete reference for all PrintForge API endpoints. Base URL: /api. All responses are JSON. Rate limits apply per IP.

🔑 Authentication & Token Types

JWT Session Token

Returned by /api/auth/login. Valid 8 hours. Required for admin UI and user actions. Cannot be used in PAT-only endpoints.

Interim Token (2FA)

Short-lived token issued when 2FA is enabled. Valid 10 minutes. Exchange it with /api/auth/login-2fa to get a full JWT.

Personal Access Token (PAT)

Long-lived scoped tokens prefixed with pf_. Created in Admin → API Tokens. For server-to-server integrations.

Send any token type as a Bearer header on every protected request:

Authorization: Bearer <token>

🌐 Public Endpoints no auth required

These endpoints are open to all clients. Rate limits still apply per IP.

Method	Path	Description
GET	/api/health	Server health check. Returns `{"status":"ok"}`.
GET	/api/public/site-info	Shop name, logo, currency, social links, UPI details — used to brand the storefront.
GET	/api/public/about-info	About page settings (enabled cards, stats, content text).
GET	/api/catalog	Paginated public approved models. Query: `page, limit, category_id, q, sort`
GET	/api/catalog/:id	Single public model detail.
GET	/api/categories	All product categories.
GET	/api/materials	Active materials with display name, colors, density.
GET	/api/printer-types	Active printer specs (bed size, materials, nozzle) for compatibility display.
GET	/api/pincodes	PIN code zone/district lookup for shipping estimation.
GET	/api/models/:id/file	Stream raw STL/model file for 3D viewer. Rate-limited (30/15 min).
POST	/api/quote	Instant price estimate. Body: `dim_x_mm, dim_y_mm, dim_z_mm, volume_cm3, material, quantity, fulfillment, infill, color, priority_print, shipping_method, shipping_zip`. Rate-limited (20/15 min).
GET	/api/track/:trackingNo	Public order tracking by tracking number. No auth needed.
GET	/sitemap.xml	Dynamic XML sitemap (all public catalog items).
GET	/robots.txt	Crawler directives. Configurable via Admin → Site Settings → SEO.

👤 Auth Endpoints rate-limited on all POST

Registration, login, password reset, email verification, and 2FA management. Auth endpoints bypass the general rate limiter but have their own stricter limit.

Method	Path	Description
POST	/api/auth/register	Create account. Body: `username, email, password`. Sends verification email.
POST	/api/auth/login	Body: `email, password`. Returns `token` (JWT) or `interim_token` if 2FA is active.
POST	/api/auth/login-2fa	Complete 2FA step. Body: `interim_token, code` (TOTP). Returns full JWT.
GET	/api/auth/me	Current user profile. Requires auth.
GET	/api/auth/verify-email/:token	Verify email address using token from registration email.
POST	/api/auth/resend-verify	Re-send verification email. Requires auth.
POST	/api/auth/forgot-password	Send password reset email. Body: `email`.
POST	/api/auth/reset-password	Set new password. Body: `token, new_password`.
GET	/api/auth/setup-2fa	Generate TOTP secret & QR code for 2FA enrollment. Requires auth.
POST	/api/auth/enable-2fa	Confirm and activate 2FA. Body: `secret, code`. Requires auth.
DELETE	/api/auth/disable-2fa	Turn off 2FA. Body: `code` (current TOTP). Requires auth.

📤 Upload & Checkout auth required · upload rate-limited

All upload and checkout endpoints accept multipart/form-data. Max file size is configured via MAX_FILE_SIZE_MB env var (default 50 MB). Accepted formats: .stl, .obj, .3mf.

Method	Path	Description
POST	/api/upload-for-cart	Upload an STL/OBJ/3MF and get back parsed dimensions, volume, and a `session_id`. Used before adding to cart. Field: `model_file`.
POST	/api/checkout	Single-item order. Multipart fields: `model_file` or `catalog_model_id`, `material`, `color`, `quantity`, `infill`, `fulfillment`, `priority_print`, `shipping_*`, `notes`.
POST	/api/cart-checkout	Multi-item group order. JSON body: `items[]` (each with `session_id` or `catalog_model_id`, material, color, qty, infill), plus shared `fulfillment`, `shipping_*`. Returns array of created orders with a shared `group_id`.
POST	/api/models/:id/image	Upload/replace preview image for a model you own. Field: `image` (JPEG/PNG/WebP).
POST	/api/catalog/:id/like	Toggle like/unlike on a catalog model. Returns `liked: bool, total_likes: int`.

🙋 User Endpoints /api/user/…

All routes require a valid JWT. Operate on the currently authenticated user only.

Method	Path	Description
GET	/api/user/profile	Full profile including email, role, 2FA status, addresses.
PATCH	/api/user/profile	Update display name or username. Body: `username`.
POST	/api/user/change-password	Body: `current_password, new_password`.
POST	/api/user/request-email-change	Send verification email for new address. Body: `new_email, password`.
GET	/api/user/orders	Paginated list of the user's own orders. Query: `page, limit, status`.
GET	/api/user/orders/:id	Single order detail with timeline. Scoped to the authenticated user.
GET	/api/user/orders/:id/invoice	Download PDF invoice for an order. Rate-limited.
GET	/api/user/orders/group/:id/invoice	Download combined group-order PDF invoice.
GET	/api/user/2fa-status	Returns `{"enabled": bool}`.
GET	/api/user/addresses	List saved delivery addresses.
POST	/api/user/addresses	Save a new address. Body: `label, name, address, city, state, zip, country`.
PUT	/api/user/addresses/:id	Replace an existing saved address.
DELETE	/api/user/addresses/:id	Remove a saved address.
PATCH	/api/user/addresses/:id/default	Set address as default for checkout autofill.

✉️ Contact Endpoints

Customer support inquiries. Submitting requires auth to prevent spam. Admins manage inquiries via /api/admin/contact.

Method	Path	Description
GET	/api/contact/verify-order/:tracking	Verify a tracking number belongs to the logged-in user before submitting an inquiry. Requires auth.
POST	/api/contact	Submit a support inquiry. Body: `subject, message, order_tracking?`. Requires auth. Rate-limited.

⚙️

Admin Endpoints — /api/admin/…

Require admin role (JWT) or a PAT with the matching scope. JWT-only endpoints are marked JWT only.

📊 Dashboard & Stats

Method	Path	Description
GET	/api/admin/stats	Revenue totals, order counts by status, recent activity. Scope: `admin:read`.
GET	/api/admin/cost-settings	Current pricing parameters (material costs, electricity rate, margins, GST). Scope: `admin:read`.
POST	/api/admin/price-preview	Dry-run price calculation with custom inputs. Body: `material, volume_cm3, quantity, infill, wattage_w, fulfillment, priority_print`. Scope: `admin:read`.

🛒 Orders

Method	Path	Description
GET	/api/admin/orders	All orders. Query: `page, limit, status, q, sort`. Scope: `orders:read`.
GET	/api/admin/orders/:id	Full order detail with customer, model, printer info. Scope: `orders:read`.
GET	/api/admin/orders/group/:group_id	All orders in a group (cart checkout). Scope: `orders:read`.
PATCH	/api/admin/orders/:id/status	Advance through FSM: `pending→confirmed→printing→post_processing→shipped→delivered`. Body: `status`. Scope: `orders:write`.
PATCH	/api/admin/orders/:id/tracking	Set carrier tracking. Body: `tracking_number, tracking_url?, shipping_id?`. Scope: `orders:write`.
PATCH	/api/admin/orders/:id/printer	Reassign printer. Body: `printer_id` (or `null` to unassign). Scope: `orders:write`.
PATCH	/api/admin/orders/:id/paid	Manually confirm payment and set status to `confirmed`. Scope: `payment:write`.
GET	/api/admin/orders/:id/eligible-printers	Ranked list of all printers with compatibility, proximity, and load scores. Scope: `orders:read`.
GET	/api/admin/orders/:id/notes	List internal + customer notes on an order. Scope: `orders:read`.
POST	/api/admin/orders/:id/notes	Add a note. Body: `note, is_internal`. Scope: `orders:write`.

📦 Catalog & Models

Method	Path	Description
GET	/api/admin/models	All models including unapproved. Query: `page, limit, q, status`. Scope: `catalog:read`.
PATCH	/api/admin/models/:id	Approve/unapprove or toggle public. Body: `is_approved?, is_public?`. Scope: `catalog:write`.
PATCH	/api/admin/models/:id/meta	Update SEO metadata. Body: `seo_title, seo_description, slug`. Scope: `catalog:write`.
PUT	/api/admin/models/:id	Full model update. Body: `name, category_id, material, color, price, notes`. Scope: `catalog:write`.
DELETE	/api/admin/models/:id	Delete model record and physical file. Scope: `catalog:write`.
POST	/api/admin/models/:id/image	Upload/replace preview image. Field: `image`. Scope: `catalog:write`.
DELETE	/api/admin/models/:id/image	Remove preview image. Scope: `catalog:write`.
GET	/api/admin/models/:id/download	Download raw model file (admin). Scope: `catalog:read`.
POST	/api/admin/catalog-models	Upload a new catalog model. Multipart: `model_file, name, category_id, material, color, price`. JWT only.

🖨️ Print Config — Printers, Materials & Categories

Method	Path	Description
GET	/api/admin/printer-types	All printers (active + inactive). Scope: `catalog:read`.
POST	/api/admin/printer-types	Add printer. Body: `name, brand, materials, bed_x_mm, bed_y_mm, bed_z_mm, nozzle_mm, wattage_w, print_speed_cm3_hr, printer_pincode, printer_address, notes`. JWT only.
PUT	/api/admin/printer-types/:id	Update printer settings or toggle active. JWT only.
DELETE	/api/admin/printer-types/:id	Delete printer. Fails if printer has assigned orders. JWT only.
GET	/api/admin/materials	All materials. Scope: `catalog:read`.
POST	/api/admin/materials	Add material. Body: `name, display_name, density_g_cm3, cost_per_kg, colors, notes`. JWT only.
PUT	/api/admin/materials/:id	Update material. JWT only.
DELETE	/api/admin/materials/:id	Delete material. JWT only.
GET	/api/admin/categories	All categories. Scope: `catalog:read`.
POST	/api/admin/categories	Create category. Body: `name, icon, description, display_order`. JWT only.
PUT	/api/admin/categories/:id	Update category. JWT only.
DELETE	/api/admin/categories/:id	Delete category (only if no models are assigned). JWT only.

🔧 Settings, Site Content & Rate Limiter

Method	Path	Description
GET	/api/admin/settings	All shop settings keyed by `key`. Scope: `admin:read`.
PUT	/api/admin/settings/:key	Update one setting. Body: `value`. JWT only.
GET	/api/admin/site-info	General + company + social settings combined. Scope: `admin:read`.
GET	/api/admin/about-info	About page settings. JWT only.
POST	/api/admin/about-info	Save about page settings (bulk key-value). JWT only.
GET	/api/admin/company-info	Company name, logo, address, UPI, social. Scope: `admin:read`.
POST	/api/admin/company-info	Update company info (bulk key-value). JWT only.
POST	/api/admin/test-email	Send a test email to the admin address to verify SMTP config. JWT only.
GET	/api/admin/rate-limiter	Current rate limit config. Scope: `admin:read`.
PUT	/api/admin/rate-limiter	Update limits live (no restart). Body: `general_window_min, general_max, upload_window_min, upload_max, bypass_roles[]`. JWT only.

👥 Users

Method	Path	Description
GET	/api/admin/users	Paginated user list. Query: `page, limit, q, role`. Scope: `admin:read`.
PATCH	/api/admin/users/:id	Change role (`user/moderator/admin`) or toggle active. Body: `role?, is_active?`. JWT only.
PATCH	/api/admin/users/:id/verify	Manually mark email as verified. JWT only.

🔐 API Tokens (PAT Management) All JWT only

Method	Path	Description
GET	/api/admin/tokens	List all PATs (token value never returned after creation).
POST	/api/admin/tokens	Create PAT. Body: `name, description, permissions[], expires_in_days`. Returns plaintext token once only.
PATCH	/api/admin/tokens/:id/revoke	Disable token (keeps record for audit).
DELETE	/api/admin/tokens/:id	Permanently delete token and its logs.
POST	/api/admin/tokens/bulk-revoke	Revoke multiple tokens. Body: `ids[]`.
POST	/api/admin/tokens/bulk-delete	Permanently delete multiple tokens. Body: `ids[]`.
GET	/api/admin/tokens/logs	All PAT access logs (last 500). Scope: `admin:read`.
GET	/api/admin/tokens/:id/logs	Logs for one token (last 200). Scope: `admin:read`.

📬 Contact Inquiries admin + moderator

Method	Path	Description
GET	/api/admin/contact	All inquiries. Query: `page, limit, status`.
GET	/api/admin/contact/:id	Single inquiry with message history.
POST	/api/admin/contact/:id/reply	Send reply email to customer. Body: `message`.
PATCH	/api/admin/contact/:id/status	Update status: `open, in_progress, resolved, closed`. Body: `status`.

🛡️ Moderator Endpoints /api/mod/…

Moderators have a subset of admin capabilities — order fulfilment and catalog moderation, but no access to settings, users, tokens, or cost engine. Require moderator or admin role JWT.

Method	Path	Description
GET	/api/mod/orders	All orders (same as admin). Query: `page, limit, status`.
GET	/api/mod/orders/:id	Full order detail.
GET	/api/mod/orders/group/:group_id	Group order list.
PATCH	/api/mod/orders/:id/status	Advance order status.
PATCH	/api/mod/orders/:id/tracking	Set tracking number.
PATCH	/api/mod/orders/:id/paid	Mark order as paid.
GET	/api/mod/orders/:id/notes	Order notes.
POST	/api/mod/orders/:id/notes	Add internal note.
GET	/api/mod/models	All models including unapproved.
PATCH	/api/mod/models/:id/meta	Update model metadata.
GET	/api/mod/models/:id/download	Download model file.
GET	/api/mod/categories	All categories.
GET	/api/mod/materials	All materials (read + write).
POST	/api/mod/materials	Add material.
PUT	/api/mod/materials/:id	Update material.
DELETE	/api/mod/materials/:id	Delete material.
GET	/api/mod/printer-types	Printer list (read + write).
POST	/api/mod/printer-types	Add printer.
PUT	/api/mod/printer-types/:id	Update printer.
DELETE	/api/mod/printer-types/:id	Delete printer.
GET	/api/mod/contact	Contact inquiries.
GET	/api/mod/contact/:id	Single inquiry.
POST	/api/mod/contact/:id/reply	Reply to inquiry.
PATCH	/api/mod/contact/:id/status	Update inquiry status.

🔐 PAT Scopes & Example Calls

Create PATs in Admin → API Tokens. Token prefix is pf_. Replace $PAT and https://your-domain.com in all examples below.

Scope	What it unlocks
orders:read	GET orders, order detail, group orders, order notes, eligible printers
orders:write	PATCH status, tracking, printer assignment, printer notes
payment:write	PATCH orders/:id/paid — mark payment confirmed
catalog:read	GET all models (including unapproved), printer-types, materials, categories, model download
catalog:write	PATCH/PUT/DELETE models, approve/reject, model images, meta updates, catalog upload
admin:read	GET stats, users, settings, cost-settings, price-preview, rate-limiter, site-info, company-info, token logs

orders:read List orders + fetch eligible printers for order 42

curl

curl -H "Authorization: Bearer $PAT" \
  "https://your-domain.com/api/admin/orders?page=1&limit=20"

curl -H "Authorization: Bearer $PAT" \
  https://your-domain.com/api/admin/orders/42/eligible-printers

PowerShell

$h = @{ Authorization = "Bearer $PAT" }
Invoke-RestMethod -Uri `
  "https://your-domain.com/api/admin/orders?page=1&limit=20" `
  -Headers $h

Invoke-RestMethod -Uri `
  "https://your-domain.com/api/admin/orders/42/eligible-printers" `
  -Headers $h

orders:write Advance status → reassign printer → add note

curl

curl -X PATCH -H "Authorization: Bearer $PAT" \
  -H "Content-Type: application/json" \
  -d '{"status":"printing"}' \
  https://your-domain.com/api/admin/orders/42/status

curl -X PATCH -H "Authorization: Bearer $PAT" \
  -H "Content-Type: application/json" \
  -d '{"printer_id":3}' \
  https://your-domain.com/api/admin/orders/42/printer

PowerShell

$h = @{ Authorization="Bearer $PAT"; "Content-Type"="application/json" }
Invoke-RestMethod -Method PATCH -Headers $h `
  -Uri "https://your-domain.com/api/admin/orders/42/status" `
  -Body '{"status":"printing"}'

Invoke-RestMethod -Method PATCH -Headers $h `
  -Uri "https://your-domain.com/api/admin/orders/42/printer" `
  -Body '{"printer_id":3}'

payment:write Mark order paid — use from payment gateway webhook

curl

curl -X PATCH \
  -H "Authorization: Bearer $PAT" \
  -H "Content-Type: application/json" \
  -d '{}' \
  https://your-domain.com/api/admin/orders/42/paid

PowerShell

Invoke-RestMethod -Method PATCH `
  -Uri "https://your-domain.com/api/admin/orders/42/paid" `
  -Headers @{ Authorization="Bearer $PAT"; "Content-Type"="application/json" } `
  -Body '{}'

catalog:write Approve model + update metadata

curl

curl -X PATCH \
  -H "Authorization: Bearer $PAT" \
  -H "Content-Type: application/json" \
  -d '{"is_approved":true,"is_public":true}' \
  https://your-domain.com/api/admin/models/88

PowerShell

Invoke-RestMethod -Method PATCH `
  -Uri "https://your-domain.com/api/admin/models/88" `
  -Headers @{ Authorization="Bearer $PAT"; "Content-Type"="application/json" } `
  -Body '{"is_approved":true,"is_public":true}'

admin:read Dashboard stats + price preview

curl

curl -H "Authorization: Bearer $PAT" \
  https://your-domain.com/api/admin/stats

curl -X POST \
  -H "Authorization: Bearer $PAT" \
  -H "Content-Type: application/json" \
  -d '{"material":"PLA","volume_cm3":12.5,"quantity":2}' \
  https://your-domain.com/api/admin/price-preview

PowerShell

$h = @{ Authorization = "Bearer $PAT" }
Invoke-RestMethod -Uri `
  "https://your-domain.com/api/admin/stats" -Headers $h

Invoke-RestMethod -Method POST -Headers `
  ($h + @{"Content-Type"="application/json"}) `
  -Uri "https://your-domain.com/api/admin/price-preview" `
  -Body '{"material":"PLA","volume_cm3":12.5,"quantity":2}'

❌ Errors & Rate Limits

All errors return a JSON body with an error key and the matching HTTP status code.

{"error": "Descriptive message here."}

400Bad request / validation

401Missing or expired token

403Insufficient role or scope

404Resource not found

429Rate limit exceeded

Default Rate Limits

Limiter	Applies to	Default
General	All `/api/*` except auth & upload	100 req / 15 min per IP
Upload / Checkout	`/api/checkout`, `/api/upload-for-cart`, `/api/cart-checkout`	10 req / 60 min per IP
Auth	Login, register, forgot/reset password, 2FA	15 req / 15 min per IP
Quote	`/api/quote`	20 req / 15 min per IP
Model file	`/api/models/:id/file`	30 req / 15 min per IP

Limits can be adjusted live via PUT /api/admin/rate-limiter. Admin role bypasses the general limiter by default.

Two-Factor Auth

Order Details

My Order Details

Model Preview

Model Details

Turn yourideas into objects.

Available Materials

Upload & Quote

Model Analysis

Print Settings

Price Breakdown

Checkout

Sign in to continue

Order Summary

Shipping Details

Order Placed!

Checkout

Order Summary

Shipping Details

Group Order Placed!

Track Your Order

Affordable 3D Printingfor Everyone

Why We Built PrintForge Studio

Our Mission

3D Printing for Every Need

Students & Makers

Personalised Gifting

Repair & Replace

Why 3D Printing?

Ready to print something amazing?

Contact & Support

Send us a message

Our Location

Contact

Business Hours

Dashboard

Recent Orders

Orders

Print Config

Printer Types

Add Printer Type

Printer Owners

Print Config Guide

🔄 How an Order Flows

🖨️ Printer Setup — Field Reference

🧮 Smart Printer Assignment Algorithm

🧪 Materials Guide

🔳 Infill Percentage Guide

🚀 Fulfillment Modes

Categories

Add Category

Catalog Models

Upload Catalog Model

Edit Model

Cost Engine

🧪 Material Types

Add Material

⚙️ Equipment

💼 Business

👁 Customer-facing Display

📐 Pricing Formula

Shipping

Shipping Partners

Add Partner

Speed Post Rates

Regular Post Rates

PIN Prefix Database

Users

Store Profile

Company Information

Contact Details

Address

Legal & Registration

Social Media Links

Hero Section

Stats Strip

Story & Mission

Who We Serve Cards

New Coupon

Site Settings

Turn your
ideas into objects.

Affordable 3D Printing
for Everyone