{"openapi":"3.1.0","info":{"title":"Paddock card commerce","version":"1.0.0"},"security":[],"components":{"securitySchemes":{"orderCapability":{"type":"http","scheme":"bearer","description":"Opaque per-order order_access_token, supplied by the caller at creation or generated by the server and returned by preparation. No account or API-key setup."}}},"paths":{"/agent-commerce/uploads/{scope_id}":{"post":{"operationId":"openCustomerContent","security":[{"orderCapability":[]}],"parameters":[{"name":"scope_id","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"description":"Open a private 24-hour upload scope. Generate a UUID and fresh 43-character random base64url bearer capability; reuse both as request_id and order_access_token when preparing the order. Empty body.","responses":{"200":{"description":"Successful private content result.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"scope_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"policy_version":{"type":"string","const":"customer-print-v1"}},"required":["scope_id","expires_at","policy_version"],"additionalProperties":false}}}},"default":{"description":"Private upload error.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}},"get":{"operationId":"readCustomerContent","security":[{"orderCapability":[]}],"parameters":[{"name":"scope_id","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Successful private content result.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"scope_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","enum":["active","deleting","deleted"]},"assets":{"type":"array","items":{"type":"object","properties":{"asset_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["artwork","logo"]}},"required":["asset_id","kind"],"additionalProperties":false}},"compositions":{"type":"array","items":{"type":"object","properties":{"composition_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string","maxLength":120},"design_key":{"type":"string","pattern":"^customer_[0-9a-f-]{36}$"},"design_version":{"type":"number","const":1}},"required":["composition_id","title","design_key","design_version"],"additionalProperties":false}}},"required":["scope_id","expires_at","status","assets","compositions"],"additionalProperties":false}}}},"default":{"description":"Private upload error.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}},"delete":{"operationId":"deleteCustomerContent","security":[{"orderCapability":[]}],"parameters":[{"name":"scope_id","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"description":"Request deletion of unused content. Required files for paid open orders remain until cancellation/refund or completion and the retention period.","responses":{"200":{"description":"Successful private content result.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"accepted":{"type":"boolean","const":true},"state":{"type":"string","enum":["active","deleting","deleted"]}},"required":["accepted","state"],"additionalProperties":false}}}},"default":{"description":"Private upload error.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/agent-commerce/uploads/{scope_id}/assets/{kind}/{asset_id}":{"put":{"operationId":"uploadCustomerAsset","security":[{"orderCapability":[]}],"parameters":[{"name":"scope_id","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"kind","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["artwork","logo"]}},{"name":"asset_id","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"description":"Upload raw JPEG or PNG, at most 32 MiB, 8192 pixels per side and 40 megapixels. Files are normalized and metadata is removed. Reuse an asset UUID only with identical bytes.","requestBody":{"required":true,"content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}}}},"responses":{"200":{"description":"Successful private content result.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"asset_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["artwork","logo"]},"width":{"type":"integer","exclusiveMinimum":0,"maximum":8192},"height":{"type":"integer","exclusiveMinimum":0,"maximum":8192},"reused":{"type":"boolean"}},"required":["asset_id","kind","reused"],"additionalProperties":false}}}},"default":{"description":"Private upload error.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/agent-commerce/uploads/{scope_id}/compositions/{composition_id}":{"post":{"operationId":"composeCustomerCard","security":[{"orderCapability":[]}],"parameters":[{"name":"scope_id","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"composition_id","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"description":"Create an immutable private card from at least one artwork asset, logo asset or HTTP(S) QR destination. Only assets in this scope may be used. The returned design_key and version work in prepare_order with this scope and capability. The buyer confirms printing rights before payment.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f-\\u009f]+$"},"artwork_asset_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"logo_asset_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"qr_url":{"type":"string","maxLength":512}},"required":["title"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful private content result.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"composition_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"design_key":{"type":"string","pattern":"^customer_[0-9a-f-]{36}$"},"design_version":{"type":"number","const":1},"title":{"type":"string","maxLength":120},"low_resolution":{"type":"boolean"},"reused":{"type":"boolean"}},"required":["composition_id","design_key","design_version","title","low_resolution","reused"],"additionalProperties":false}}}},"default":{"description":"Private upload error.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/agent-commerce/uploads/{scope_id}/compositions/{composition_id}/preview":{"get":{"operationId":"previewCustomerCard","security":[{"orderCapability":[]}],"parameters":[{"name":"scope_id","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"composition_id","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Private rendered card image.","content":{"image/png":{"schema":{"type":"string","format":"binary"}}}},"default":{"description":"Private upload error.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/agent-commerce/feedback":{"post":{"operationId":"reportFeedback","description":"Optionally report a technical problem, suggestion category or neutral successful outcome using fixed choices. Never required to buy a card. Do not include personal content, credentials, links, conversations or hidden reasoning. Reports are unverified feedback, not proof of payment or mailing.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"kind":{"type":"string","enum":["problem","suggestion","success"]},"operation":{"type":"string","enum":["search_cards","prepare_order","read_order","cancel_order","checkout","connection","documentation"]},"category":{"type":"string","enum":["no_suitable_card","irrelevant_results","unclear_result","preview_unavailable","request_rejected","slow_response","unexpected_error","recovery_failed","broader_selection","clearer_results","better_recovery","simpler_checkout","faster_responses","better_documentation","completed_as_expected"]},"severity":{"type":"string","enum":["none","minor","major","blocked"]},"code":{"default":"none","description":"Reported public error code only; no provider error text.","type":"string","enum":["none","INVALID_REQUEST","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","GONE","CATALOG_ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","MESSAGE_DOES_NOT_FIT","RETURN_ADDRESS_REQUIRED","PRICE_CHANGED","QUOTE_EXPIRED","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","CANCELLATION_NOT_ALLOWED","REFUND_NOT_ELIGIBLE","SERVICE_PAUSED","TRY_LATER","UNAVAILABLE"]},"field":{"default":"none","description":"Reported field name only; never its value.","type":"string","enum":["none","design_key","design_version","format","message","recipient.mailing_address","return_address","occasion","price","printed_text","availability","preview"]}},"required":["kind","operation","category","severity","code","field"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful commerce result. Payment and each card’s fulfillment state are separate.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true},"data":{"type":"object","properties":{"status":{"type":"string","enum":["recorded","duplicate"]},"verification":{"type":"string","const":"unverified_report"}},"required":["status","verification"],"additionalProperties":false}},"required":["ok","data"],"additionalProperties":false}}}},"400":{"description":"Structured error; no successful result is included.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"request_id":{"type":"string"},"issues":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":499},"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"field":{"type":"string","enum":["design_key","design_version","message","format","message_font","include_paddock_gift","recipient","recipient.display_name","recipient.greeting_name","recipient.birthday_month","recipient.birthday_day","recipient.birthday_year","recipient.anniversary_month","recipient.anniversary_day","recipient.mailing_address","recipient.address_confirmed","recipient.origin","recipient.mailing_address.line1","recipient.mailing_address.line2","recipient.mailing_address.locality","recipient.mailing_address.region","recipient.mailing_address.postal_code","recipient.mailing_address.country_code","return_address","return_address.display_name","return_address.mailing_address","return_address.source_kind","return_address.mailing_address.line1","return_address.mailing_address.line2","return_address.mailing_address.locality","return_address.mailing_address.region","return_address.mailing_address.postal_code","return_address.mailing_address.country_code","occasion","occasion.kind","occasion.calendar","occasion.month","occasion.day","occasion.send_on"]}},"required":["index","code"],"additionalProperties":false}}},"required":["code","message","retryable","request_id"],"additionalProperties":false}},"required":["ok","error"],"additionalProperties":false}}}},"429":{"description":"Request limit reached. Retry after the Retry-After delay. No account or API key is needed.","headers":{"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"request_id":{"type":"string"},"issues":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":499},"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"field":{"type":"string","enum":["design_key","design_version","message","format","message_font","include_paddock_gift","recipient","recipient.display_name","recipient.greeting_name","recipient.birthday_month","recipient.birthday_day","recipient.birthday_year","recipient.anniversary_month","recipient.anniversary_day","recipient.mailing_address","recipient.address_confirmed","recipient.origin","recipient.mailing_address.line1","recipient.mailing_address.line2","recipient.mailing_address.locality","recipient.mailing_address.region","recipient.mailing_address.postal_code","recipient.mailing_address.country_code","return_address","return_address.display_name","return_address.mailing_address","return_address.source_kind","return_address.mailing_address.line1","return_address.mailing_address.line2","return_address.mailing_address.locality","return_address.mailing_address.region","return_address.mailing_address.postal_code","return_address.mailing_address.country_code","occasion","occasion.kind","occasion.calendar","occasion.month","occasion.day","occasion.send_on"]}},"required":["index","code"],"additionalProperties":false}}},"required":["code","message","retryable","request_id"],"additionalProperties":false}},"required":["ok","error"],"additionalProperties":false}}}},"default":{"description":"Structured error; no successful result is included.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"request_id":{"type":"string"},"issues":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":499},"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"field":{"type":"string","enum":["design_key","design_version","message","format","message_font","include_paddock_gift","recipient","recipient.display_name","recipient.greeting_name","recipient.birthday_month","recipient.birthday_day","recipient.birthday_year","recipient.anniversary_month","recipient.anniversary_day","recipient.mailing_address","recipient.address_confirmed","recipient.origin","recipient.mailing_address.line1","recipient.mailing_address.line2","recipient.mailing_address.locality","recipient.mailing_address.region","recipient.mailing_address.postal_code","recipient.mailing_address.country_code","return_address","return_address.display_name","return_address.mailing_address","return_address.source_kind","return_address.mailing_address.line1","return_address.mailing_address.line2","return_address.mailing_address.locality","return_address.mailing_address.region","return_address.mailing_address.postal_code","return_address.mailing_address.country_code","occasion","occasion.kind","occasion.calendar","occasion.month","occasion.day","occasion.send_on"]}},"required":["index","code"],"additionalProperties":false}}},"required":["code","message","retryable","request_id"],"additionalProperties":false}},"required":["ok","error"],"additionalProperties":false}}}}}}},"/agent-commerce/cards":{"get":{"operationId":"searchCards","parameters":[{"name":"query","in":"query","schema":{"type":"string","maxLength":300}},{"name":"occasion","in":"query","schema":{"type":"string","maxLength":100}},{"name":"tone","in":"query","schema":{"description":"Mood such as warm, cheerful, elegant or gentle. For funny cards, use humor instead.","type":"string","maxLength":40}},{"name":"humor","in":"query","schema":{"type":"string","enum":["any","none","light","playful","funny"]}},{"name":"kind","in":"query","schema":{"type":"string","enum":["any","standard","artist"]}},{"name":"require_printed_text","in":"query","schema":{"description":"Filter verified wording already printed in the artwork. Unknown wording does not match absent or present.","type":"string","enum":["any","absent","present"]}},{"name":"printed_text_contains","in":"query","schema":{"description":"Required phrase in verified artwork lettering, matched without case sensitivity. This does not search the customizable message.","type":"string","minLength":1,"maxLength":200}},{"name":"format","in":"query","schema":{"description":"Postcard, flat card in an envelope, or folded card in an envelope. Omit to select flat_card_in_envelope.","type":"string","enum":["postcard","flat_card_in_envelope","folded_card_in_envelope"]}},{"name":"max_price_cents","in":"query","schema":{"description":"Budget per card for the selected format at the destination’s prices.","type":"integer","minimum":0,"maximum":1000000}},{"name":"destination_country","in":"query","schema":{"description":"Recipient country as a two-letter ISO code, such as US or CA. Prices depend on it: US addresses have agent-channel introductory prices and other countries the standard prices. Omit it to see US prices with each format’s other-destination amount listed; the prepared order prices every card by its own recipient address.","type":"string","pattern":"^[A-Z]{2}$"}},{"name":"artist","in":"query","schema":{"type":"string","maxLength":120}},{"name":"limit","in":"query","schema":{"default":12,"type":"integer","minimum":1,"maximum":50}},{"name":"cursor","in":"query","schema":{"type":"string","pattern":"^(?:\\d{1,6})?$"}},{"name":"include_specs","in":"query","schema":{"description":"Include available paper, finish and envelope details. Basic format specifications are always returned. A missing detail is unspecified.","type":"boolean"}}],"responses":{"200":{"description":"Successful commerce result. Payment and each card’s fulfillment state are separate.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true},"data":{"type":"object","properties":{"schema_version":{"type":"number","const":1},"catalog_revision":{"type":"integer","minimum":0,"maximum":9007199254740991},"complete":{"type":"boolean"},"generated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"next_cursor":{"type":["string","null"]},"constraints":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"detail":{"type":"string"}},"required":["code","detail"],"additionalProperties":false}},"unmet":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"detail":{"type":"string"}},"required":["code","detail"],"additionalProperties":false}},"query":{"type":"object","properties":{"normalized":{"type":"object","properties":{"query":{"type":["string","null"]},"occasion":{"type":["string","null"]},"tone":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}]},"humor":{"anyOf":[{"type":"string","enum":["any","none","light","playful","funny"]},{"type":"null"}]},"format":{"type":"string","enum":["postcard","flat_card_in_envelope","folded_card_in_envelope"]},"artist":{"type":["string","null"]},"kind":{"type":"string","enum":["any","standard","artist"]},"max_total_cents":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"destination_country":{"type":["string","null"]},"require_printed_text":{"type":"string","enum":["any","absent","present"]},"printed_text_contains":{"type":["string","null"]},"limit":{"type":"integer","minimum":1,"maximum":50}},"required":["query","occasion","tone","humor","format","artist","kind","max_total_cents","destination_country","require_printed_text","printed_text_contains","limit"],"additionalProperties":false},"occasion_resolved":{"type":["string","null"]},"artist_resolved":{"type":["string","null"]}},"required":["normalized","occasion_resolved","artist_resolved"],"additionalProperties":false},"pricing_destination":{"type":"object","properties":{"scope":{"type":"string","enum":["US","international"]},"country_code":{"type":["string","null"]},"introductory":{"type":"boolean"},"assumed":{"type":"boolean"}},"required":["scope","country_code","introductory","assumed"],"additionalProperties":false},"results":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"card":{"type":"object","properties":{"card_id":{"type":"string"},"kind":{"type":"string","enum":["standard","artist"]},"design":{"type":"object","properties":{"key":{"type":"string"},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["key","version"],"additionalProperties":false},"title":{"type":"string"},"subtitle":{"type":["string","null"]},"primary_occasion":{"type":"string"},"occasions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"scheduling":{"type":"string","enum":["one_off","personal_annual","calendar"]},"design_key":{"type":"string"}},"required":["id","title","scheduling","design_key"],"additionalProperties":false}},"description":{"type":"object","properties":{"status":{"type":"string","enum":["available","unknown"]},"text":{"type":["string","null"]}},"required":["status","text"],"additionalProperties":false},"printed_text":{"type":"object","properties":{"status":{"type":"string","enum":["verified_absent","verified_present","unknown"]},"text":{"type":["string","null"]},"note":{"type":["string","null"]}},"required":["status","text","note"],"additionalProperties":false},"tone":{"type":"array","items":{"type":"string","enum":["warm","cheerful","playful","elegant","calm","gentle","romantic","festive","nostalgic","whimsical","sincere","celebratory","serene","bold"]}},"humor":{"type":"string","enum":["none","light","playful","unknown"]},"subjects":{"type":"array","items":{"type":"string"}},"palette":{"type":"array","items":{"type":"string"}},"contains_people":{"type":["boolean","null"]},"contains_animals":{"type":["boolean","null"]},"attribution":{"type":"object","properties":{"kind":{"type":"string","enum":["paddock","artist"]},"artist_name":{"type":["string","null"]},"artist_slug":{"type":["string","null"]},"artist_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"credit":{"type":"string"}},"required":["kind","artist_name","artist_slug","artist_url","credit"],"additionalProperties":false},"images":{"type":"object","properties":{"display":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"],"additionalProperties":false},"thumbnail":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"],"additionalProperties":false}},"required":["display"],"additionalProperties":false},"formats":{"type":"array","items":{"type":"object","properties":{"format":{"type":"string","enum":["postcard","flat_card_in_envelope","folded_card_in_envelope"]},"amount_cents":{"type":"integer","minimum":0,"maximum":9007199254740991},"currency":{"type":"string","const":"usd"},"fulfillment_ready":{"type":"boolean"},"orderable":{"type":"boolean"},"unavailability_reason":{"anyOf":[{"type":"string","enum":["CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","CATALOG_ARTWORK_UNAVAILABLE","OFFER_EXPIRED","AVAILABILITY_UNVERIFIED"]},{"type":"null"}]},"price_includes":{"type":"object","properties":{"postage":{"type":"boolean"},"tax":{"type":"boolean"}},"required":["postage","tax"],"additionalProperties":false},"destination_scope":{"type":"string","enum":["US","international"]},"introductory":{"type":"boolean"},"amount_cents_by_destination":{"type":"object","propertyNames":{"type":"string","enum":["US","international"]},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}}},"required":["format","amount_cents","currency","fulfillment_ready","orderable","unavailability_reason","price_includes","destination_scope","introductory","amount_cents_by_destination"],"additionalProperties":false}},"from_amount_cents":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"currency":{"type":"string","const":"usd"}},"required":["card_id","kind","design","title","subtitle","primary_occasion","occasions","description","printed_text","tone","humor","subjects","palette","contains_people","contains_animals","attribution","images","formats","from_amount_cents","currency"],"additionalProperties":false},"selected_format":{"anyOf":[{"type":"string","enum":["postcard","flat_card_in_envelope","folded_card_in_envelope"]},{"type":"null"}]},"total_cents":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"score":{"type":"number"},"match_reasons":{"type":"array","items":{"type":"string"}}},"required":["card","selected_format","total_cents","score","match_reasons"],"additionalProperties":false}},"format_specs":{"type":"object","properties":{"version":{"type":"string","minLength":1,"maxLength":60},"unit":{"type":"string","const":"in"},"detail":{"type":"string","enum":["basic","full"]},"unspecified_means":{"type":"string"},"formats":{"type":"object","propertyNames":{"type":"string","enum":["postcard","flat_card_in_envelope","folded_card_in_envelope"]},"additionalProperties":{"anyOf":[{"type":"object","properties":{"version":{"type":"string","minLength":1,"maxLength":60},"format":{"type":"string","enum":["postcard","flat_card_in_envelope","folded_card_in_envelope"]},"title":{"type":"string"},"paper":{"type":"string","description":"Card stock by its confirmed basis-weight designation."},"size_in":{"type":"object","properties":{"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["width","height"],"additionalProperties":false,"description":"Finished size in inches; the closed size for the folded card."},"open_size_in":{"description":"Folded card only: size when opened.","type":"object","properties":{"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["width","height"],"additionalProperties":false},"artwork_surface":{"type":"string","enum":["front","front cover"]},"message_surface":{"type":"string","description":"Where Paddock prints the personal message."},"envelope_included":{"type":"boolean"},"paper_detail":{"type":"object","properties":{"basis_weight":{"type":"string"},"finish":{"description":"Absent until confirmed for the stock in use.","type":"string"},"color":{"description":"Absent until confirmed for the stock in use.","type":"string"},"gsm":{"description":"Manufacturer-stated grammage; absent when unknown.","type":"number","exclusiveMinimum":0},"caliper_in":{"description":"Measured sheet thickness in inches; absent when unknown.","type":"number","exclusiveMinimum":0}},"required":["basis_weight"],"additionalProperties":false},"envelope":{"description":"Present only for formats mailed in an envelope.","type":"object","properties":{"size_in":{"type":"object","properties":{"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["width","height"],"additionalProperties":false},"addressing":{"type":"string"}},"required":["size_in","addressing"],"additionalProperties":false},"personalization":{"type":"object","properties":{"fonts":{"minItems":1,"type":"array","items":{"type":"string"}},"automatic_greeting":{"type":"string"},"max_message_chars":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit_check":{"type":"string"}},"required":["fonts","automatic_greeting","max_message_chars","fit_check"],"additionalProperties":false},"printed_text":{"type":"string"}},"required":["version","format","title","paper","size_in","artwork_surface","message_surface","envelope_included","paper_detail","personalization","printed_text"],"additionalProperties":false},{"type":"object","properties":{"version":{"type":"string","minLength":1,"maxLength":60},"format":{"type":"string","enum":["postcard","flat_card_in_envelope","folded_card_in_envelope"]},"title":{"type":"string"},"paper":{"type":"string","description":"Card stock by its confirmed basis-weight designation."},"size_in":{"type":"object","properties":{"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["width","height"],"additionalProperties":false,"description":"Finished size in inches; the closed size for the folded card."},"open_size_in":{"description":"Folded card only: size when opened.","type":"object","properties":{"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["width","height"],"additionalProperties":false},"artwork_surface":{"type":"string","enum":["front","front cover"]},"message_surface":{"type":"string","description":"Where Paddock prints the personal message."},"envelope_included":{"type":"boolean"}},"required":["version","format","title","paper","size_in","artwork_surface","message_surface","envelope_included"],"additionalProperties":false}]},"required":["postcard","flat_card_in_envelope","folded_card_in_envelope"]}},"required":["version","unit","detail","unspecified_means","formats"],"additionalProperties":false,"description":"Physical specifications per format, stated once per response. A property that is absent is unspecified."}},"required":["schema_version","catalog_revision","complete","generated_at","total","next_cursor","constraints","unmet","query","pricing_destination","results","format_specs"],"additionalProperties":false}},"required":["ok","data"],"additionalProperties":false}}}},"429":{"description":"Request limit reached. Retry after the Retry-After delay. No account or API key is needed.","headers":{"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"request_id":{"type":"string"},"issues":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":499},"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"field":{"type":"string","enum":["design_key","design_version","message","format","message_font","include_paddock_gift","recipient","recipient.display_name","recipient.greeting_name","recipient.birthday_month","recipient.birthday_day","recipient.birthday_year","recipient.anniversary_month","recipient.anniversary_day","recipient.mailing_address","recipient.address_confirmed","recipient.origin","recipient.mailing_address.line1","recipient.mailing_address.line2","recipient.mailing_address.locality","recipient.mailing_address.region","recipient.mailing_address.postal_code","recipient.mailing_address.country_code","return_address","return_address.display_name","return_address.mailing_address","return_address.source_kind","return_address.mailing_address.line1","return_address.mailing_address.line2","return_address.mailing_address.locality","return_address.mailing_address.region","return_address.mailing_address.postal_code","return_address.mailing_address.country_code","occasion","occasion.kind","occasion.calendar","occasion.month","occasion.day","occasion.send_on"]}},"required":["index","code"],"additionalProperties":false}}},"required":["code","message","retryable","request_id"],"additionalProperties":false}},"required":["ok","error"],"additionalProperties":false}}}},"default":{"description":"Structured error; no successful result is included.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"request_id":{"type":"string"},"issues":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":499},"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"field":{"type":"string","enum":["design_key","design_version","message","format","message_font","include_paddock_gift","recipient","recipient.display_name","recipient.greeting_name","recipient.birthday_month","recipient.birthday_day","recipient.birthday_year","recipient.anniversary_month","recipient.anniversary_day","recipient.mailing_address","recipient.address_confirmed","recipient.origin","recipient.mailing_address.line1","recipient.mailing_address.line2","recipient.mailing_address.locality","recipient.mailing_address.region","recipient.mailing_address.postal_code","recipient.mailing_address.country_code","return_address","return_address.display_name","return_address.mailing_address","return_address.source_kind","return_address.mailing_address.line1","return_address.mailing_address.line2","return_address.mailing_address.locality","return_address.mailing_address.region","return_address.mailing_address.postal_code","return_address.mailing_address.country_code","occasion","occasion.kind","occasion.calendar","occasion.month","occasion.day","occasion.send_on"]}},"required":["index","code"],"additionalProperties":false}}},"required":["code","message","retryable","request_id"],"additionalProperties":false}},"required":["ok","error"],"additionalProperties":false}}}}}}},"/agent-commerce/orders":{"post":{"operationId":"prepareOrder","description":"Prepare one purchase of 1–500 explicit cards, with any mix of artwork, format, recipient, message, occasion and date. Never group by occasion. One card uses this same path and one review/payment covers the exact current per-card sum. The body limit is 4 MiB. Initial preparation needs no account. Optionally generate and privately store 32 cryptographically random bytes encoded as 43 base64url characters, then supply that fresh capability in Authorization: Bearer on the first request. Repeat the same request_id, capability and unchanged cards to recover a lost response. If omitted, the server generates and returns the token. An ID alone never recovers a private purchase or replaces its token. Validation issues use zero-based card indices.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"request_id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"cards":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"design_key":{"type":"string","minLength":1,"maxLength":160},"design_version":{"type":"integer","exclusiveMinimum":0,"maximum":2147483646},"message":{"type":"string","maxLength":4000,"description":"Body of the personal message, at most 2000 Unicode characters. Paddock prints the greeting \"Dear {greeting_name or display_name},\" above it automatically, so do not start the message with a salutation. Printed artwork wording is separate."},"format":{"description":"Postcard, flat card in an envelope, or folded card in an envelope. Omit to select flat_card_in_envelope.","type":"string","enum":["postcard","flat_card_in_envelope","folded_card_in_envelope"]},"message_font":{"type":"string","enum":["serif","sans_serif","old_school","handwriting"]},"include_paddock_gift":{"description":"Include a complimentary personalized Paddock bookmark. For eligible new envelope orders, omission includes it; set false to opt out. The bookmark has the chosen artwork, a gift message naming the sender, and a unique QR code for one free card, including artist cards. Read the order’s returned paddock_gift: included, and omission_reason when it is not included. Explain it when useful or asked; no separate question or announcement is needed.","type":"boolean"},"recipient":{"type":"object","properties":{"display_name":{"type":"string","maxLength":240,"description":"Name on the envelope or address panel."},"greeting_name":{"description":"Name printed in the automatic greeting, such as Ida for \"Dear Ida,\". Defaults to display_name.","type":"string","maxLength":240},"birthday_month":{"default":0,"type":"integer","minimum":0,"maximum":12},"birthday_day":{"default":0,"type":"integer","minimum":0,"maximum":31},"birthday_year":{"anyOf":[{"type":"integer","minimum":1,"maximum":9999},{"type":"null"}]},"anniversary_month":{"type":"integer","minimum":0,"maximum":12},"anniversary_day":{"type":"integer","minimum":0,"maximum":31},"mailing_address":{"type":"object","properties":{"line1":{"type":"string","maxLength":320},"line2":{"default":"","description":"Optional second line, such as an apartment or suite. Omitted means empty.","type":"string","maxLength":320},"locality":{"type":"string","maxLength":320},"region":{"type":"string","maxLength":160},"postal_code":{"type":"string","maxLength":48},"country_code":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["line1","locality","region","postal_code","country_code"],"additionalProperties":false},"address_confirmed":{"type":"boolean","const":true},"origin":{"type":"string","const":"manual"}},"required":["display_name","mailing_address","address_confirmed","origin"],"additionalProperties":false},"return_address":{"type":"object","properties":{"display_name":{"type":"string","maxLength":240},"mailing_address":{"type":"object","properties":{"line1":{"type":"string","maxLength":320},"line2":{"default":"","description":"Optional second line, such as an apartment or suite. Omitted means empty.","type":"string","maxLength":320},"locality":{"type":"string","maxLength":320},"region":{"type":"string","maxLength":160},"postal_code":{"type":"string","maxLength":48},"country_code":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["line1","locality","region","postal_code","country_code"],"additionalProperties":false},"source_kind":{"type":"string","const":"manual"}},"required":["display_name","mailing_address","source_kind"],"additionalProperties":false,"description":"Required for every card format: the sender’s name and return mailing address supplied by the buyer. Not automatically obtained from billing details."},"occasion":{"description":"Optional occasion and timing context, independent of the selected artwork. Omit for an ordinary just-because card.","type":"object","properties":{"kind":{"type":"string","minLength":1,"maxLength":100,"description":"Exact catalog occasion ID, such as birthday, thank_you or just_because. Use just_because with send_on for a one-time mailing date. Use underscores, not display labels or hyphens."},"calendar":{"type":"string","const":"us-western-v1"},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31},"send_on":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["kind","calendar"],"additionalProperties":false}},"required":["design_key","design_version","message","recipient","return_address"],"additionalProperties":false,"description":"One manual guest card. Each card may have its own artwork, format, message, recipient, optional occasion and timing. Existing destination/calendar rules apply. No member, Property, recipient, card or calendar-event IDs."},"description":"One purchase containing 1–500 explicit card compositions in their supplied order. Mix any supported designs, formats, messages, recipients, occasions and dates. Do not group purchases by occasion. One card uses this same array."}},"required":["request_id","cards"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful commerce result. Payment and each card’s fulfillment state are separate.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true},"data":{"type":"object","properties":{"order":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"state":{"type":"string","enum":["prepared","checkout_pending","paid","cancel_requested","cancelled"]},"payment_state":{"type":"string","enum":["unpaid","pending","paid","failed","expired","refunding","refunded"]},"refund_state":{"type":"string","enum":["none","pending","partial","succeeded","failed","unknown"]},"amount_cents":{"type":"integer","minimum":0,"maximum":9007199254740991},"currency":{"type":"string","const":"usd"},"card_count":{"type":"integer","minimum":1,"maximum":500},"tax_ready_count":{"type":"integer","minimum":0,"maximum":500},"quote_expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"checkout_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cards":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"state":{"type":"string","enum":["prepared","checkout_pending","paid","cancel_requested","cancelled"]},"payment_state":{"type":"string","enum":["unpaid","pending","paid","failed","expired","refunding","refunded"]},"refund_state":{"type":"string","enum":["none","pending","processing","succeeded","failed","unknown"]},"refund_review_reason":{"type":["string","null"]},"tax_review_reason":{"type":["string","null"]},"input":{"type":"object","properties":{"design_key":{"type":"string","minLength":1,"maxLength":160},"design_version":{"type":"integer","exclusiveMinimum":0,"maximum":2147483646},"message":{"type":"string","maxLength":4000,"description":"Body of the personal message, at most 2000 Unicode characters. Paddock prints the greeting \"Dear {greeting_name or display_name},\" above it automatically, so do not start the message with a salutation. Printed artwork wording is separate."},"format":{"description":"Postcard, flat card in an envelope, or folded card in an envelope. Omit to select flat_card_in_envelope.","type":"string","enum":["postcard","flat_card_in_envelope","folded_card_in_envelope"]},"message_font":{"type":"string","enum":["serif","sans_serif","old_school","handwriting"]},"include_paddock_gift":{"description":"Include a complimentary personalized Paddock bookmark. For eligible new envelope orders, omission includes it; set false to opt out. The bookmark has the chosen artwork, a gift message naming the sender, and a unique QR code for one free card, including artist cards. Read the order’s returned paddock_gift: included, and omission_reason when it is not included. Explain it when useful or asked; no separate question or announcement is needed.","type":"boolean"},"recipient":{"type":"object","properties":{"display_name":{"type":"string","maxLength":240,"description":"Name on the envelope or address panel."},"greeting_name":{"description":"Name printed in the automatic greeting, such as Ida for \"Dear Ida,\". Defaults to display_name.","type":"string","maxLength":240},"birthday_month":{"type":"integer","minimum":0,"maximum":12},"birthday_day":{"type":"integer","minimum":0,"maximum":31},"birthday_year":{"anyOf":[{"type":"integer","minimum":1,"maximum":9999},{"type":"null"}]},"anniversary_month":{"type":"integer","minimum":0,"maximum":12},"anniversary_day":{"type":"integer","minimum":0,"maximum":31},"mailing_address":{"type":"object","properties":{"line1":{"type":"string","maxLength":320},"line2":{"type":"string","maxLength":320},"locality":{"type":"string","maxLength":320},"region":{"type":"string","maxLength":160},"postal_code":{"type":"string","maxLength":48},"country_code":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["line1","line2","locality","region","postal_code","country_code"],"additionalProperties":false},"address_confirmed":{"type":"boolean","const":true},"origin":{"type":"string","const":"manual"}},"required":["display_name","birthday_month","birthday_day","mailing_address","address_confirmed","origin"],"additionalProperties":false},"return_address":{"type":"object","properties":{"display_name":{"type":"string","maxLength":240},"mailing_address":{"type":"object","properties":{"line1":{"type":"string","maxLength":320},"line2":{"type":"string","maxLength":320},"locality":{"type":"string","maxLength":320},"region":{"type":"string","maxLength":160},"postal_code":{"type":"string","maxLength":48},"country_code":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["line1","line2","locality","region","postal_code","country_code"],"additionalProperties":false},"source_kind":{"type":"string","const":"manual"}},"required":["display_name","mailing_address","source_kind"],"additionalProperties":false},"occasion":{"description":"Optional occasion and timing context, independent of the selected artwork. Omit for an ordinary just-because card.","type":"object","properties":{"kind":{"type":"string","minLength":1,"maxLength":100,"description":"Exact catalog occasion ID, such as birthday, thank_you or just_because. Use just_because with send_on for a one-time mailing date. Use underscores, not display labels or hyphens."},"calendar":{"type":"string","const":"us-western-v1"},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31},"send_on":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["kind","calendar"],"additionalProperties":false}},"required":["design_key","design_version","message","recipient"],"additionalProperties":false},"schedule":{"type":"object","properties":{"one_off":{"type":"boolean","const":true},"time_zone":{"type":"string"},"birthday_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"send_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"collection_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"arrival_start":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"arrival_end":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"edit_deadline":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"post_by":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"estimate_basis":{"type":"string"},"late":{"type":"boolean"},"leap_day_observed":{"type":"boolean"},"next_year":{"type":"boolean"}},"required":["time_zone","birthday_date","send_date","collection_date","arrival_start","arrival_end","edit_deadline","post_by","estimate_basis","late","leap_day_observed","next_year"],"additionalProperties":false},"amount_cents":{"type":"integer","minimum":0,"maximum":9007199254740991},"currency":{"type":"string","const":"usd"},"offer_version":{"type":"string"},"terms_version":{"type":"string"},"title":{"type":"string"},"artist_name":{"type":["string","null"]},"quote_expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"product_spec":{"type":"object","properties":{"version":{"type":"string","minLength":1,"maxLength":60},"format":{"type":"string","enum":["postcard","flat_card_in_envelope","folded_card_in_envelope"]},"title":{"type":"string"},"paper":{"type":"string","description":"Card stock by its confirmed basis-weight designation."},"size_in":{"type":"object","properties":{"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["width","height"],"additionalProperties":false,"description":"Finished size in inches; the closed size for the folded card."},"open_size_in":{"description":"Folded card only: size when opened.","type":"object","properties":{"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["width","height"],"additionalProperties":false},"artwork_surface":{"type":"string","enum":["front","front cover"]},"message_surface":{"type":"string","description":"Where Paddock prints the personal message."},"envelope_included":{"type":"boolean"},"paper_detail":{"type":"object","properties":{"basis_weight":{"type":"string"},"finish":{"description":"Absent until confirmed for the stock in use.","type":"string"},"color":{"description":"Absent until confirmed for the stock in use.","type":"string"},"gsm":{"description":"Manufacturer-stated grammage; absent when unknown.","type":"number","exclusiveMinimum":0},"caliper_in":{"description":"Measured sheet thickness in inches; absent when unknown.","type":"number","exclusiveMinimum":0}},"required":["basis_weight"],"additionalProperties":false},"envelope":{"description":"Present only for formats mailed in an envelope.","type":"object","properties":{"size_in":{"type":"object","properties":{"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["width","height"],"additionalProperties":false},"addressing":{"type":"string"}},"required":["size_in","addressing"],"additionalProperties":false},"personalization":{"type":"object","properties":{"fonts":{"minItems":1,"type":"array","items":{"type":"string"}},"automatic_greeting":{"type":"string"},"max_message_chars":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit_check":{"type":"string"}},"required":["fonts","automatic_greeting","max_message_chars","fit_check"],"additionalProperties":false},"printed_text":{"type":"string"}},"required":["version","format","title","paper","size_in","artwork_surface","message_surface","envelope_included","paper_detail","personalization","printed_text"],"additionalProperties":false},"paddock_gift":{"type":"object","properties":{"included":{"type":"boolean"},"omission_reason":{"anyOf":[{"type":"string","enum":["declined","no_envelope","international_delivery","offer_unavailable","not_selected"]},{"type":"null"}]}},"required":["included","omission_reason"],"additionalProperties":false},"fulfillment_status":{"anyOf":[{"type":"string","enum":["scheduled","preparing","ready","mailed","cancel_requested","cancelled"]},{"type":"null"}]},"mailed_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"cancellable":{"type":"boolean"}},"required":["id","revision","state","payment_state","refund_state","refund_review_reason","tax_review_reason","input","schedule","amount_cents","currency","offer_version","terms_version","title","artist_name","quote_expires_at","paddock_gift","fulfillment_status","mailed_at","cancellable"],"additionalProperties":false}},"customer_content":{"type":"object","properties":{"rights_required":{"type":"boolean"},"rights_accepted":{"type":"boolean"},"terms_version":{"type":"string","const":"customer-print-v1"}},"required":["rights_required","rights_accepted","terms_version"],"additionalProperties":false}},"required":["id","revision","state","payment_state","refund_state","amount_cents","currency","card_count","tax_ready_count","quote_expires_at","checkout_url","cards"],"additionalProperties":false},"order_access_token":{"type":"string","pattern":"^[A-Za-z0-9_-]{43}$"},"review_url":{"type":"string","format":"uri"},"reused":{"type":"boolean"},"payment_required":{"type":"boolean"}},"required":["order","order_access_token","review_url"],"additionalProperties":false}},"required":["ok","data"],"additionalProperties":false}}}},"400":{"description":"Structured error; no successful result is included.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"request_id":{"type":"string"},"issues":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":499},"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"field":{"type":"string","enum":["design_key","design_version","message","format","message_font","include_paddock_gift","recipient","recipient.display_name","recipient.greeting_name","recipient.birthday_month","recipient.birthday_day","recipient.birthday_year","recipient.anniversary_month","recipient.anniversary_day","recipient.mailing_address","recipient.address_confirmed","recipient.origin","recipient.mailing_address.line1","recipient.mailing_address.line2","recipient.mailing_address.locality","recipient.mailing_address.region","recipient.mailing_address.postal_code","recipient.mailing_address.country_code","return_address","return_address.display_name","return_address.mailing_address","return_address.source_kind","return_address.mailing_address.line1","return_address.mailing_address.line2","return_address.mailing_address.locality","return_address.mailing_address.region","return_address.mailing_address.postal_code","return_address.mailing_address.country_code","occasion","occasion.kind","occasion.calendar","occasion.month","occasion.day","occasion.send_on"]}},"required":["index","code"],"additionalProperties":false}}},"required":["code","message","retryable","request_id"],"additionalProperties":false}},"required":["ok","error"],"additionalProperties":false}}}},"409":{"description":"Structured error; no successful result is included.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"request_id":{"type":"string"},"issues":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":499},"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"field":{"type":"string","enum":["design_key","design_version","message","format","message_font","include_paddock_gift","recipient","recipient.display_name","recipient.greeting_name","recipient.birthday_month","recipient.birthday_day","recipient.birthday_year","recipient.anniversary_month","recipient.anniversary_day","recipient.mailing_address","recipient.address_confirmed","recipient.origin","recipient.mailing_address.line1","recipient.mailing_address.line2","recipient.mailing_address.locality","recipient.mailing_address.region","recipient.mailing_address.postal_code","recipient.mailing_address.country_code","return_address","return_address.display_name","return_address.mailing_address","return_address.source_kind","return_address.mailing_address.line1","return_address.mailing_address.line2","return_address.mailing_address.locality","return_address.mailing_address.region","return_address.mailing_address.postal_code","return_address.mailing_address.country_code","occasion","occasion.kind","occasion.calendar","occasion.month","occasion.day","occasion.send_on"]}},"required":["index","code"],"additionalProperties":false}}},"required":["code","message","retryable","request_id"],"additionalProperties":false}},"required":["ok","error"],"additionalProperties":false}}}},"413":{"description":"Structured error; no successful result is included.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"request_id":{"type":"string"},"issues":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":499},"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"field":{"type":"string","enum":["design_key","design_version","message","format","message_font","include_paddock_gift","recipient","recipient.display_name","recipient.greeting_name","recipient.birthday_month","recipient.birthday_day","recipient.birthday_year","recipient.anniversary_month","recipient.anniversary_day","recipient.mailing_address","recipient.address_confirmed","recipient.origin","recipient.mailing_address.line1","recipient.mailing_address.line2","recipient.mailing_address.locality","recipient.mailing_address.region","recipient.mailing_address.postal_code","recipient.mailing_address.country_code","return_address","return_address.display_name","return_address.mailing_address","return_address.source_kind","return_address.mailing_address.line1","return_address.mailing_address.line2","return_address.mailing_address.locality","return_address.mailing_address.region","return_address.mailing_address.postal_code","return_address.mailing_address.country_code","occasion","occasion.kind","occasion.calendar","occasion.month","occasion.day","occasion.send_on"]}},"required":["index","code"],"additionalProperties":false}}},"required":["code","message","retryable","request_id"],"additionalProperties":false}},"required":["ok","error"],"additionalProperties":false}}}},"429":{"description":"Request limit reached. Retry after the Retry-After delay. No account or API key is needed.","headers":{"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"request_id":{"type":"string"},"issues":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":499},"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"field":{"type":"string","enum":["design_key","design_version","message","format","message_font","include_paddock_gift","recipient","recipient.display_name","recipient.greeting_name","recipient.birthday_month","recipient.birthday_day","recipient.birthday_year","recipient.anniversary_month","recipient.anniversary_day","recipient.mailing_address","recipient.address_confirmed","recipient.origin","recipient.mailing_address.line1","recipient.mailing_address.line2","recipient.mailing_address.locality","recipient.mailing_address.region","recipient.mailing_address.postal_code","recipient.mailing_address.country_code","return_address","return_address.display_name","return_address.mailing_address","return_address.source_kind","return_address.mailing_address.line1","return_address.mailing_address.line2","return_address.mailing_address.locality","return_address.mailing_address.region","return_address.mailing_address.postal_code","return_address.mailing_address.country_code","occasion","occasion.kind","occasion.calendar","occasion.month","occasion.day","occasion.send_on"]}},"required":["index","code"],"additionalProperties":false}}},"required":["code","message","retryable","request_id"],"additionalProperties":false}},"required":["ok","error"],"additionalProperties":false}}}},"default":{"description":"Structured error; no successful result is included.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"request_id":{"type":"string"},"issues":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":499},"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"field":{"type":"string","enum":["design_key","design_version","message","format","message_font","include_paddock_gift","recipient","recipient.display_name","recipient.greeting_name","recipient.birthday_month","recipient.birthday_day","recipient.birthday_year","recipient.anniversary_month","recipient.anniversary_day","recipient.mailing_address","recipient.address_confirmed","recipient.origin","recipient.mailing_address.line1","recipient.mailing_address.line2","recipient.mailing_address.locality","recipient.mailing_address.region","recipient.mailing_address.postal_code","recipient.mailing_address.country_code","return_address","return_address.display_name","return_address.mailing_address","return_address.source_kind","return_address.mailing_address.line1","return_address.mailing_address.line2","return_address.mailing_address.locality","return_address.mailing_address.region","return_address.mailing_address.postal_code","return_address.mailing_address.country_code","occasion","occasion.kind","occasion.calendar","occasion.month","occasion.day","occasion.send_on"]}},"required":["index","code"],"additionalProperties":false}}},"required":["code","message","retryable","request_id"],"additionalProperties":false}},"required":["ok","error"],"additionalProperties":false}}}}}}},"/agent-commerce/orders/{order_id}":{"get":{"operationId":"readOrder","security":[{"orderCapability":[]}],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"responses":{"200":{"description":"Successful commerce result. Payment and each card’s fulfillment state are separate.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true},"data":{"type":"object","properties":{"order":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"state":{"type":"string","enum":["prepared","checkout_pending","paid","cancel_requested","cancelled"]},"payment_state":{"type":"string","enum":["unpaid","pending","paid","failed","expired","refunding","refunded"]},"refund_state":{"type":"string","enum":["none","pending","partial","succeeded","failed","unknown"]},"amount_cents":{"type":"integer","minimum":0,"maximum":9007199254740991},"currency":{"type":"string","const":"usd"},"card_count":{"type":"integer","minimum":1,"maximum":500},"tax_ready_count":{"type":"integer","minimum":0,"maximum":500},"quote_expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"checkout_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cards":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"state":{"type":"string","enum":["prepared","checkout_pending","paid","cancel_requested","cancelled"]},"payment_state":{"type":"string","enum":["unpaid","pending","paid","failed","expired","refunding","refunded"]},"refund_state":{"type":"string","enum":["none","pending","processing","succeeded","failed","unknown"]},"refund_review_reason":{"type":["string","null"]},"tax_review_reason":{"type":["string","null"]},"input":{"type":"object","properties":{"design_key":{"type":"string","minLength":1,"maxLength":160},"design_version":{"type":"integer","exclusiveMinimum":0,"maximum":2147483646},"message":{"type":"string","maxLength":4000,"description":"Body of the personal message, at most 2000 Unicode characters. Paddock prints the greeting \"Dear {greeting_name or display_name},\" above it automatically, so do not start the message with a salutation. Printed artwork wording is separate."},"format":{"description":"Postcard, flat card in an envelope, or folded card in an envelope. Omit to select flat_card_in_envelope.","type":"string","enum":["postcard","flat_card_in_envelope","folded_card_in_envelope"]},"message_font":{"type":"string","enum":["serif","sans_serif","old_school","handwriting"]},"include_paddock_gift":{"description":"Include a complimentary personalized Paddock bookmark. For eligible new envelope orders, omission includes it; set false to opt out. The bookmark has the chosen artwork, a gift message naming the sender, and a unique QR code for one free card, including artist cards. Read the order’s returned paddock_gift: included, and omission_reason when it is not included. Explain it when useful or asked; no separate question or announcement is needed.","type":"boolean"},"recipient":{"type":"object","properties":{"display_name":{"type":"string","maxLength":240,"description":"Name on the envelope or address panel."},"greeting_name":{"description":"Name printed in the automatic greeting, such as Ida for \"Dear Ida,\". Defaults to display_name.","type":"string","maxLength":240},"birthday_month":{"type":"integer","minimum":0,"maximum":12},"birthday_day":{"type":"integer","minimum":0,"maximum":31},"birthday_year":{"anyOf":[{"type":"integer","minimum":1,"maximum":9999},{"type":"null"}]},"anniversary_month":{"type":"integer","minimum":0,"maximum":12},"anniversary_day":{"type":"integer","minimum":0,"maximum":31},"mailing_address":{"type":"object","properties":{"line1":{"type":"string","maxLength":320},"line2":{"type":"string","maxLength":320},"locality":{"type":"string","maxLength":320},"region":{"type":"string","maxLength":160},"postal_code":{"type":"string","maxLength":48},"country_code":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["line1","line2","locality","region","postal_code","country_code"],"additionalProperties":false},"address_confirmed":{"type":"boolean","const":true},"origin":{"type":"string","const":"manual"}},"required":["display_name","birthday_month","birthday_day","mailing_address","address_confirmed","origin"],"additionalProperties":false},"return_address":{"type":"object","properties":{"display_name":{"type":"string","maxLength":240},"mailing_address":{"type":"object","properties":{"line1":{"type":"string","maxLength":320},"line2":{"type":"string","maxLength":320},"locality":{"type":"string","maxLength":320},"region":{"type":"string","maxLength":160},"postal_code":{"type":"string","maxLength":48},"country_code":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["line1","line2","locality","region","postal_code","country_code"],"additionalProperties":false},"source_kind":{"type":"string","const":"manual"}},"required":["display_name","mailing_address","source_kind"],"additionalProperties":false},"occasion":{"description":"Optional occasion and timing context, independent of the selected artwork. Omit for an ordinary just-because card.","type":"object","properties":{"kind":{"type":"string","minLength":1,"maxLength":100,"description":"Exact catalog occasion ID, such as birthday, thank_you or just_because. Use just_because with send_on for a one-time mailing date. Use underscores, not display labels or hyphens."},"calendar":{"type":"string","const":"us-western-v1"},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31},"send_on":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["kind","calendar"],"additionalProperties":false}},"required":["design_key","design_version","message","recipient"],"additionalProperties":false},"schedule":{"type":"object","properties":{"one_off":{"type":"boolean","const":true},"time_zone":{"type":"string"},"birthday_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"send_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"collection_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"arrival_start":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"arrival_end":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"edit_deadline":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"post_by":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"estimate_basis":{"type":"string"},"late":{"type":"boolean"},"leap_day_observed":{"type":"boolean"},"next_year":{"type":"boolean"}},"required":["time_zone","birthday_date","send_date","collection_date","arrival_start","arrival_end","edit_deadline","post_by","estimate_basis","late","leap_day_observed","next_year"],"additionalProperties":false},"amount_cents":{"type":"integer","minimum":0,"maximum":9007199254740991},"currency":{"type":"string","const":"usd"},"offer_version":{"type":"string"},"terms_version":{"type":"string"},"title":{"type":"string"},"artist_name":{"type":["string","null"]},"quote_expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"product_spec":{"type":"object","properties":{"version":{"type":"string","minLength":1,"maxLength":60},"format":{"type":"string","enum":["postcard","flat_card_in_envelope","folded_card_in_envelope"]},"title":{"type":"string"},"paper":{"type":"string","description":"Card stock by its confirmed basis-weight designation."},"size_in":{"type":"object","properties":{"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["width","height"],"additionalProperties":false,"description":"Finished size in inches; the closed size for the folded card."},"open_size_in":{"description":"Folded card only: size when opened.","type":"object","properties":{"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["width","height"],"additionalProperties":false},"artwork_surface":{"type":"string","enum":["front","front cover"]},"message_surface":{"type":"string","description":"Where Paddock prints the personal message."},"envelope_included":{"type":"boolean"},"paper_detail":{"type":"object","properties":{"basis_weight":{"type":"string"},"finish":{"description":"Absent until confirmed for the stock in use.","type":"string"},"color":{"description":"Absent until confirmed for the stock in use.","type":"string"},"gsm":{"description":"Manufacturer-stated grammage; absent when unknown.","type":"number","exclusiveMinimum":0},"caliper_in":{"description":"Measured sheet thickness in inches; absent when unknown.","type":"number","exclusiveMinimum":0}},"required":["basis_weight"],"additionalProperties":false},"envelope":{"description":"Present only for formats mailed in an envelope.","type":"object","properties":{"size_in":{"type":"object","properties":{"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["width","height"],"additionalProperties":false},"addressing":{"type":"string"}},"required":["size_in","addressing"],"additionalProperties":false},"personalization":{"type":"object","properties":{"fonts":{"minItems":1,"type":"array","items":{"type":"string"}},"automatic_greeting":{"type":"string"},"max_message_chars":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit_check":{"type":"string"}},"required":["fonts","automatic_greeting","max_message_chars","fit_check"],"additionalProperties":false},"printed_text":{"type":"string"}},"required":["version","format","title","paper","size_in","artwork_surface","message_surface","envelope_included","paper_detail","personalization","printed_text"],"additionalProperties":false},"paddock_gift":{"type":"object","properties":{"included":{"type":"boolean"},"omission_reason":{"anyOf":[{"type":"string","enum":["declined","no_envelope","international_delivery","offer_unavailable","not_selected"]},{"type":"null"}]}},"required":["included","omission_reason"],"additionalProperties":false},"fulfillment_status":{"anyOf":[{"type":"string","enum":["scheduled","preparing","ready","mailed","cancel_requested","cancelled"]},{"type":"null"}]},"mailed_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"cancellable":{"type":"boolean"}},"required":["id","revision","state","payment_state","refund_state","refund_review_reason","tax_review_reason","input","schedule","amount_cents","currency","offer_version","terms_version","title","artist_name","quote_expires_at","paddock_gift","fulfillment_status","mailed_at","cancellable"],"additionalProperties":false}},"customer_content":{"type":"object","properties":{"rights_required":{"type":"boolean"},"rights_accepted":{"type":"boolean"},"terms_version":{"type":"string","const":"customer-print-v1"}},"required":["rights_required","rights_accepted","terms_version"],"additionalProperties":false}},"required":["id","revision","state","payment_state","refund_state","amount_cents","currency","card_count","tax_ready_count","quote_expires_at","checkout_url","cards"],"additionalProperties":false}},"required":["order"],"additionalProperties":false}},"required":["ok","data"],"additionalProperties":false}}}},"401":{"description":"Structured error; no successful result is included.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"request_id":{"type":"string"},"issues":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":499},"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"field":{"type":"string","enum":["design_key","design_version","message","format","message_font","include_paddock_gift","recipient","recipient.display_name","recipient.greeting_name","recipient.birthday_month","recipient.birthday_day","recipient.birthday_year","recipient.anniversary_month","recipient.anniversary_day","recipient.mailing_address","recipient.address_confirmed","recipient.origin","recipient.mailing_address.line1","recipient.mailing_address.line2","recipient.mailing_address.locality","recipient.mailing_address.region","recipient.mailing_address.postal_code","recipient.mailing_address.country_code","return_address","return_address.display_name","return_address.mailing_address","return_address.source_kind","return_address.mailing_address.line1","return_address.mailing_address.line2","return_address.mailing_address.locality","return_address.mailing_address.region","return_address.mailing_address.postal_code","return_address.mailing_address.country_code","occasion","occasion.kind","occasion.calendar","occasion.month","occasion.day","occasion.send_on"]}},"required":["index","code"],"additionalProperties":false}}},"required":["code","message","retryable","request_id"],"additionalProperties":false}},"required":["ok","error"],"additionalProperties":false}}}},"429":{"description":"Request limit reached. Retry after the Retry-After delay. No account or API key is needed.","headers":{"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"request_id":{"type":"string"},"issues":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":499},"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"field":{"type":"string","enum":["design_key","design_version","message","format","message_font","include_paddock_gift","recipient","recipient.display_name","recipient.greeting_name","recipient.birthday_month","recipient.birthday_day","recipient.birthday_year","recipient.anniversary_month","recipient.anniversary_day","recipient.mailing_address","recipient.address_confirmed","recipient.origin","recipient.mailing_address.line1","recipient.mailing_address.line2","recipient.mailing_address.locality","recipient.mailing_address.region","recipient.mailing_address.postal_code","recipient.mailing_address.country_code","return_address","return_address.display_name","return_address.mailing_address","return_address.source_kind","return_address.mailing_address.line1","return_address.mailing_address.line2","return_address.mailing_address.locality","return_address.mailing_address.region","return_address.mailing_address.postal_code","return_address.mailing_address.country_code","occasion","occasion.kind","occasion.calendar","occasion.month","occasion.day","occasion.send_on"]}},"required":["index","code"],"additionalProperties":false}}},"required":["code","message","retryable","request_id"],"additionalProperties":false}},"required":["ok","error"],"additionalProperties":false}}}},"default":{"description":"Structured error; no successful result is included.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"request_id":{"type":"string"},"issues":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":499},"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"field":{"type":"string","enum":["design_key","design_version","message","format","message_font","include_paddock_gift","recipient","recipient.display_name","recipient.greeting_name","recipient.birthday_month","recipient.birthday_day","recipient.birthday_year","recipient.anniversary_month","recipient.anniversary_day","recipient.mailing_address","recipient.address_confirmed","recipient.origin","recipient.mailing_address.line1","recipient.mailing_address.line2","recipient.mailing_address.locality","recipient.mailing_address.region","recipient.mailing_address.postal_code","recipient.mailing_address.country_code","return_address","return_address.display_name","return_address.mailing_address","return_address.source_kind","return_address.mailing_address.line1","return_address.mailing_address.line2","return_address.mailing_address.locality","return_address.mailing_address.region","return_address.mailing_address.postal_code","return_address.mailing_address.country_code","occasion","occasion.kind","occasion.calendar","occasion.month","occasion.day","occasion.send_on"]}},"required":["index","code"],"additionalProperties":false}}},"required":["code","message","retryable","request_id"],"additionalProperties":false}},"required":["ok","error"],"additionalProperties":false}}}}}}},"/agent-commerce/orders/{order_id}/cancel":{"post":{"operationId":"cancelOrder","security":[{"orderCapability":[]}],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"expected_revision":{"type":"integer","exclusiveMinimum":0,"maximum":2147483646},"card_ids":{"description":"Omit to cancel the whole eligible purchase. For a paid purchase, list the returned card IDs to cancel only those eligible items. The service verifies every ID belongs to this order.","minItems":1,"maxItems":500,"type":"array","items":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}}},"required":["expected_revision"],"additionalProperties":false}}}},"responses":{"200":{"description":"Successful commerce result. Payment and each card’s fulfillment state are separate.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":true},"data":{"type":"object","properties":{"order":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"state":{"type":"string","enum":["prepared","checkout_pending","paid","cancel_requested","cancelled"]},"payment_state":{"type":"string","enum":["unpaid","pending","paid","failed","expired","refunding","refunded"]},"refund_state":{"type":"string","enum":["none","pending","partial","succeeded","failed","unknown"]},"amount_cents":{"type":"integer","minimum":0,"maximum":9007199254740991},"currency":{"type":"string","const":"usd"},"card_count":{"type":"integer","minimum":1,"maximum":500},"tax_ready_count":{"type":"integer","minimum":0,"maximum":500},"quote_expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"checkout_url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"cards":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"revision":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"state":{"type":"string","enum":["prepared","checkout_pending","paid","cancel_requested","cancelled"]},"payment_state":{"type":"string","enum":["unpaid","pending","paid","failed","expired","refunding","refunded"]},"refund_state":{"type":"string","enum":["none","pending","processing","succeeded","failed","unknown"]},"refund_review_reason":{"type":["string","null"]},"tax_review_reason":{"type":["string","null"]},"input":{"type":"object","properties":{"design_key":{"type":"string","minLength":1,"maxLength":160},"design_version":{"type":"integer","exclusiveMinimum":0,"maximum":2147483646},"message":{"type":"string","maxLength":4000,"description":"Body of the personal message, at most 2000 Unicode characters. Paddock prints the greeting \"Dear {greeting_name or display_name},\" above it automatically, so do not start the message with a salutation. Printed artwork wording is separate."},"format":{"description":"Postcard, flat card in an envelope, or folded card in an envelope. Omit to select flat_card_in_envelope.","type":"string","enum":["postcard","flat_card_in_envelope","folded_card_in_envelope"]},"message_font":{"type":"string","enum":["serif","sans_serif","old_school","handwriting"]},"include_paddock_gift":{"description":"Include a complimentary personalized Paddock bookmark. For eligible new envelope orders, omission includes it; set false to opt out. The bookmark has the chosen artwork, a gift message naming the sender, and a unique QR code for one free card, including artist cards. Read the order’s returned paddock_gift: included, and omission_reason when it is not included. Explain it when useful or asked; no separate question or announcement is needed.","type":"boolean"},"recipient":{"type":"object","properties":{"display_name":{"type":"string","maxLength":240,"description":"Name on the envelope or address panel."},"greeting_name":{"description":"Name printed in the automatic greeting, such as Ida for \"Dear Ida,\". Defaults to display_name.","type":"string","maxLength":240},"birthday_month":{"type":"integer","minimum":0,"maximum":12},"birthday_day":{"type":"integer","minimum":0,"maximum":31},"birthday_year":{"anyOf":[{"type":"integer","minimum":1,"maximum":9999},{"type":"null"}]},"anniversary_month":{"type":"integer","minimum":0,"maximum":12},"anniversary_day":{"type":"integer","minimum":0,"maximum":31},"mailing_address":{"type":"object","properties":{"line1":{"type":"string","maxLength":320},"line2":{"type":"string","maxLength":320},"locality":{"type":"string","maxLength":320},"region":{"type":"string","maxLength":160},"postal_code":{"type":"string","maxLength":48},"country_code":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["line1","line2","locality","region","postal_code","country_code"],"additionalProperties":false},"address_confirmed":{"type":"boolean","const":true},"origin":{"type":"string","const":"manual"}},"required":["display_name","birthday_month","birthday_day","mailing_address","address_confirmed","origin"],"additionalProperties":false},"return_address":{"type":"object","properties":{"display_name":{"type":"string","maxLength":240},"mailing_address":{"type":"object","properties":{"line1":{"type":"string","maxLength":320},"line2":{"type":"string","maxLength":320},"locality":{"type":"string","maxLength":320},"region":{"type":"string","maxLength":160},"postal_code":{"type":"string","maxLength":48},"country_code":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["line1","line2","locality","region","postal_code","country_code"],"additionalProperties":false},"source_kind":{"type":"string","const":"manual"}},"required":["display_name","mailing_address","source_kind"],"additionalProperties":false},"occasion":{"description":"Optional occasion and timing context, independent of the selected artwork. Omit for an ordinary just-because card.","type":"object","properties":{"kind":{"type":"string","minLength":1,"maxLength":100,"description":"Exact catalog occasion ID, such as birthday, thank_you or just_because. Use just_because with send_on for a one-time mailing date. Use underscores, not display labels or hyphens."},"calendar":{"type":"string","const":"us-western-v1"},"month":{"type":"integer","minimum":1,"maximum":12},"day":{"type":"integer","minimum":1,"maximum":31},"send_on":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["kind","calendar"],"additionalProperties":false}},"required":["design_key","design_version","message","recipient"],"additionalProperties":false},"schedule":{"type":"object","properties":{"one_off":{"type":"boolean","const":true},"time_zone":{"type":"string"},"birthday_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"send_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"collection_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"arrival_start":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"arrival_end":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"edit_deadline":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"post_by":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"estimate_basis":{"type":"string"},"late":{"type":"boolean"},"leap_day_observed":{"type":"boolean"},"next_year":{"type":"boolean"}},"required":["time_zone","birthday_date","send_date","collection_date","arrival_start","arrival_end","edit_deadline","post_by","estimate_basis","late","leap_day_observed","next_year"],"additionalProperties":false},"amount_cents":{"type":"integer","minimum":0,"maximum":9007199254740991},"currency":{"type":"string","const":"usd"},"offer_version":{"type":"string"},"terms_version":{"type":"string"},"title":{"type":"string"},"artist_name":{"type":["string","null"]},"quote_expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"product_spec":{"type":"object","properties":{"version":{"type":"string","minLength":1,"maxLength":60},"format":{"type":"string","enum":["postcard","flat_card_in_envelope","folded_card_in_envelope"]},"title":{"type":"string"},"paper":{"type":"string","description":"Card stock by its confirmed basis-weight designation."},"size_in":{"type":"object","properties":{"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["width","height"],"additionalProperties":false,"description":"Finished size in inches; the closed size for the folded card."},"open_size_in":{"description":"Folded card only: size when opened.","type":"object","properties":{"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["width","height"],"additionalProperties":false},"artwork_surface":{"type":"string","enum":["front","front cover"]},"message_surface":{"type":"string","description":"Where Paddock prints the personal message."},"envelope_included":{"type":"boolean"},"paper_detail":{"type":"object","properties":{"basis_weight":{"type":"string"},"finish":{"description":"Absent until confirmed for the stock in use.","type":"string"},"color":{"description":"Absent until confirmed for the stock in use.","type":"string"},"gsm":{"description":"Manufacturer-stated grammage; absent when unknown.","type":"number","exclusiveMinimum":0},"caliper_in":{"description":"Measured sheet thickness in inches; absent when unknown.","type":"number","exclusiveMinimum":0}},"required":["basis_weight"],"additionalProperties":false},"envelope":{"description":"Present only for formats mailed in an envelope.","type":"object","properties":{"size_in":{"type":"object","properties":{"width":{"type":"number","exclusiveMinimum":0},"height":{"type":"number","exclusiveMinimum":0}},"required":["width","height"],"additionalProperties":false},"addressing":{"type":"string"}},"required":["size_in","addressing"],"additionalProperties":false},"personalization":{"type":"object","properties":{"fonts":{"minItems":1,"type":"array","items":{"type":"string"}},"automatic_greeting":{"type":"string"},"max_message_chars":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"fit_check":{"type":"string"}},"required":["fonts","automatic_greeting","max_message_chars","fit_check"],"additionalProperties":false},"printed_text":{"type":"string"}},"required":["version","format","title","paper","size_in","artwork_surface","message_surface","envelope_included","paper_detail","personalization","printed_text"],"additionalProperties":false},"paddock_gift":{"type":"object","properties":{"included":{"type":"boolean"},"omission_reason":{"anyOf":[{"type":"string","enum":["declined","no_envelope","international_delivery","offer_unavailable","not_selected"]},{"type":"null"}]}},"required":["included","omission_reason"],"additionalProperties":false},"fulfillment_status":{"anyOf":[{"type":"string","enum":["scheduled","preparing","ready","mailed","cancel_requested","cancelled"]},{"type":"null"}]},"mailed_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"cancellable":{"type":"boolean"}},"required":["id","revision","state","payment_state","refund_state","refund_review_reason","tax_review_reason","input","schedule","amount_cents","currency","offer_version","terms_version","title","artist_name","quote_expires_at","paddock_gift","fulfillment_status","mailed_at","cancellable"],"additionalProperties":false}},"customer_content":{"type":"object","properties":{"rights_required":{"type":"boolean"},"rights_accepted":{"type":"boolean"},"terms_version":{"type":"string","const":"customer-print-v1"}},"required":["rights_required","rights_accepted","terms_version"],"additionalProperties":false}},"required":["id","revision","state","payment_state","refund_state","amount_cents","currency","card_count","tax_ready_count","quote_expires_at","checkout_url","cards"],"additionalProperties":false}},"required":["order"],"additionalProperties":false}},"required":["ok","data"],"additionalProperties":false}}}},"409":{"description":"Structured error; no successful result is included.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"request_id":{"type":"string"},"issues":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":499},"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"field":{"type":"string","enum":["design_key","design_version","message","format","message_font","include_paddock_gift","recipient","recipient.display_name","recipient.greeting_name","recipient.birthday_month","recipient.birthday_day","recipient.birthday_year","recipient.anniversary_month","recipient.anniversary_day","recipient.mailing_address","recipient.address_confirmed","recipient.origin","recipient.mailing_address.line1","recipient.mailing_address.line2","recipient.mailing_address.locality","recipient.mailing_address.region","recipient.mailing_address.postal_code","recipient.mailing_address.country_code","return_address","return_address.display_name","return_address.mailing_address","return_address.source_kind","return_address.mailing_address.line1","return_address.mailing_address.line2","return_address.mailing_address.locality","return_address.mailing_address.region","return_address.mailing_address.postal_code","return_address.mailing_address.country_code","occasion","occasion.kind","occasion.calendar","occasion.month","occasion.day","occasion.send_on"]}},"required":["index","code"],"additionalProperties":false}}},"required":["code","message","retryable","request_id"],"additionalProperties":false}},"required":["ok","error"],"additionalProperties":false}}}},"429":{"description":"Request limit reached. Retry after the Retry-After delay. No account or API key is needed.","headers":{"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"request_id":{"type":"string"},"issues":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":499},"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"field":{"type":"string","enum":["design_key","design_version","message","format","message_font","include_paddock_gift","recipient","recipient.display_name","recipient.greeting_name","recipient.birthday_month","recipient.birthday_day","recipient.birthday_year","recipient.anniversary_month","recipient.anniversary_day","recipient.mailing_address","recipient.address_confirmed","recipient.origin","recipient.mailing_address.line1","recipient.mailing_address.line2","recipient.mailing_address.locality","recipient.mailing_address.region","recipient.mailing_address.postal_code","recipient.mailing_address.country_code","return_address","return_address.display_name","return_address.mailing_address","return_address.source_kind","return_address.mailing_address.line1","return_address.mailing_address.line2","return_address.mailing_address.locality","return_address.mailing_address.region","return_address.mailing_address.postal_code","return_address.mailing_address.country_code","occasion","occasion.kind","occasion.calendar","occasion.month","occasion.day","occasion.send_on"]}},"required":["index","code"],"additionalProperties":false}}},"required":["code","message","retryable","request_id"],"additionalProperties":false}},"required":["ok","error"],"additionalProperties":false}}}},"default":{"description":"Structured error; no successful result is included.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"request_id":{"type":"string"},"issues":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":499},"code":{"type":"string","enum":["INVALID_REQUEST","UNAUTHORIZED","CARD_COUNT_LIMIT","REQUEST_TOO_LARGE","CARD_VALIDATION_FAILED","NOT_FOUND","CONFLICT","UNPAID_BATCH_CHANGE_REQUIRED","PREPARE_ALREADY_EXISTS","GONE","CATALOG_ARTWORK_UNAVAILABLE","ARTWORK_UNAVAILABLE","CARD_SAMPLE_ACCEPTANCE_REQUIRED","CARD_ARTWORK_ACCEPTANCE_REQUIRED","ARTIST_PRINT_SETUP_REQUIRED","MESSAGE_DOES_NOT_FIT","PRINT_UNSUPPORTED_GLYPH","RETURN_ADDRESS_REQUIRED","CUSTOMER_RIGHTS_REQUIRED","DESTINATION_INVALID","DESTINATION_SUSPENDED","DESTINATION_REVIEW_REQUIRED","BIRTHDAY_PAST","SERVICE_PAUSED","SERVICE_UNAVAILABLE","PAYMENT_UNAVAILABLE","CHECKOUT_UNAVAILABLE","PRICE_CHANGED","CONTENT_UNAVAILABLE","EDIT_CLOSED","ALREADY_MAILED","REFUND_NOT_ELIGIBLE","SEND_DATE_MISSED","POSTAL_REVIEW_REQUIRED","QUOTE_EXPIRED","CANCELLATION_NOT_ALLOWED","TRY_LATER","UNAVAILABLE"]},"field":{"type":"string","enum":["design_key","design_version","message","format","message_font","include_paddock_gift","recipient","recipient.display_name","recipient.greeting_name","recipient.birthday_month","recipient.birthday_day","recipient.birthday_year","recipient.anniversary_month","recipient.anniversary_day","recipient.mailing_address","recipient.address_confirmed","recipient.origin","recipient.mailing_address.line1","recipient.mailing_address.line2","recipient.mailing_address.locality","recipient.mailing_address.region","recipient.mailing_address.postal_code","recipient.mailing_address.country_code","return_address","return_address.display_name","return_address.mailing_address","return_address.source_kind","return_address.mailing_address.line1","return_address.mailing_address.line2","return_address.mailing_address.locality","return_address.mailing_address.region","return_address.mailing_address.postal_code","return_address.mailing_address.country_code","occasion","occasion.kind","occasion.calendar","occasion.month","occasion.day","occasion.send_on"]}},"required":["index","code"],"additionalProperties":false}}},"required":["code","message","retryable","request_id"],"additionalProperties":false}},"required":["ok","error"],"additionalProperties":false}}}}}}}}}