API reference v1
v1 lets a designer price STL files (quotes), place orders from completed quotes and pay for them from the wallet, and keep separate books per storefront (stores).
Production
Orders
Platform
Authentication
Send an API key in the x-api-key header. Keys are created on the API keys page of the 3DAPI dashboard. Each operation needs one of the permissions it lists; a key with FULL has them all.
Permissions: PRICING for quotes and stores, ORDER for orders, FULL for everything.
Approval
The designer order endpoints need an approved account. Create quotes for at least 10 different printable models, then request approval on the API keys page of the dashboard. Until then they answer 403 Forbidden.
Rate limiting
Requests are limited to 500 per 60-second window per API key. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Designer accounts also have a daily cap on new quotes, answered with 429 Too Many Requests.
Errors
Errors have the body { "statusCode", "error", "message" }. message is a string, or a list of strings when the request failed validation.