Quotes
Upload an STL file and get its print price, then poll the quote or wait for its webhook.
The quote object
Attributes
- publicIdstring
Identifier for this quote. Use it to poll for results, reference the quote when creating an order, or contact support.
- nameobjectOptional
Optional label you assigned at creation. Purely informational - not used in processing.
- webhook_metadataobjectOptional
Arbitrary key-value data you attached at creation. Echoed back unchanged in all API responses and webhook payloads.
- statusstring
Current processing state. Poll until
DONEto read the price, or handleERRORif the file could not be priced.Possible valuesFILE_UPLOADEDPROCESSINGDONECANCELLEDERROR - resultobjectOptional
Estimated price per unit in USD, rounded to two decimal places. Populated only when
statusisDONE. - metricsvalueOptional
What the slicer measured for one unit: filament weight and print time. Populated only when
statusisDONE;nullwhile processing and after an error. - store_idobjectOptional
The store this quote belongs to, or
nullif your account does not use stores. - errorMessagestringOptional
Short explanation of what went wrong. Populated only when
statusisERROR. - createdAttimestamp
ISO 8601 timestamp of when this quote was submitted.
- finishedAtobjectOptional
ISO 8601 timestamp of when processing completed, regardless of outcome.
nullwhile stillPROCESSING.
{
"publicId": "dapi_a3f9b2c1e4",
"name": "bracket-v2",
"webhook_metadata": {
"order_id": "ORD-123",
"notify_slack": true
},
"status": "PROCESSING",
"result": 12.34,
"metrics": null,
"store_id": "str_9f2c4a7b13d84e0fa6c5b8e21d47a903",
"errorMessage": "We could not complete the quote for this file.",
"createdAt": "2026-03-24T12:00:00.000Z",
"finishedAt": "2026-03-24T12:05:00.000Z"
}Get a pre-signed upload URL
POST/
- Credentials
- An API key with the
PRICINGorFULLpermission. - For
- Designers
- Operation id
v1_uploadQuoteFile
Generates a pre-signed S3 URL that lets you upload an .stl file directly to storage, bypassing the API server entirely. Call this first - you need the returned s3_key to submit a quote.
Upload Steps
- Call this endpoint to receive an
upload_urlands3_key. PUTyour STL file toupload_urlwith headerContent-Type: application/octet-stream. Maximum file size: 250 MB.- Pass the
s3_keytoPOST /quotesto start the pricing process.
The upload URL expires after 1 hour. After expiry you must call this endpoint again.
Daily Quote Limit
A global daily limit on quote submissions is enforced to prevent abuse. Integration accounts are exempt from it. This endpoint is where the limit is checked and counted, since the quote record is created here. When a limit is active, successful responses include an X-Daily-Quotes-Remaining header with the number of quotes that can still be submitted today. Submitting once the limit is exhausted returns 429 Too Many Requests. The limit resets at midnight.
Request body
- file_namestring
Name of the file you are about to upload, used only to keep its extension.
The slicer picks its model loader from the file extension, so a
.3mfstored under an.stlname cannot be read and the quote fails with "The input model file to the slicer can not be parsed". Pass the real name and the extension is preserved.Supported:
.stl,.3mf,.obj,.step,.stp. Anything else is rejected. Omit this field and the upload is treated as.stl, which is what callers got before this field existed.
Returns201 Created
Pre-signed URL ready. Upload your STL file to upload_url before it expires.
Responses
- 201
Pre-signed URL ready. Upload your STL file to
upload_urlbefore it expires. - 401
API key is missing or invalid.
- 403
The API key does not have permission to use quote endpoints.
- 429
Daily quote limit reached - try again tomorrow.
- 500
An unexpected error occurred on our side.
Errors use the v1 error body.
curl -X POST "https://public-api.dapi.digital/v1/quotes/upload_file" \
-H "x-api-key: $DAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"file_name": "bracket-v2.3mf"
}'{
"publicId": "dapi_a3f9b2c1e4",
"upload_url": "https://s3.eu-central-1.amazonaws.com/...",
"s3_key": "public-api/quotes/abc-123/input/1711000000000-upload.stl",
"expires_in": 3600
}List your quotes
GET/
- Credentials
- An API key with the
PRICINGorFULLpermission. - For
- Designers
- Operation id
v1_listQuotes
Returns a paginated list of your quotes, sorted by creation date (newest first). Each entry shows the current processing status and, once complete, the estimated per-unit price. Use the publicId field to fetch full details via GET /quotes/:publicId.
Query parameters
- pageinteger
1-based page index. Defaults to
1. - page_sizeinteger
Number of quotes per page. Maximum is
100. Defaults to20. - store_idstring
Return only quotes belonging to this store. Omit to return quotes from every store on your account.
Returns200 OK
Paginated list of quotes for the authenticated account.
Responses
- 200
Paginated list of quotes for the authenticated account.
- 400
pageorpage_sizeis outside the allowed range. - 401
API key is missing or invalid.
- 403
The API key does not have permission to use quote endpoints.
- 429
Rate limit exceeded - wait until the window resets before retrying.
- 500
An unexpected error occurred on our side.
Errors use the v1 error body.
curl "https://public-api.dapi.digital/v1/quotes" \
-H "x-api-key: $DAPI_API_KEY"{
"items": [
{
"publicId": "dapi_a3f9b2c1e4",
"name": "bracket-v2",
"webhook_metadata": {
"order_id": "ORD-123",
"notify_slack": true
},
"status": "PROCESSING",
"result": 12.34,
"metrics": null,
"store_id": "str_9f2c4a7b13d84e0fa6c5b8e21d47a903",
"errorMessage": "We could not complete the quote for this file.",
"createdAt": "2026-03-24T12:00:00.000Z",
"finishedAt": "2026-03-24T12:05:00.000Z"
}
],
"page": 1,
"page_size": 20,
"total": 42
}Submit an STL file for pricing
POST/
- Credentials
- An API key with the
PRICINGorFULLpermission. - For
- Designers
- Operation id
v1_createQuote
Queues an uploaded STL file for automated price estimation. You must first obtain an s3_key by uploading the file via POST /quotes/upload_file.
The response includes a publicId you can use to poll GET /quotes/:publicId until status reaches DONE or ERROR. Alternatively, configure a webhook URL in the dashboard to receive a notification when processing completes.
Webhook Notifications
When processing finishes, we send an HTTP POST to your configured webhook URL. Any webhook_metadata you attached to this request is echoed back unchanged in the payload.
HMAC Signature Verification
Every webhook delivery includes two headers so you can verify authenticity:
X-Dapi-Webhook-Signature:sha256=<hex-digest>X-Dapi-Webhook-Timestamp: Unix timestamp (seconds) when the payload was signed
Verification steps:
- Read the raw request body as a UTF-8 string.
- Concatenate:
{X-Dapi-Webhook-Timestamp}.{raw_body} - Compute HMAC-SHA256 of that string using your webhook secret as the key.
- Compare the hex digest with the value after
sha256=in the signature header (use constant-time comparison to prevent timing attacks). - Reject the payload if the timestamp is older than 5 minutes (replay protection).
Webhook Payload Shape
{
"event": "quote.completed",
"quote": {
"public_id": "dapi_a3f9b2c1e4",
"status": "DONE",
"result": 12.34,
"error_message": null
},
"webhook_metadata": { "order_id": "ORD-123", "notify": true },
"timestamp": "2026-03-25T12:05:00.000Z"
}Expected Response
Return any 2xx status code to acknowledge receipt. We retry on non-2xx responses.
Request body
- s3_keystringRequired
The S3 key returned from
POST /quotes/upload_file. - namestring
Optional name or label for this quote (e.g. part name).
- store_idstring
The store this quote belongs to. Required once your account has at least one store. An order may only reference quotes from its own store.
- webhook_metadataobject
Optional flat key-value metadata object that will be echoed back in webhook payloads. Values must be strings (max 64 characters), numbers, or booleans. Maximum 20 keys.
Returns201 Created
Quote accepted and queued for processing. Poll with the returned publicId to retrieve the result.
Responses
- 201
Quote accepted and queued for processing. Poll with the returned
publicIdto retrieve the result. - 400
The
s3_keyis invalid, not found, or has already been submitted for another quote. - 401
API key is missing or invalid.
- 403
The API key does not have permission to use quote endpoints.
- 429
Rate limit exceeded - wait until the window resets before retrying.
- 500
An unexpected error occurred on our side.
Errors use the v1 error body.
curl -X POST "https://public-api.dapi.digital/v1/quotes" \
-H "x-api-key: $DAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"s3_key": "public-api/quotes/abc-123/input/1711000000000-upload.stl",
"name": "helmet-v3",
"store_id": "str_9f2c4a7b13d84e0fa6c5b8e21d47a903",
"webhook_metadata": {
"order_id": "ORD-123",
"notify_slack": true,
"priority": 1
}
}'{
"publicId": "dapi_a3f9b2c1e4",
"status": "PROCESSING"
}Check quote access
GET/
- Credentials
- An API key with the
PRICINGorFULLpermission. - For
- Designers
- Operation id
v1_getQuoteStatus
Verifies that your API key has permission to use quote endpoints. Call this before integrating the quote workflow if you want to confirm access is granted without side effects.
Returns200 OK
The key has permission to submit and retrieve quotes.
Responses
- 200
The key has permission to submit and retrieve quotes.
- 401
API key is missing or invalid.
- 403
The API key does not have permission to use quote endpoints.
- 429
Rate limit exceeded - wait until the window resets before retrying.
Errors use the v1 error body.
curl "https://public-api.dapi.digital/v1/quotes/status_check" \
-H "x-api-key: $DAPI_API_KEY"{
"ok": true,
"status": "pricing_access_granted"
}Get one quote
GET/
- Credentials
- An API key with the
PRICINGorFULLpermission. - For
- Designers
- Operation id
v1_getQuoteByPublicId
Returns the quote matching the given publicId. While status is PROCESSING, poll this endpoint periodically until it transitions to DONE or ERROR. When status is DONE, read result for the estimated per-unit price in USD. If a webhook URL is configured in your dashboard, you will be notified automatically when processing completes - no polling required.
Path parameters
- publicIdstringRequired
The
publicIdreturned when the quote was submitted.
Returns200 OK
The requested quote object. Returns the quote object.
Responses
- 200
The requested quote object.
- 400
The request could not be parsed or validated.
- 401
API key is missing or invalid.
- 403
The API key does not have permission to use quote endpoints.
- 404
No quote with this
publicIdexists for your account. - 429
Rate limit exceeded - wait until the window resets before retrying.
- 500
An unexpected error occurred on our side.
Errors use the v1 error body.
curl "https://public-api.dapi.digital/v1/quotes/dapi_a3f9b2c1e4" \
-H "x-api-key: $DAPI_API_KEY"{
"publicId": "dapi_a3f9b2c1e4",
"name": "bracket-v2",
"webhook_metadata": {
"order_id": "ORD-123",
"notify_slack": true
},
"status": "PROCESSING",
"result": 12.34,
"metrics": null,
"store_id": "str_9f2c4a7b13d84e0fa6c5b8e21d47a903",
"errorMessage": "We could not complete the quote for this file.",
"createdAt": "2026-03-24T12:00:00.000Z",
"finishedAt": "2026-03-24T12:05:00.000Z"
}