# API reference v1

API v1 is deprecated. It keeps working for existing integrations, but it gets no new features: new integrations should use API v2.

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

-   [QuotesUpload an STL file and get its print price, then poll the quote or wait for its webhook.5 endpoints](https://public-api.dapi.digital/docs/v1/reference/quotes.md)

## Orders

-   [OrdersOrders placed from completed quotes, their shipping costs, and paying for them from the wallet.7 endpoints](https://public-api.dapi.digital/docs/v1/reference/orders.md)

## Platform

-   [StoresOne store per storefront you run, so quotes and orders are kept apart per storefront.5 endpoints](https://public-api.dapi.digital/docs/v1/reference/stores.md)
-   [API keyCheck that an API key works and which account it belongs to.1 endpoint](https://public-api.dapi.digital/docs/v1/reference/api-key.md)

## 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

-   [v1 OpenAPI documentThe deprecated v1 designer API, for code generators and tools.OpenAPI 3.0](https://public-api.dapi.digital/docs/v1.openapi.json)

---

3DAPI API Docs. This page on the web: https://public-api.dapi.digital/docs/v1/reference. Index of every page: https://public-api.dapi.digital/docs/llms.txt.
