Get a delivered price quote
quotePrice printed items delivered to one destination. Returns quote_id, the total that the payer pays (products, shipping and VAT where AgentMade collects it), what is not included, the delivery estimate and the expiry. Needs artwork_id values from validate_artwork. Charges nothing. For a destination where orders are not open, the quote is for information only.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| buyer | No | Only for a company purchase with an invoice. Business checkout is not open yet: the quote charges destination VAT. | |
| items | Yes | ||
| speed | No | Shipping speed. Only standard is offered now; express returns a note and a standard quote. | standard |
| purpose | No | What the order is for. Set it only if the user already said it. Do not ask for it. | |
| ship_to | Yes | Destination. country_code is required; postal_code and state_code improve shipping accuracy. | |
| currency | No | ISO 4217 currency of the payer, e.g. "USD". Optional. The quote states the currency that it uses. | |
| deliver_by | No | Date by which the parcel should arrive, e.g. "2026-12-20". The quote is never refused because of it: if the estimate is later, the quote says so. | |
| preference | No | How AgentMade picks the manufacturing route: fewest_packages (default: fewest parcels, then best price among the fastest routes), cheapest, or fastest. | fewest_packages |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tax | Yes | ||
| items | Yes | ||
| notes | Yes | Things to tell the user before purchase. | |
| status | Yes | ||
| totals | Yes | total_minor is the full amount that the payer pays. Show total_formatted to the user. products_minor and shipping_minor are before VAT; tax_minor is the VAT included in the total, or 0 when tax is not collected. | |
| ship_to | Yes | ||
| currency | Yes | ||
| packages | Yes | ||
| quote_id | Yes | Use in purchase before expires_at. | |
| shipping | Yes | ||
| next_step | Yes | What the agent should do next, in plain language. | |
| expires_at | Yes | ||
| assumptions | Yes | ||
| package_count | Yes | ||
| purchase_open | Yes | False when this destination does not take orders yet or the quote expired. Then do not call purchase. | |
| delivery_estimate_dates | Yes | Calendar dates (YYYY-MM-DD) for the delivery estimate. Tell the user these dates. | |
| delivery_estimate_business_days | Yes |