{"openapi":"3.1.0","info":{"title":"Signature dealer API","version":"1.0.0","description":"Read-only access to your dealership's Signature account: prices, availability, orders and tracking, invoices. Keys come from the dealer portal's Integrations page. 60 requests a minute and 5,000 a day per key; pages of up to 100. Terms: https://ops.smgltd.net/legal/api"},"servers":[{"url":"https://ops.smgltd.net"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"sig_live_… from the dealer portal"}}},"paths":{"/api/v1/catalog":{"get":{"summary":"Catalog with your prices","description":"Models you can order, with your account's price, any live deal, UMRP and availability as a band (In stock, Limited, Incoming with ETA, Special order, Out).","parameters":[{"name":"q","in":"query","required":false,"description":"Search by model, brand or description; typos and missing dashes are fine","schema":{"type":"string"}},{"name":"brand","in":"query","required":false,"description":"One brand, e.g. Perlick","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"One category","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number, from 1","schema":{"type":"integer"}},{"name":"per_page","in":"query","required":false,"description":"Items per page, up to 100 (default 50)","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK. Money is whole cents, USD. Lists have data, page, perPage and hasMore."},"401":{"description":"Missing, invalid or revoked key"},"404":{"description":"Not found on your account"},"429":{"description":"Over the limit (60 requests a minute and 5,000 a day per key; pages of up to 100.); see Retry-After"}}}},"/api/v1/availability":{"get":{"summary":"Price and availability for a list of models","description":"Up to 100 models in one call, for your own website or ERP. A model we don't carry comes back with found: false.","parameters":[{"name":"models","in":"query","required":true,"description":"Comma-separated model numbers","schema":{"type":"string"}}],"responses":{"200":{"description":"OK. Money is whole cents, USD. Lists have data, page, perPage and hasMore."},"401":{"description":"Missing, invalid or revoked key"},"404":{"description":"Not found on your account"},"429":{"description":"Over the limit (60 requests a minute and 5,000 a day per key; pages of up to 100.); see Retry-After"}}}},"/api/v1/products/{model}":{"get":{"summary":"One model","description":"The catalog row plus specs, images and documents (spec sheet, installation guide, use & care, warranty).","parameters":[{"name":"model","in":"path","required":true,"description":"The model number","schema":{"type":"string"}}],"responses":{"200":{"description":"OK. Money is whole cents, USD. Lists have data, page, perPage and hasMore."},"401":{"description":"Missing, invalid or revoked key"},"404":{"description":"Not found on your account"},"429":{"description":"Over the limit (60 requests a minute and 5,000 a day per key; pages of up to 100.); see Retry-After"}}}},"/api/v1/orders":{"get":{"summary":"Your orders","description":"Newest first, each with its status in plain words: Received, Under review, Waiting on stock, On hold, In the warehouse, Ships (date), Shipped, Delivered, Complete, Cancelled.","parameters":[{"name":"since","in":"query","required":false,"description":"Only orders created on or after this date, YYYY-MM-DD","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Page number, from 1","schema":{"type":"integer"}},{"name":"per_page","in":"query","required":false,"description":"Items per page, up to 100 (default 50)","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK. Money is whole cents, USD. Lists have data, page, perPage and hasMore."},"401":{"description":"Missing, invalid or revoked key"},"404":{"description":"Not found on your account"},"429":{"description":"Over the limit (60 requests a minute and 5,000 a day per key; pages of up to 100.); see Retry-After"}}}},"/api/v1/orders/{id}":{"get":{"summary":"One order","description":"Status, lines with your prices, the shipment (carrier, PRO number, pickup, estimated delivery, tracking link, delivered) and its invoices.","parameters":[{"name":"id","in":"path","required":true,"description":"The order id from /api/v1/orders","schema":{"type":"string"}}],"responses":{"200":{"description":"OK. Money is whole cents, USD. Lists have data, page, perPage and hasMore."},"401":{"description":"Missing, invalid or revoked key"},"404":{"description":"Not found on your account"},"429":{"description":"Over the limit (60 requests a minute and 5,000 a day per key; pages of up to 100.); see Retry-After"}}}},"/api/v1/invoices":{"get":{"summary":"Your invoices and balance","description":"Invoices newest first, plus your account's open items, balance and past due.","parameters":[{"name":"page","in":"query","required":false,"description":"Page number, from 1","schema":{"type":"integer"}},{"name":"per_page","in":"query","required":false,"description":"Items per page, up to 100 (default 50)","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK. Money is whole cents, USD. Lists have data, page, perPage and hasMore."},"401":{"description":"Missing, invalid or revoked key"},"404":{"description":"Not found on your account"},"429":{"description":"Over the limit (60 requests a minute and 5,000 a day per key; pages of up to 100.); see Retry-After"}}}},"/api/v1/invoices/{id}":{"get":{"summary":"One invoice","description":"Header, bill-to and ship-to, lines, subtotal, freight and total.","parameters":[{"name":"id","in":"path","required":true,"description":"The invoice id from /api/v1/invoices","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK. Money is whole cents, USD. Lists have data, page, perPage and hasMore."},"401":{"description":"Missing, invalid or revoked key"},"404":{"description":"Not found on your account"},"429":{"description":"Over the limit (60 requests a minute and 5,000 a day per key; pages of up to 100.); see Retry-After"}}}}}}