Deprecated

API v1 is deprecated. It keeps working for existing integrations but gets no new features. New integrations should use API v2: start with the v2 quickstart or browse the v2 reference.

API reference v1

View as Markdown

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.

For AI agents and tools