{"openapi":"3.1.0","info":{"title":"Merch to Order API","version":"1.0.0","description":"Quote and place custom shirt orders. Upload artwork, pick a garment, color and sizes, and get a proof by email. Base URL https://merchtoorder.com/api/v1. Authenticate with Authorization: Bearer <key>; keys are created at https://merchtoorder.com/account/api."},"servers":[{"url":"https://merchtoorder.com/api/v1"}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}},"schemas":{"Side":{"type":"object","properties":{"artwork":{"type":"string","description":"Artwork id from POST /artwork"},"placement":{"type":"string","enum":["full","chest","center"]},"text":{"type":"string","maxLength":80},"textColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}}},"Item":{"type":"object","required":["product","sizes"],"properties":{"product":{"type":"string","enum":["classic-tee","premium-tee","hoodie","crewneck"]},"color":{"type":"string","description":"Color id or name from GET /products"},"sizes":{"type":"object","additionalProperties":{"type":"integer","minimum":1},"description":"Size id to quantity, e.g. {\"m\": 10, \"l\": 10}"},"front":{"$ref":"#/components/schemas/Side"},"back":{"$ref":"#/components/schemas/Side"}}},"ShipTo":{"type":"object","required":["name","line1","city","state","postal"],"properties":{"name":{"type":"string"},"company":{"type":"string"},"line1":{"type":"string"},"line2":{"type":"string"},"city":{"type":"string"},"state":{"type":"string","minLength":2,"maxLength":2},"postal":{"type":"string"},"phone":{"type":"string"}}},"OrderRequest":{"type":"object","required":["items","shipTo"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Item"}},"shipping":{"type":"string","enum":["standard","rush"]},"shipTo":{"$ref":"#/components/schemas/ShipTo"},"poNumber":{"type":"string","maxLength":60,"description":"Your purchase order number, printed on the confirmation and the invoice"},"notes":{"type":"string"}}},"QuoteRequest":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Item"}},"shipping":{"type":"string","enum":["standard","rush"]},"state":{"type":"string"}}}}},"paths":{"/products":{"get":{"summary":"Catalog with colors, sizes and prices","responses":{"200":{"description":"OK"}}}},"/quote":{"post":{"summary":"Price an order without placing it","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteRequest"}}}},"responses":{"200":{"description":"Quote"}}}},"/artwork":{"post":{"summary":"Upload a logo or design","security":[{"bearer":[]}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}}}},"application/json":{"schema":{"type":"object","properties":{"filename":{"type":"string"},"data":{"type":"string","description":"base64 or data: URI"}}}}}},"responses":{"201":{"description":"Artwork id"}}}},"/orders":{"get":{"summary":"List your orders","security":[{"bearer":[]}],"responses":{"200":{"description":"Orders"}}},"post":{"summary":"Place an order","security":[{"bearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderRequest"}}}},"responses":{"201":{"description":"Order placed; proof and invoice emailed within 24 hours"}}}},"/orders/{id}":{"get":{"summary":"Order status, tracking and timeline","security":[{"bearer":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Order"}}}}}}