{"uid":"cap_uYBAT36RnVRTX2F6O4gVn","slug":"stableprint-order-submission-api-a4ea839a","name":"StablePrint Order Submission API","description":"Agent-native Prodigi print-on-demand catalog, preview, quote, and order API.","url":"https://stableprint.dev/api/orders","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["draft_id","draft_token","client_request_id","expected_total","expected_currency","confirmed_crop_proof_hashes"],"properties":{"draft_id":{"type":"string","minLength":1},"draft_token":{"type":"string","maxLength":160,"minLength":32},"expected_total":{"type":"number","minimum":0},"client_request_id":{"type":"string","pattern":"^[a-zA-Z0-9._:-]+$","maxLength":128,"minLength":8},"expected_currency":{"type":"string","const":"USD","default":"USD"},"confirmed_crop_proof_hashes":{"type":"array","items":{"type":"string","minLength":16},"minItems":1}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["order_id","status","client_request_id","item_cost","shipping_cost","branding_cost","tax_cost","reserve_cost","pricing_policy","charged_total","currency","created_at","updated_at"],"properties":{"status":{"type":"string"},"currency":{"type":"string"},"draft_id":{"type":"string"},"order_id":{"type":"string"},"tax_cost":{"type":"number","minimum":0},"item_cost":{"type":"number","minimum":0},"created_at":{"type":"string"},"updated_at":{"type":"string"},"reserve_cost":{"type":"number","minimum":0},"branding_cost":{"type":"number","minimum":0},"charged_total":{"type":"number","minimum":0},"shipping_cost":{"type":"number","minimum":0},"pricing_policy":{"type":"string"},"shipping_method":{"type":"string"},"prodigi_order_id":{"type":"string"},"client_request_id":{"type":"string"}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"status":"submitted","currency":"USD","draft_id":"draft_01JZPRINT000000000000000000","order_id":"order_01JZPRINT000000000000000000","tax_cost":1.23,"item_cost":12.34,"created_at":"2026-06-08T20:05:00.000Z","updated_at":"2026-06-08T20:05:00.000Z","branding_cost":0,"charged_total":18.13,"shipping_cost":4.56,"shipping_method":"standard","prodigi_order_id":"pdg_123456789","client_request_id":"order-example-001"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"500","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$500/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"500","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"500","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_q8j_yzm1sbwPN3fx3U-l0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"500","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Submits a confirmed print-on-demand order to Prodigi via StablePrint, converting a pre-approved draft into a live production order with itemized cost breakdown.","exampleAgentPrompt":"Submit my StablePrint draft 'draft_01JZPRINT000000000000000000' to production — the draft token is 'abcdef1234567890abcdef1234567890ab', the expected total is $18.13 USD, the client request ID is 'order-example-001', and the confirmed crop proof hash is 'a1b2c3d4e5f6g7h8'.","exampleUseCases":null,"resultDescription":"Returns a JSON object with the order status ('submitted'), a StablePrint order_id, a Prodigi prodigi_order_id, itemized costs (item_cost, shipping_cost, tax_cost, branding_cost), charged_total in USD, shipping_method, timestamps (created_at, updated_at), and the echoed client_request_id and draft_id.","failureModes":["Invalid or expired draft_token returns an authentication error","Mismatch between expected_total and server-computed total causes rejection","Invalid or unrecognized draft_id returns a not-found error","Malformed client_request_id (invalid characters or length) causes validation failure","confirmed_crop_proof_hashes mismatch with server-stored hashes causes order rejection","Duplicate client_request_id may return idempotency conflict or cached prior response","Payment of $500 USDC not received via x402 protocol causes 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you have already completed the StablePrint draft/preview/quote flow and hold a valid draft_id, draft_token, and confirmed_crop_proof_hashes, and are ready to submit the order to Prodigi for physical fulfillment. This is the final submission step, not a browsing, quoting, or preview step.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:37:06.387Z","isFirstParty":false}