{
  "openapi": "3.0.0",
  "paths": {
    "/v1/me": {
      "get": {
        "description": "Returns server status, API key identity, and current rate-limit counters for the authenticated key. Call this to confirm connectivity and check how many requests remain before the limit resets.",
        "operationId": "v1_getMe",
        "parameters": [],
        "responses": {
          "200": {
            "description": "API key is valid and the server is reachable.",
            "headers": {
              "X-RateLimit-Limit": {
                "description": "Total requests allowed per 60-second window.",
                "schema": {
                  "type": "integer",
                  "example": 500
                }
              },
              "X-RateLimit-Remaining": {
                "description": "Requests remaining in the current window.",
                "schema": {
                  "type": "integer",
                  "example": 498
                }
              },
              "X-RateLimit-Reset": {
                "description": "Unix timestamp (seconds) when the current window expires and the counter resets.",
                "schema": {
                  "type": "integer",
                  "example": 1742731200
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1MeStatusResponse"
                }
              }
            }
          },
          "401": {
            "description": "API key is missing, invalid, or inactive.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded - wait until the window resets before retrying.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "summary": "API key health check",
        "tags": [
          "v1 API key"
        ],
        "deprecated": true,
        "x-audience": [
          "designer"
        ],
        "x-api-version": "v1",
        "x-required-scopes": []
      }
    },
    "/v1/quotes/upload_file": {
      "post": {
        "description": "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.\n\n## Upload Steps\n\n1. Call this endpoint to receive an `upload_url` and `s3_key`.\n2. `PUT` your STL file to `upload_url` with header `Content-Type: application/octet-stream`. **Maximum file size: 250 MB.**\n3. Pass the `s3_key` to `POST /quotes` to start the pricing process.\n\nThe upload URL expires after 1 hour. After expiry you must call this endpoint again.\n\n## Daily Quote Limit\n\nA 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.",
        "operationId": "v1_uploadQuoteFile",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/V1UploadFileRequestDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Pre-signed URL ready. Upload your STL file to `upload_url` before it expires.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1UploadFileResponse"
                }
              }
            }
          },
          "401": {
            "description": "API key is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "The API key does not have permission to use quote endpoints.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Daily quote limit reached - try again tomorrow.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on our side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "summary": "Get a pre-signed upload URL",
        "tags": [
          "v1 Quotes"
        ],
        "deprecated": true,
        "x-audience": [
          "designer"
        ],
        "x-api-version": "v1",
        "x-required-scopes": [
          "PRICING"
        ]
      }
    },
    "/v1/quotes": {
      "post": {
        "description": "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`.\n\nThe 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.\n\n## Webhook Notifications\n\nWhen 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.\n\n### HMAC Signature Verification\n\nEvery webhook delivery includes two headers so you can verify authenticity:\n\n- **`X-Dapi-Webhook-Signature`**: `sha256=<hex-digest>`\n- **`X-Dapi-Webhook-Timestamp`**: Unix timestamp (seconds) when the payload was signed\n\n**Verification steps:**\n\n1. Read the raw request body as a UTF-8 string.\n2. Concatenate: `{X-Dapi-Webhook-Timestamp}.{raw_body}`\n3. Compute HMAC-SHA256 of that string using your webhook secret as the key.\n4. Compare the hex digest with the value after `sha256=` in the signature header (use constant-time comparison to prevent timing attacks).\n5. Reject the payload if the timestamp is older than 5 minutes (replay protection).\n\n### Webhook Payload Shape\n\n```json\n{\n  \"event\": \"quote.completed\",\n  \"quote\": {\n    \"public_id\": \"dapi_a3f9b2c1e4\",\n    \"status\": \"DONE\",\n    \"result\": 12.34,\n    \"error_message\": null\n  },\n  \"webhook_metadata\": { \"order_id\": \"ORD-123\", \"notify\": true },\n  \"timestamp\": \"2026-03-25T12:05:00.000Z\"\n}\n```\n\n### Expected Response\n\nReturn any `2xx` status code to acknowledge receipt. We retry on non-2xx responses.",
        "operationId": "v1_createQuote",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/V1CreateQuoteRequestDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Quote accepted and queued for processing. Poll with the returned `publicId` to retrieve the result.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1CreateQuoteResponse"
                }
              }
            }
          },
          "400": {
            "description": "The `s3_key` is invalid, not found, or has already been submitted for another quote.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "API key is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "The API key does not have permission to use quote endpoints.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded - wait until the window resets before retrying.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on our side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "summary": "Submit an STL file for pricing",
        "tags": [
          "v1 Quotes"
        ],
        "deprecated": true,
        "x-audience": [
          "designer"
        ],
        "x-api-version": "v1",
        "x-required-scopes": [
          "PRICING"
        ]
      },
      "get": {
        "description": "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`.",
        "operationId": "v1_listQuotes",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "description": "1-based page index. Defaults to `1`.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "required": false,
            "in": "query",
            "description": "Number of quotes per page. Maximum is `100`. Defaults to `20`.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          },
          {
            "name": "store_id",
            "required": false,
            "in": "query",
            "description": "Return only quotes belonging to this store. Omit to return quotes from every store on your account.",
            "schema": {
              "example": "str_9f2c4a7b13d84e0fa6c5b8e21d47a903",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated list of quotes for the authenticated account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ListQuotesResponseDto"
                }
              }
            }
          },
          "400": {
            "description": "`page` or `page_size` is outside the allowed range.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "API key is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "The API key does not have permission to use quote endpoints.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded - wait until the window resets before retrying.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on our side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "summary": "List your quotes",
        "tags": [
          "v1 Quotes"
        ],
        "deprecated": true,
        "x-audience": [
          "designer"
        ],
        "x-api-version": "v1",
        "x-required-scopes": [
          "PRICING"
        ]
      }
    },
    "/v1/quotes/status_check": {
      "get": {
        "description": "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.",
        "operationId": "v1_getQuoteStatus",
        "parameters": [],
        "responses": {
          "200": {
            "description": "The key has permission to submit and retrieve quotes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1QuoteStatusCheckResponse"
                }
              }
            }
          },
          "401": {
            "description": "API key is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "The API key does not have permission to use quote endpoints.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded - wait until the window resets before retrying.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "summary": "Check quote access",
        "tags": [
          "v1 Quotes"
        ],
        "deprecated": true,
        "x-audience": [
          "designer"
        ],
        "x-api-version": "v1",
        "x-required-scopes": [
          "PRICING"
        ]
      }
    },
    "/v1/quotes/{publicId}": {
      "get": {
        "description": "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.",
        "operationId": "v1_getQuoteByPublicId",
        "parameters": [
          {
            "name": "publicId",
            "required": true,
            "in": "path",
            "description": "The `publicId` returned when the quote was submitted.",
            "schema": {
              "example": "dapi_a3f9b2c1e4",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The requested quote object.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1QuotePublicResponseDto"
                }
              }
            }
          },
          "400": {
            "description": "The request could not be parsed or validated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "API key is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "The API key does not have permission to use quote endpoints.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "No quote with this `publicId` exists for your account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded - wait until the window resets before retrying.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on our side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "summary": "Get one quote",
        "tags": [
          "v1 Quotes"
        ],
        "deprecated": true,
        "x-audience": [
          "designer"
        ],
        "x-api-version": "v1",
        "x-required-scopes": [
          "PRICING"
        ]
      }
    },
    "/v1/stores": {
      "post": {
        "description": "Creates a store representing one of your storefronts.\n\nA store keeps one storefront's quotes and orders bookkept apart from the others on your account. It is not an authentication boundary: your API key still reaches every store you own.\n\n> **Once your account has at least one store, `store_id` becomes required** when creating quotes and orders. This stops a storefront from silently omitting it and mixing its records in with the rest.",
        "operationId": "v1_createStore",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/V1CreateStoreRequestDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Store created.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1StoreResponseDto"
                }
              }
            }
          },
          "400": {
            "description": "The request could not be validated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "API key is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "The API key does not have permission to use store endpoints.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "409": {
            "description": "Another live store already uses this `external_reference`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "summary": "Create a store",
        "tags": [
          "v1 Stores"
        ],
        "deprecated": true,
        "x-audience": [
          "designer"
        ],
        "x-api-version": "v1",
        "x-required-scopes": [
          "PRICING"
        ]
      },
      "get": {
        "description": "Returns your stores, newest first. Archived stores are excluded unless you pass `include_archived=true`.",
        "operationId": "v1_listStores",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "description": "1-based page index.",
            "schema": {
              "minimum": 1,
              "default": 1,
              "example": 1,
              "type": "number"
            }
          },
          {
            "name": "page_size",
            "required": false,
            "in": "query",
            "description": "Number of stores per page (max 100).",
            "schema": {
              "minimum": 1,
              "maximum": 100,
              "default": 20,
              "example": 20,
              "type": "number"
            }
          },
          {
            "name": "include_archived",
            "required": false,
            "in": "query",
            "description": "Include archived stores in the results. Defaults to `false`, so closed storefronts stay out of the way.",
            "schema": {
              "default": false,
              "example": false,
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated list of stores.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ListStoresResponseDto"
                }
              }
            }
          },
          "400": {
            "description": "`page` or `page_size` is outside the allowed range.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "API key is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "The API key does not have permission to use store endpoints.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "summary": "List your stores",
        "tags": [
          "v1 Stores"
        ],
        "deprecated": true,
        "x-audience": [
          "designer"
        ],
        "x-api-version": "v1",
        "x-required-scopes": [
          "PRICING"
        ]
      }
    },
    "/v1/stores/{storeId}": {
      "get": {
        "description": "Returns the store matching the given id, archived or not.",
        "operationId": "v1_getStore",
        "parameters": [
          {
            "name": "storeId",
            "required": true,
            "in": "path",
            "description": "The store id returned when it was created.",
            "schema": {
              "example": "str_9f2c4a7b13d84e0fa6c5b8e21d47a903",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The requested store.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1StoreResponseDto"
                }
              }
            }
          },
          "401": {
            "description": "API key is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "The API key does not have permission to use store endpoints.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "No store with this id exists for your account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "summary": "Get one store",
        "tags": [
          "v1 Stores"
        ],
        "deprecated": true,
        "x-audience": [
          "designer"
        ],
        "x-api-version": "v1",
        "x-required-scopes": [
          "PRICING"
        ]
      },
      "patch": {
        "description": "Updates a store's name or external reference. Omitted fields are left unchanged; pass `external_reference: null` to clear it.",
        "operationId": "v1_updateStore",
        "parameters": [
          {
            "name": "storeId",
            "required": true,
            "in": "path",
            "description": "The store to update.",
            "schema": {
              "example": "str_9f2c4a7b13d84e0fa6c5b8e21d47a903",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/V1UpdateStoreRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The updated store.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1StoreResponseDto"
                }
              }
            }
          },
          "400": {
            "description": "No updatable field was provided, or the body failed validation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "API key is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "The API key does not have permission to use store endpoints.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "No store with this id exists for your account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "409": {
            "description": "Another live store already uses this `external_reference`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "summary": "Update a store",
        "tags": [
          "v1 Stores"
        ],
        "deprecated": true,
        "x-audience": [
          "designer"
        ],
        "x-api-version": "v1",
        "x-required-scopes": [
          "PRICING"
        ]
      },
      "delete": {
        "description": "Archives a store. Its quotes and orders are kept and stay readable, but the store refuses new ones.\n\nStores are never hard-deleted, because orders reference them and that history has to survive a storefront closing. Archiving twice is safe and leaves the original archive date intact.",
        "operationId": "v1_archiveStore",
        "parameters": [
          {
            "name": "storeId",
            "required": true,
            "in": "path",
            "description": "The store to archive.",
            "schema": {
              "example": "str_9f2c4a7b13d84e0fa6c5b8e21d47a903",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The archived store.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1StoreResponseDto"
                }
              }
            }
          },
          "401": {
            "description": "API key is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "The API key does not have permission to use store endpoints.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "No store with this id exists for your account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "summary": "Archive a store",
        "tags": [
          "v1 Stores"
        ],
        "deprecated": true,
        "x-audience": [
          "designer"
        ],
        "x-api-version": "v1",
        "x-required-scopes": [
          "PRICING"
        ]
      }
    },
    "/v1/designer/orders": {
      "get": {
        "description": "Returns a paginated list of your orders, sorted by creation date (newest first). Each entry includes the current lifecycle status, shipping address, item breakdown, and tracking details when available. Use the `order_id` field to fetch full details via `GET /orders/:orderId`.",
        "operationId": "v1_listOrders",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "description": "1-based page index.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "default": 1
            }
          },
          {
            "name": "page_size",
            "required": false,
            "in": "query",
            "description": "Page size (max 100).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          },
          {
            "name": "store_id",
            "required": false,
            "in": "query",
            "description": "Return only orders belonging to this store. Omit to return orders from every store on your account.",
            "schema": {
              "example": "str_9f2c4a7b13d84e0fa6c5b8e21d47a903",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated list of orders for the authenticated account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ListOrdersResponseDto"
                }
              }
            }
          },
          "400": {
            "description": "`page` or `page_size` is outside the allowed range.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "API key is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "The API key does not have permission to use order endpoints.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded - wait until the window resets before retrying.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on our side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "summary": "List your orders",
        "tags": [
          "v1 Orders"
        ],
        "deprecated": true,
        "x-audience": [
          "designer"
        ],
        "x-api-version": "v1",
        "x-required-scopes": [
          "ORDER"
        ]
      },
      "post": {
        "description": "Places a new order by combining one or more completed quotes. Each item references a quote by its `publicId` and specifies the filament and quantity to produce.\n\n**Prerequisites:**\n- All referenced quotes must have `status` equal to `DONE`.\n- All filament codes must be valid - retrieve available codes from `GET /orders/filaments`.\n- At least one item is required.\n- Each item lists its filaments in `filaments`, one code per colour slot in slot order; a single-colour design sends a one-element array.\n\n**Multi-colour items:** `filaments` lists one code per colour slot in the design's own extruder order, so `[\"PLA-GREEN\",\"PLA-RED\"]` and `[\"PLA-RED\",\"PLA-GREEN\"]` order different products. Each distinct combination becomes its own SKU; repeating the same quote with the same combination reuses it.\n\nThe order is created with status `pending`. Use `POST /orders/:orderId/pay` to pay for it and move it into production.",
        "operationId": "v1_createOrder",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/V1CreateOrderRequestDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Order created with status `pending`. Pay with `POST /orders/:orderId/pay` to proceed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1CreateOrderResponseDto"
                }
              }
            }
          },
          "400": {
            "description": "Request body failed validation, a filament code is unrecognised, or a referenced quote does not have `status` `DONE`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "API key is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "The API key does not have permission to use order endpoints.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "One or more referenced quote `publicId` values were not found for your account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded - wait until the window resets before retrying.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on our side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "summary": "Create an order from completed quotes",
        "tags": [
          "v1 Orders"
        ],
        "deprecated": true,
        "x-audience": [
          "designer"
        ],
        "x-api-version": "v1",
        "x-required-scopes": [
          "ORDER"
        ]
      }
    },
    "/v1/designer/orders/filaments": {
      "get": {
        "description": "Returns all filament options currently available for ordering. Use the `code` value (e.g. `PLA-GREEN`) in the `filaments` array of each item when creating an order via `POST /orders`.",
        "operationId": "v1_listFilaments",
        "parameters": [],
        "responses": {
          "200": {
            "description": "All filaments available for use in orders.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ListFilamentsResponseDto"
                }
              }
            }
          },
          "401": {
            "description": "API key is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "The API key does not have permission to use order endpoints.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded - wait until the window resets before retrying.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "summary": "List available filaments",
        "tags": [
          "v1 Orders"
        ],
        "deprecated": true,
        "x-audience": [
          "designer"
        ],
        "x-api-version": "v1",
        "x-required-scopes": [
          "ORDER"
        ]
      }
    },
    "/v1/designer/orders/shipping/rates": {
      "get": {
        "description": "Returns every shipping zone, the countries it covers as ISO 3166-1 alpha-2 codes, and the price of the first item in each weight tier plus each additional item.\n\n**How a parcel is priced:**\n- The tier comes from the HEAVIEST single item, not the summed weight of the order. Two small items ship as one Small plus one additional item, not as a Medium.\n- Items under `extra_small_max_grams` are exempt from `additional_item_price`.\n- A destination no zone lists falls to the zone with `catch_all` set.\n- An order that cannot be rated at all is charged `flat_rate`.\n\nUse `POST /orders/shipping/estimate` to price a specific order rather than deriving it.",
        "operationId": "v1_getShippingRates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "The active rate card.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ShippingRatesResponseDto"
                }
              }
            }
          },
          "401": {
            "description": "API key is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "The API key does not have permission to use order endpoints.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded - wait until the window resets before retrying.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "summary": "Get the shipping rate card",
        "tags": [
          "v1 Orders"
        ],
        "deprecated": true,
        "x-audience": [
          "designer"
        ],
        "x-api-version": "v1",
        "x-required-scopes": [
          "ORDER"
        ]
      }
    },
    "/v1/designer/orders/shipping/estimate": {
      "post": {
        "description": "Prices shipping for a set of quotes and a destination, without placing an order. Runs the same weigh -> tier -> price steps order creation does, against the same rate card, so the number returned is the number the order will be charged.\n\nFilaments are not accepted: colour does not change what a parcel weighs.\n\nA destination that cannot be rated against the card is still priced - `shipping` is always what the order will be charged - but comes back with `zone` and `tier` null.",
        "operationId": "v1_estimateShipping",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/V1EstimateShippingRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The shipping cost this order would be charged.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1EstimateShippingResponseDto"
                }
              }
            }
          },
          "400": {
            "description": "Request body failed validation, or a quote has not finished slicing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "API key is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "The API key does not have permission to use order endpoints.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "One or more quotes do not exist for your account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded - wait until the window resets before retrying.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "summary": "Estimate shipping for an order",
        "tags": [
          "v1 Orders"
        ],
        "deprecated": true,
        "x-audience": [
          "designer"
        ],
        "x-api-version": "v1",
        "x-required-scopes": [
          "ORDER"
        ]
      }
    },
    "/v1/designer/orders/{orderId}": {
      "get": {
        "description": "Returns the order matching the given `orderId`. Includes current status, recipient details, item breakdown, and tracking information once the order ships.\n\n## Webhook Notifications\n\nWhen an order status changes to `paid`, `in_production`, `shipping`, or `completed`, we send an HTTP `POST` to your configured webhook URL (set via the dashboard). Each notification is signed - verify the `X-Dapi-Webhook-Signature` header using your webhook secret.\n\n### Webhook Payload Shape\n\n```json\n{\n  \"event\": \"order.in_production\",\n  \"order\": {\n    \"order_id\": \"AP7K2M9X\",\n    \"status\": \"in_production\",\n    \"tracking_number\": null,\n    \"courier\": null\n  },\n  \"timestamp\": \"2026-03-25T12:05:00.000Z\"\n}\n```\n\n### Expected Response\n\nReturn any `2xx` status code to acknowledge receipt. We retry on non-2xx responses.",
        "operationId": "v1_getOrderById",
        "parameters": [
          {
            "name": "orderId",
            "required": true,
            "in": "path",
            "description": "The unique order identifier returned when the order was created.",
            "schema": {
              "example": "AP7K2M9X",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The requested order object.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1OrderPublicResponseDto"
                }
              }
            }
          },
          "401": {
            "description": "API key is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "The API key does not have permission to use order endpoints.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "No order with this `orderId` exists for your account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded - wait until the window resets before retrying.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on our side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "summary": "Get one order",
        "tags": [
          "v1 Orders"
        ],
        "deprecated": true,
        "x-audience": [
          "designer"
        ],
        "x-api-version": "v1",
        "x-required-scopes": [
          "ORDER"
        ]
      }
    },
    "/v1/orders/{orderId}/pay": {
      "post": {
        "description": "Pay for a pending order. Three payment methods are available:\n\n- **`wallet`**: Debit the order amount directly from your wallet balance. Fails if the balance is insufficient.\n- **`wallet_auto`**: If wallet balance is insufficient, automatically top up from your saved card to the configured auto-topup amount, then debit.\n- **`wallet_difference`**: If wallet balance is insufficient, automatically top up only the deficit from your saved card, then debit.\n\nBoth `wallet_auto` and `wallet_difference` require a saved card on your wallet.\n\nThis endpoint is idempotent - calling it on an already-paid order returns `409 Conflict`.",
        "operationId": "v1_payOrder",
        "parameters": [
          {
            "name": "orderId",
            "required": true,
            "in": "path",
            "description": "The unique order identifier returned when the order was created.",
            "schema": {
              "example": "AP-A1B2C3",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/V1PayOrderRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Payment successful. Order status is now `paid`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1PayOrderResponseDto"
                }
              }
            }
          },
          "400": {
            "description": "Wallet balance is insufficient and no auto-topup is configured, or no saved card is on file for the selected payment method.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "API key is missing or invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "402": {
            "description": "Card charge failed. The payment could not be confirmed - verify your saved card details or add a new card via the dashboard.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "403": {
            "description": "The API key does not have permission to use order endpoints, or this order belongs to a different account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "404": {
            "description": "No order with this `orderId` exists for your account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "409": {
            "description": "The order has already been paid. No further action is needed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded - wait until the window resets before retrying.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred on our side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/V1ApiErrorResponse"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "summary": "Pay for an order using wallet balance",
        "tags": [
          "v1 Orders"
        ],
        "deprecated": true,
        "x-audience": [
          "designer"
        ],
        "x-api-version": "v1",
        "x-required-scopes": [
          "ORDER"
        ]
      }
    }
  },
  "info": {
    "title": "3DAPI API v1 (deprecated)",
    "description": "API v1 is deprecated. It keeps working for existing integrations, but it gets no new features: new integrations should use API v2.\n\nv1 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).\n\n## Authentication\nSend 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.\n\nPermissions: `PRICING` for quotes and stores, `ORDER` for orders, `FULL` for everything.\n\n## Approval\nThe 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`.\n\n## Rate limiting\nRequests 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`.\n\n## Errors\nErrors have the body `{ \"statusCode\", \"error\", \"message\" }`. `message` is a string, or a list of strings when the request failed validation.",
    "version": "1.0.0",
    "contact": {}
  },
  "tags": [
    {
      "name": "v1 Quotes",
      "description": "Upload an STL file and get its print price, then poll the quote or wait for its webhook."
    },
    {
      "name": "v1 Orders",
      "description": "Orders placed from completed quotes, their shipping costs, and paying for them from the wallet."
    },
    {
      "name": "v1 Stores",
      "description": "One store per storefront you run, so quotes and orders are kept apart per storefront."
    },
    {
      "name": "v1 API key",
      "description": "Check that an API key works and which account it belongs to."
    }
  ],
  "servers": [
    {
      "url": "https://public-api.dapi.digital",
      "description": "Production"
    }
  ],
  "components": {
    "securitySchemes": {
      "api_key": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key",
        "description": "API key created on the API keys page of the dashboard."
      }
    },
    "schemas": {
      "V1ApiErrorResponse": {
        "type": "object",
        "properties": {
          "statusCode": {
            "type": "number",
            "example": 401,
            "description": "HTTP status code"
          },
          "error": {
            "type": "string",
            "example": "Unauthorized",
            "description": "Short error label matching the HTTP status"
          },
          "message": {
            "type": "string",
            "example": "Invalid or inactive API key.",
            "description": "Human-readable description of what went wrong"
          }
        },
        "required": [
          "statusCode",
          "error",
          "message"
        ]
      },
      "V1ApiKeyStatusDto": {
        "type": "object",
        "properties": {
          "exists": {
            "type": "boolean",
            "example": true,
            "description": "Confirms the API key was found. A key may exist but still be inactive - check `active` to determine if requests will be accepted."
          },
          "active": {
            "type": "boolean",
            "example": true,
            "description": "Indicates the key is currently enabled. Requests from an inactive key are rejected with `401`."
          },
          "name": {
            "type": "string",
            "example": "My production key",
            "description": "Label you assigned to this key in the dashboard, for your own reference."
          }
        },
        "required": [
          "exists",
          "active",
          "name"
        ]
      },
      "V1CreateOrderRequestDto": {
        "type": "object",
        "properties": {
          "customer": {
            "description": "Recipient contact and shipping address. All nested fields are required.",
            "allOf": [
              {
                "$ref": "#/components/schemas/V1CustomerDto"
              }
            ]
          },
          "items": {
            "description": "One or more items to include in the order. Each item references a completed quote and specifies a filament and quantity. At least one item is required.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/V1OrderItemDto"
            }
          },
          "store_id": {
            "type": "string",
            "description": "The store this order belongs to. Required once your account has at least one store. Every quote referenced in `items` must belong to this same store.",
            "example": "str_9f2c4a7b13d84e0fa6c5b8e21d47a903"
          },
          "customer_notes": {
            "type": "string",
            "example": "Please leave at the door.",
            "description": "Optional notes for the order (e.g. delivery instructions)."
          },
          "checkout_link": {
            "type": "boolean",
            "example": false,
            "description": "When `true`, a hosted Stripe Checkout URL is generated and returned in the response as `checkout_link`. The customer can open this URL in a browser to pay for the order. The order status will automatically advance to `paid` once payment is completed via Stripe. Requires `checkout_success_url` and `checkout_cancel_url`.",
            "default": false
          },
          "checkout_success_url": {
            "type": "string",
            "example": "https://yourstore.com/orders/success?ref={CHECKOUT_SESSION_ID}",
            "description": "URL to redirect the customer to after a successful Stripe Checkout payment. Required when `checkout_link` is `true`. You may include `{CHECKOUT_SESSION_ID}` as a placeholder - Stripe will substitute it with the actual session ID."
          },
          "checkout_cancel_url": {
            "type": "string",
            "example": "https://yourstore.com/orders/cancelled",
            "description": "URL to redirect the customer to if they cancel the Stripe Checkout flow. Required when `checkout_link` is `true`."
          }
        },
        "required": [
          "customer",
          "items"
        ]
      },
      "V1CreateOrderResponseDto": {
        "type": "object",
        "properties": {
          "orderId": {
            "type": "string",
            "example": "AP7K2M9X",
            "description": "Unique identifier for the newly created order. Use this with `POST /orders/:orderId/pay` to pay for the order."
          },
          "status": {
            "type": "string",
            "example": "pending",
            "description": "Initial status of the order. Always `pending` on creation - pay with `POST /orders/:orderId/pay` to advance it into production."
          },
          "delivery": {
            "type": "number",
            "example": 10,
            "description": "Flat delivery fee in USD."
          },
          "order_total": {
            "type": "number",
            "example": 133.4,
            "description": "Grand total in USD, including all line items and the delivery fee."
          },
          "items": {
            "description": "Line items included in this order with their final pricing.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/V1OrderItemResponseDto"
            }
          },
          "checkout_link": {
            "type": "string",
            "example": "https://checkout.stripe.com/c/pay/cs_test_...",
            "description": "Hosted Stripe Checkout URL. Only present when `checkout_link: true` was passed in the request. Redirect your customer to this URL to complete payment in the browser."
          }
        },
        "required": [
          "orderId",
          "status",
          "delivery",
          "order_total",
          "items"
        ]
      },
      "V1CreateQuoteRequestDto": {
        "type": "object",
        "properties": {
          "s3_key": {
            "type": "string",
            "description": "The S3 key returned from `POST /quotes/upload_file`.",
            "example": "public-api/quotes/abc-123/input/1711000000000-upload.stl"
          },
          "name": {
            "type": "string",
            "description": "Optional name or label for this quote (e.g. part name).",
            "example": "helmet-v3",
            "maxLength": 100
          },
          "store_id": {
            "type": "string",
            "description": "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.",
            "example": "str_9f2c4a7b13d84e0fa6c5b8e21d47a903"
          },
          "webhook_metadata": {
            "type": "object",
            "description": "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.",
            "example": {
              "order_id": "ORD-123",
              "notify_slack": true,
              "priority": 1
            }
          }
        },
        "required": [
          "s3_key"
        ]
      },
      "V1CreateQuoteResponse": {
        "type": "object",
        "properties": {
          "publicId": {
            "type": "string",
            "description": "Use this id with `GET /quotes/:publicId` to see when your quote is ready and to read prices.",
            "example": "dapi_a3f9b2c1e4"
          },
          "status": {
            "type": "string",
            "description": "`PROCESSING` - we accepted your request and are working on it. `ERROR` - we could not start the quote; try again or contact support.",
            "enum": [
              "PROCESSING",
              "ERROR"
            ],
            "example": "PROCESSING"
          }
        },
        "required": [
          "publicId",
          "status"
        ]
      },
      "V1CreateStoreRequestDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Human-readable name for this storefront. Shown only to you.",
            "example": "Clicker Shop UK",
            "maxLength": 120
          },
          "external_reference": {
            "type": "string",
            "description": "Your own identifier for this storefront, so you can reconcile without keeping a mapping table. Opaque to us and never interpreted. Must be unique across your live stores.",
            "example": "shop_uk_001",
            "maxLength": 120
          }
        },
        "required": [
          "name"
        ]
      },
      "V1CustomerDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "example": "John Doe",
            "description": "Full name of the recipient."
          },
          "email": {
            "type": "string",
            "example": "john@example.com",
            "description": "Email address used for shipping and order notifications."
          },
          "address": {
            "type": "string",
            "example": "123 Main St",
            "description": "Street address for delivery, including apartment or suite number if applicable."
          },
          "city": {
            "type": "string",
            "example": "New York",
            "description": "City for the delivery destination."
          },
          "state": {
            "type": "string",
            "example": "NY",
            "description": "State or province for the delivery destination."
          },
          "postalCode": {
            "type": "string",
            "example": "10001",
            "description": "Postal or ZIP code for the delivery address."
          },
          "country": {
            "type": "string",
            "example": "US",
            "description": "2-letter ISO 3166-1 alpha-2 country code. Must be uppercase (e.g. `US`, `DE`, `GB`).",
            "minLength": 2,
            "maxLength": 2
          },
          "phone_number": {
            "type": "string",
            "example": "+12125551234",
            "description": "Phone number including country prefix (e.g. `+12125551234`). Must be valid for the provided country."
          }
        },
        "required": [
          "name",
          "email",
          "address",
          "city",
          "state",
          "postalCode",
          "country",
          "phone_number"
        ]
      },
      "V1EstimateShippingItemDto": {
        "type": "object",
        "properties": {
          "quoteId": {
            "type": "string",
            "example": "dapi_a3f9b2c1e4",
            "description": "The `publicId` of a completed quote (`status` must be `DONE`)."
          },
          "quantity": {
            "type": "number",
            "example": 5,
            "description": "Units of this quote.",
            "minimum": 1
          }
        },
        "required": [
          "quoteId",
          "quantity"
        ]
      },
      "V1EstimateShippingRequestDto": {
        "type": "object",
        "properties": {
          "country": {
            "type": "string",
            "example": "DE",
            "description": "2-letter ISO 3166-1 alpha-2 destination code, uppercase.",
            "minLength": 2,
            "maxLength": 2
          },
          "items": {
            "description": "Items to ship. Filaments are not needed: colour does not change what a parcel weighs.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/V1EstimateShippingItemDto"
            }
          }
        },
        "required": [
          "country",
          "items"
        ]
      },
      "V1EstimateShippingResponseDto": {
        "type": "object",
        "properties": {
          "country": {
            "type": "string",
            "example": "DE"
          },
          "zone": {
            "type": "object",
            "example": "EU",
            "nullable": true,
            "description": "Null when the flat rate applied."
          },
          "zone_label": {
            "type": "object",
            "example": "European Union",
            "nullable": true
          },
          "tier": {
            "type": "object",
            "example": "small",
            "nullable": true,
            "description": "Tier the parcel was priced at - the heaviest single item."
          },
          "item_count": {
            "type": "number",
            "example": 5,
            "description": "Units in the order."
          },
          "billable_item_count": {
            "type": "number",
            "example": 0,
            "description": "Units charged `additional_item_price` (after the first). Excludes extra-small items, so this can be 0."
          },
          "extra_small_items": {
            "type": "boolean",
            "example": true,
            "description": "Whether any item was light enough to be exempt from the per-item charge."
          },
          "shipping": {
            "type": "number",
            "example": 4.5,
            "description": "Shipping cost in USD. This is what the order will be charged. `zone` and `tier` are null when the destination could not be rated against the card."
          }
        },
        "required": [
          "country",
          "zone",
          "zone_label",
          "tier",
          "item_count",
          "billable_item_count",
          "extra_small_items",
          "shipping"
        ]
      },
      "V1FilamentResponseDto": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "example": "PLA-GREEN",
            "description": "Unique filament identifier to use in the `filament` field when creating an order. Format: `{MATERIAL}-{COLOR}` in uppercase with hyphens (e.g. `PLA-GREEN`, `PETG-BLACK`)."
          },
          "name": {
            "type": "string",
            "example": "PLA Green",
            "description": "Human-readable display name of the filament, suitable for use in a UI."
          },
          "color": {
            "type": "object",
            "example": "green",
            "description": "Color of the filament in lowercase English. `null` when the filament is multi-color or the color is unspecified.",
            "nullable": true
          }
        },
        "required": [
          "code",
          "name",
          "color"
        ]
      },
      "V1ListFilamentsResponseDto": {
        "type": "object",
        "properties": {
          "items": {
            "description": "All filaments currently available for ordering.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/V1FilamentResponseDto"
            }
          }
        },
        "required": [
          "items"
        ]
      },
      "V1ListOrdersResponseDto": {
        "type": "object",
        "properties": {
          "items": {
            "description": "Orders on this page, sorted by creation date (newest first).",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/V1OrderPublicResponseDto"
            }
          },
          "page": {
            "type": "number",
            "description": "Page number returned, matching the `page` query parameter.",
            "example": 1,
            "minimum": 1
          },
          "page_size": {
            "type": "number",
            "description": "Number of items per page, matching the `page_size` query parameter.",
            "example": 20,
            "minimum": 1,
            "maximum": 100
          },
          "total": {
            "type": "number",
            "description": "Total number of orders across all pages. Use this to determine whether more pages exist.",
            "example": 42,
            "minimum": 0
          }
        },
        "required": [
          "items",
          "page",
          "page_size",
          "total"
        ]
      },
      "V1ListQuotesResponseDto": {
        "type": "object",
        "properties": {
          "items": {
            "description": "Quotes on this page, sorted by creation date (newest first).",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/V1QuotePublicResponseDto"
            }
          },
          "page": {
            "type": "number",
            "description": "Page number returned, matching the `page` query parameter.",
            "example": 1,
            "minimum": 1
          },
          "page_size": {
            "type": "number",
            "description": "Number of items per page, matching the `page_size` query parameter.",
            "example": 20,
            "minimum": 1,
            "maximum": 100
          },
          "total": {
            "type": "number",
            "description": "Total number of quotes across all pages. Use this to determine whether more pages exist.",
            "example": 42,
            "minimum": 0
          }
        },
        "required": [
          "items",
          "page",
          "page_size",
          "total"
        ]
      },
      "V1ListStoresResponseDto": {
        "type": "object",
        "properties": {
          "items": {
            "description": "Stores on this page, newest first.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/V1StoreResponseDto"
            }
          },
          "page": {
            "type": "number",
            "description": "Page number returned.",
            "example": 1,
            "minimum": 1
          },
          "page_size": {
            "type": "number",
            "description": "Number of items per page.",
            "example": 20,
            "minimum": 1,
            "maximum": 100
          },
          "total": {
            "type": "number",
            "description": "Total number of stores matching the query, across all pages.",
            "example": 3,
            "minimum": 0
          }
        },
        "required": [
          "items",
          "page",
          "page_size",
          "total"
        ]
      },
      "V1MeStatusResponse": {
        "type": "object",
        "properties": {
          "server_running": {
            "type": "boolean",
            "example": true,
            "description": "Always `true` when you receive a `200` - confirms the server is reachable."
          },
          "api_key": {
            "description": "Identity and activation status of the key used to authenticate this request.",
            "allOf": [
              {
                "$ref": "#/components/schemas/V1ApiKeyStatusDto"
              }
            ]
          },
          "rate_limit": {
            "description": "Current rate-limit counters for this key. Use `remaining` and `reset_at` to throttle your integration proactively.",
            "allOf": [
              {
                "$ref": "#/components/schemas/V1RateLimitStatusDto"
              }
            ]
          }
        },
        "required": [
          "server_running",
          "api_key",
          "rate_limit"
        ]
      },
      "V1OrderCustomerDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "example": "John Doe",
            "description": "Full name of the recipient."
          },
          "email": {
            "type": "object",
            "example": "john@example.com",
            "description": "Email address of the recipient. Used for shipping notifications when provided.",
            "nullable": true
          },
          "address": {
            "type": "string",
            "example": "123 Main St",
            "description": "Street address for delivery."
          },
          "city": {
            "type": "object",
            "example": "San Francisco",
            "description": "City for the delivery destination.",
            "nullable": true
          },
          "country": {
            "type": "object",
            "example": "US",
            "description": "2-letter ISO 3166-1 alpha-2 country code for the delivery destination.",
            "nullable": true
          }
        },
        "required": [
          "name",
          "address"
        ]
      },
      "V1OrderItemDto": {
        "type": "object",
        "properties": {
          "quoteId": {
            "type": "string",
            "example": "dapi_a3f9b2c1e4",
            "description": "The `publicId` of a completed quote (`status` must be `DONE`). Each quote may appear at most once per order."
          },
          "filaments": {
            "example": [
              "PLA-GREEN",
              "PLA-RED"
            ],
            "description": "Filament codes for this item, one per colour slot, **in slot order**. Slot order is the design's own extruder order, so `[\"PLA-GREEN\",\"PLA-RED\"]` and `[\"PLA-RED\",\"PLA-GREEN\"]` are different products. Give a single-element array for a single-colour design. Retrieve valid codes from `GET /orders/filaments`.",
            "minItems": 1,
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "quantity": {
            "type": "number",
            "example": 5,
            "description": "Number of units to produce for this item. Minimum is `1`.",
            "minimum": 1
          }
        },
        "required": [
          "quoteId",
          "filaments",
          "quantity"
        ]
      },
      "V1OrderItemPublicDto": {
        "type": "object",
        "properties": {
          "quoteId": {
            "type": "string",
            "example": "dapi_a3f9b2c1e4",
            "description": "The `publicId` of the quote this line item was derived from."
          },
          "filaments": {
            "example": [
              "PLA-GREEN",
              "PLA-RED"
            ],
            "description": "Filament codes used for this item, one per colour slot, in slot order - the same order given when the order was placed. Single-colour items return a one-element array. See `GET /orders/filaments` for all codes.",
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "individual_price": {
            "type": "number",
            "example": 12.34,
            "description": "Price per unit in USD, taken from the quote result."
          },
          "quantity": {
            "type": "number",
            "example": 5,
            "description": "Number of units ordered for this line item."
          },
          "total": {
            "type": "number",
            "example": 61.7,
            "description": "Line-item subtotal in USD (`individual_price` × `quantity`)."
          }
        },
        "required": [
          "quoteId",
          "filaments",
          "individual_price",
          "quantity",
          "total"
        ]
      },
      "V1OrderItemResponseDto": {
        "type": "object",
        "properties": {
          "quoteId": {
            "type": "string",
            "example": "dapi_a3f9b2c1e4",
            "description": "The `publicId` of the quote this line item was created from."
          },
          "individual_price": {
            "type": "number",
            "example": 12.34,
            "description": "Price per unit in USD, taken from the quote result."
          },
          "quantity": {
            "type": "number",
            "example": 5,
            "description": "Number of units ordered for this line item."
          },
          "total": {
            "type": "number",
            "example": 61.7,
            "description": "Line-item subtotal in USD (`individual_price` × `quantity`)."
          }
        },
        "required": [
          "quoteId",
          "individual_price",
          "quantity",
          "total"
        ]
      },
      "V1OrderPublicResponseDto": {
        "type": "object",
        "properties": {
          "order_id": {
            "type": "string",
            "description": "Unique identifier for this order.",
            "example": "AP7K2M9X"
          },
          "status": {
            "type": "string",
            "description": "Current lifecycle stage of the order. Progresses from `pending` → `paid` → `in_production` → `shipping` → `completed`. May also be `rejected` or `returned`.",
            "example": "pending",
            "enum": [
              "pending",
              "paid",
              "in_production",
              "shipping",
              "completed",
              "rejected",
              "returned"
            ]
          },
          "delivery": {
            "type": "number",
            "description": "Flat delivery fee in USD, added on top of the item subtotals.",
            "example": 10
          },
          "order_total": {
            "type": "number",
            "description": "Grand total in USD, including all line items and the delivery fee.",
            "example": 133.4
          },
          "customer": {
            "description": "Recipient contact and shipping address details.",
            "allOf": [
              {
                "$ref": "#/components/schemas/V1OrderCustomerDto"
              }
            ]
          },
          "items": {
            "description": "Line items that make up this order, each derived from a completed quote.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/V1OrderItemPublicDto"
            }
          },
          "tracking_number": {
            "type": "object",
            "description": "Carrier tracking number. Populated once the order moves to `shipping` status.",
            "example": "1Z999AA10123456784",
            "nullable": true
          },
          "courier": {
            "type": "object",
            "description": "Name of the shipping carrier (e.g. `ups`, `dhl`). Populated alongside `tracking_number`.",
            "example": "ups",
            "nullable": true
          },
          "created_at": {
            "format": "date-time",
            "type": "string",
            "description": "ISO 8601 timestamp of when this order was placed.",
            "example": "2026-03-24T12:00:00.000Z"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string",
            "description": "ISO 8601 timestamp of the most recent change to this order (status update, tracking added, etc.).",
            "example": "2026-03-24T12:05:00.000Z"
          }
        },
        "required": [
          "order_id",
          "status",
          "delivery",
          "order_total",
          "customer",
          "items",
          "created_at",
          "updated_at"
        ]
      },
      "V1PayOrderRequestDto": {
        "type": "object",
        "properties": {
          "paymentMethod": {
            "type": "string",
            "enum": [
              "wallet",
              "wallet_auto",
              "wallet_difference"
            ],
            "example": "wallet",
            "description": "How to fund the payment.\n\n- `wallet` - deduct the full order amount from your wallet. Fails with `400` if the balance is insufficient.\n- `wallet_auto` - if your wallet balance is too low, top it up from your saved card to the configured auto-topup target, then deduct. Requires a saved card.\n- `wallet_difference` - if your wallet balance is too low, charge only the deficit to your saved card, then deduct. Requires a saved card."
          }
        },
        "required": [
          "paymentMethod"
        ]
      },
      "V1PayOrderResponseDto": {
        "type": "object",
        "properties": {
          "orderId": {
            "type": "string",
            "example": "AP-A1B2C3",
            "description": "Identifier of the order that was paid."
          },
          "status": {
            "type": "string",
            "example": "paid",
            "description": "Order status after successful payment. Always `paid` on a `200` response."
          },
          "topupAmountUsd": {
            "type": "number",
            "example": 50,
            "description": "Amount in USD charged to your saved card as a wallet top-up. `0` when no top-up was needed because the wallet already had sufficient funds."
          },
          "walletDebitedUsd": {
            "type": "number",
            "example": 25.5,
            "description": "Amount in USD deducted from your wallet to settle the order."
          }
        },
        "required": [
          "orderId",
          "status",
          "topupAmountUsd",
          "walletDebitedUsd"
        ]
      },
      "V1QuoteMetricsDto": {
        "type": "object",
        "properties": {
          "model_g": {
            "type": "number",
            "description": "Grams of filament in the finished part. Use this as the shipping weight; support material is removed before dispatch.",
            "example": 27.18
          },
          "total_g": {
            "type": "number",
            "description": "Grams extruded in total, including support material or purge on multi-filament plates. This is what the print consumes.",
            "example": 31.4
          },
          "print_time_s": {
            "type": "number",
            "description": "Predicted print time for one unit, in seconds.",
            "example": 6572
          },
          "prepare_time_s": {
            "type": "number",
            "description": "Machine time the plate occupies the printer before printing starts (heat-up, calibration, filament changes), in seconds. `0` when the slicer did not report it.",
            "example": 420
          },
          "filament_count": {
            "type": "object",
            "description": "Number of filaments used on the busiest plate. `1` for a single-colour print. `null` for quotes sliced before this was recorded.",
            "example": 1,
            "nullable": true
          }
        },
        "required": [
          "model_g",
          "total_g",
          "print_time_s",
          "prepare_time_s"
        ]
      },
      "V1QuotePublicResponseDto": {
        "type": "object",
        "properties": {
          "publicId": {
            "type": "string",
            "description": "Identifier for this quote. Use it to poll for results, reference the quote when creating an order, or contact support.",
            "example": "dapi_a3f9b2c1e4"
          },
          "name": {
            "type": "object",
            "description": "Optional label you assigned at creation. Purely informational - not used in processing.",
            "example": "bracket-v2",
            "nullable": true
          },
          "webhook_metadata": {
            "type": "object",
            "description": "Arbitrary key-value data you attached at creation. Echoed back unchanged in all API responses and webhook payloads.",
            "example": {
              "order_id": "ORD-123",
              "notify_slack": true
            },
            "nullable": true,
            "additionalProperties": true
          },
          "status": {
            "type": "string",
            "description": "Current processing state. Poll until `DONE` to read the price, or handle `ERROR` if the file could not be priced.",
            "enum": [
              "FILE_UPLOADED",
              "PROCESSING",
              "DONE",
              "CANCELLED",
              "ERROR"
            ],
            "example": "PROCESSING"
          },
          "result": {
            "type": "object",
            "description": "Estimated price per unit in USD, rounded to two decimal places. Populated only when `status` is `DONE`.",
            "example": 12.34,
            "nullable": true
          },
          "metrics": {
            "description": "What the slicer measured for one unit: filament weight and print time. Populated only when `status` is `DONE`; `null` while processing and after an error.",
            "nullable": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/V1QuoteMetricsDto"
              }
            ]
          },
          "store_id": {
            "type": "object",
            "description": "The store this quote belongs to, or `null` if your account does not use stores.",
            "example": "str_9f2c4a7b13d84e0fa6c5b8e21d47a903",
            "nullable": true
          },
          "errorMessage": {
            "type": "string",
            "description": "Short explanation of what went wrong. Populated only when `status` is `ERROR`.",
            "example": "We could not complete the quote for this file."
          },
          "createdAt": {
            "format": "date-time",
            "type": "string",
            "description": "ISO 8601 timestamp of when this quote was submitted.",
            "example": "2026-03-24T12:00:00.000Z"
          },
          "finishedAt": {
            "type": "object",
            "description": "ISO 8601 timestamp of when processing completed, regardless of outcome. `null` while still `PROCESSING`.",
            "example": "2026-03-24T12:05:00.000Z",
            "nullable": true
          }
        },
        "required": [
          "publicId",
          "status",
          "createdAt"
        ]
      },
      "V1QuoteStatusCheckResponse": {
        "type": "object",
        "properties": {
          "ok": {
            "type": "boolean",
            "example": true,
            "description": "Always `true` when you receive a `200` - confirms the key has access to quote endpoints."
          },
          "status": {
            "type": "string",
            "example": "pricing_access_granted",
            "description": "Access status for pricing endpoints. `pricing_access_granted` means you may submit and retrieve quotes.",
            "enum": [
              "pricing_access_granted"
            ]
          }
        },
        "required": [
          "ok",
          "status"
        ]
      },
      "V1RateLimitStatusDto": {
        "type": "object",
        "properties": {
          "limit": {
            "type": "number",
            "example": 500,
            "description": "Total requests allowed per 60-second window for this key."
          },
          "remaining": {
            "type": "number",
            "example": 498,
            "description": "Requests still available before the limit is enforced. Drops to `0` when exhausted; resets when the window expires."
          },
          "reset_at": {
            "type": "string",
            "example": "2026-03-23T12:00:00.000Z",
            "description": "ISO 8601 timestamp at which the current window expires and the counter resets to the full limit.",
            "format": "date-time"
          }
        },
        "required": [
          "limit",
          "remaining",
          "reset_at"
        ]
      },
      "V1ShippingRatesResponseDto": {
        "type": "object",
        "properties": {
          "zones": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/V1ShippingZoneResponseDto"
            }
          },
          "tiers": {
            "description": "Weight bands a parcel is priced at. The tier is set by the HEAVIEST single item, not by the summed weight of the order.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/V1ShippingTierResponseDto"
            }
          },
          "extra_small_max_grams": {
            "type": "number",
            "example": 100,
            "description": "Items under this weight are exempt from `additional_item_price`."
          },
          "flat_rate": {
            "type": "number",
            "example": 10,
            "description": "Charged when an order cannot be rated - an unweighed design, or a destination no zone covers."
          }
        },
        "required": [
          "zones",
          "tiers",
          "extra_small_max_grams",
          "flat_rate"
        ]
      },
      "V1ShippingTierResponseDto": {
        "type": "object",
        "properties": {
          "tier": {
            "type": "string",
            "example": "small",
            "enum": [
              "small",
              "medium",
              "large"
            ]
          },
          "max_grams": {
            "type": "object",
            "example": 600,
            "description": "Upper bound in grams, inclusive. `null` on the largest tier.",
            "nullable": true
          }
        },
        "required": [
          "tier",
          "max_grams"
        ]
      },
      "V1ShippingZoneResponseDto": {
        "type": "object",
        "properties": {
          "zone": {
            "type": "string",
            "example": "EU",
            "description": "Zone identifier."
          },
          "label": {
            "type": "string",
            "example": "European Union",
            "description": "Human-readable zone name."
          },
          "countries": {
            "example": [
              "AT",
              "BE",
              "DE",
              "FR"
            ],
            "description": "ISO 3166-1 alpha-2 codes covered by this zone. Empty when `catch_all` is true.",
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "unmapped_countries": {
            "example": [],
            "description": "Country names on the zone that do not map to an ISO code. Normally empty; a destination listed here still matches at order time but cannot be expressed as a code.",
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "catch_all": {
            "type": "boolean",
            "example": false,
            "description": "Whether this is the fallback zone, used for any destination no other zone lists."
          },
          "small_first_price": {
            "type": "number",
            "example": 4.5,
            "description": "First item, Small tier."
          },
          "medium_first_price": {
            "type": "number",
            "example": 7.9,
            "description": "First item, Medium tier."
          },
          "large_first_price": {
            "type": "number",
            "example": 14,
            "description": "First item, Large tier."
          },
          "additional_item_price": {
            "type": "number",
            "example": 1,
            "description": "Charged for every billable item after the first. Extra-small items are exempt."
          }
        },
        "required": [
          "zone",
          "label",
          "countries",
          "unmapped_countries",
          "catch_all",
          "small_first_price",
          "medium_first_price",
          "large_first_price",
          "additional_item_price"
        ]
      },
      "V1StoreResponseDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifier for this store. Pass it as `store_id` on quotes and orders.",
            "example": "str_9f2c4a7b13d84e0fa6c5b8e21d47a903"
          },
          "name": {
            "type": "string",
            "description": "The name you gave this storefront.",
            "example": "Clicker Shop UK"
          },
          "external_reference": {
            "type": "object",
            "description": "Your own identifier for this storefront, or `null` if you did not set one.",
            "example": "shop_uk_001",
            "nullable": true
          },
          "archived": {
            "type": "boolean",
            "description": "Whether this store is archived. An archived store keeps its history but refuses new quotes and orders.",
            "example": false
          },
          "created_at": {
            "format": "date-time",
            "type": "string",
            "description": "ISO 8601 timestamp of when this store was created.",
            "example": "2026-09-02T12:00:00.000Z"
          }
        },
        "required": [
          "id",
          "name",
          "archived",
          "created_at"
        ]
      },
      "V1UpdateStoreRequestDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "New name for this storefront.",
            "example": "Clicker Shop UK & IE",
            "maxLength": 120
          },
          "external_reference": {
            "type": "object",
            "description": "New external reference. Pass `null` to clear it. Omit to leave it unchanged.",
            "example": "shop_uk_002",
            "maxLength": 120,
            "nullable": true
          }
        }
      },
      "V1UploadFileRequestDto": {
        "type": "object",
        "properties": {
          "file_name": {
            "type": "string",
            "description": "Name of the file you are about to upload, used only to keep its extension.\n\nThe slicer picks its model loader from the file extension, so a `.3mf` stored under an `.stl` name 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.\n\nSupported: `.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.",
            "example": "bracket-v2.3mf",
            "maxLength": 255
          }
        }
      },
      "V1UploadFileResponse": {
        "type": "object",
        "properties": {
          "publicId": {
            "type": "string",
            "description": "Identifier for this quote - use it to track the quote after submitting.",
            "example": "dapi_a3f9b2c1e4"
          },
          "upload_url": {
            "type": "string",
            "description": "Pre-signed S3 URL. Send a `PUT` request with the raw STL file as the body and `Content-Type: application/octet-stream`. Max file size: 250 MB.",
            "example": "https://s3.eu-central-1.amazonaws.com/..."
          },
          "s3_key": {
            "type": "string",
            "description": "The S3 key for your uploaded file. Pass this to `POST /quotes` to start the quoting process.",
            "example": "public-api/quotes/abc-123/input/1711000000000-upload.stl"
          },
          "expires_in": {
            "type": "number",
            "description": "Number of seconds until the upload URL expires.",
            "example": 3600
          }
        },
        "required": [
          "publicId",
          "upload_url",
          "s3_key",
          "expires_in"
        ]
      }
    }
  }
}
