{"openapi":"3.0.3","info":{"title":"InvoiceMate Partners API","version":"1.0.0","description":"Reseller partner API for InvoiceMate catalogs.\nAuthenticate with Authorization: Bearer <key_id>.<secret>.\n\nEnvironments: mk_test_* → sandbox fixture; mk_live_* → live catalog.\nSandbox fixture version: 2026.08.01 (product ids 9001–9010).\n\nDocs: https://partner.invoicemate.in/docs\nPostman: GET /api/v1/postman"},"servers":[{"url":"https://partner.invoicemate.in/api/v1"}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Format: mk_live_xxx.secret (live) or mk_test_xxx.secret (sandbox)"}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","schema":{"type":"string"},"description":"Required for reserve / one-shot create to prevent duplicates"}}},"security":[{"BearerAuth":[]}],"paths":{"/health":{"get":{"summary":"Health check","security":[],"responses":{"200":{"description":"OK"},"503":{"description":"DB down"}}}},"/me":{"get":{"summary":"Account + key environment","responses":{"200":{"description":"Me"}}}},"/usage":{"get":{"summary":"API usage for this key","responses":{"200":{"description":"Usage"}}}},"/openapi":{"get":{"summary":"This OpenAPI document","security":[],"responses":{"200":{"description":"OpenAPI 3 JSON"}}}},"/postman":{"get":{"summary":"Postman collection v2.1 export","security":[],"responses":{"200":{"description":"Postman collection JSON"}}}},"/products":{"get":{"summary":"List products","parameters":[{"name":"search","in":"query","schema":{"type":"string"}},{"name":"art_category_id","in":"query","schema":{"type":"integer"}},{"name":"category_id","in":"query","schema":{"type":"integer"}},{"name":"min_price","in":"query","schema":{"type":"number"}},{"name":"max_price","in":"query","schema":{"type":"number"}},{"name":"sort_by","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer"}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Product list"}}}},"/products/{id}":{"get":{"summary":"Get product","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Product"}}}},"/products/bulk":{"post":{"summary":"Fetch products by ids","responses":{"200":{"description":"Products"}}}},"/products/sync":{"get":{"summary":"Delta sync since cursor/timestamp","responses":{"200":{"description":"Sync payload"}}}},"/products/stats":{"get":{"summary":"Catalog stats","responses":{"200":{"description":"Stats"}}}},"/products/availability":{"post":{"summary":"Bulk availability check","responses":{"200":{"description":"Availability"}}}},"/products/{id}/availability":{"get":{"summary":"Single product availability","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Availability"}}}},"/categories":{"get":{"summary":"List categories","responses":{"200":{"description":"Categories"}}}},"/artists":{"get":{"summary":"List artists","responses":{"200":{"description":"Artists"}}}},"/filters":{"get":{"summary":"Filter facets","responses":{"200":{"description":"Filters"}}}},"/orders/quote":{"post":{"summary":"Quote line items (no stock hold)","responses":{"200":{"description":"Quote"}}}},"/orders/reserve":{"post":{"summary":"Reserve stock","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Reserved order"}}}},"/orders/{id}/confirm":{"post":{"summary":"Confirm reserved order","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Confirmed"}}}},"/orders":{"get":{"summary":"List orders","responses":{"200":{"description":"Orders"}}},"post":{"summary":"One-shot create + confirm","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"201":{"description":"Confirmed order"}}}},"/orders/{id}":{"get":{"summary":"Get order","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Order"}}}},"/orders/by-ref/{ref}":{"get":{"summary":"Get order by reseller reference","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Order"}}}},"/orders/{id}/tracking":{"get":{"summary":"Tracking info","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Tracking"}}}},"/customers":{"get":{"summary":"List customers","responses":{"200":{"description":"Customers"}}},"post":{"summary":"Upsert customer","responses":{"201":{"description":"Customer"}}}},"/customers/{id}":{"get":{"summary":"Get customer","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Customer"}}},"patch":{"summary":"Update customer","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Customer"}}}},"/customers/{id}/orders":{"get":{"summary":"Orders for customer","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Orders"}}}},"/webhooks":{"get":{"summary":"Webhook config for site","responses":{"200":{"description":"Config"}}},"post":{"summary":"Set webhook URL","responses":{"200":{"description":"Updated"}}}},"/webhooks/test":{"post":{"summary":"Send test webhook","responses":{"200":{"description":"Delivery result"}}}},"/sandbox":{"get":{"summary":"Sandbox fixture info (test keys)","description":"Fixture version 2026.08.01","responses":{"200":{"description":"Sandbox info"},"403":{"description":"Not a test key"}}}},"/sandbox/reset":{"post":{"summary":"Reset sandbox orders + stock (test keys)","responses":{"200":{"description":"Reset result"},"403":{"description":"Not a test key"}}}}},"x-scopes":["products:read","orders:read","orders:write","customers:read","customers:write","webhooks:write"],"x-sandbox-fixture-version":"2026.08.01","x-environments":{"test":{"key_prefix":"mk_test_","catalog":"Fixed fixture ids 9001-9010","fixture_version":"2026.08.01","affects_real_inventory":false,"resettable":true},"live":{"key_prefix":"mk_live_","catalog":"Full business catalog","affects_real_inventory":true,"resettable":false}}}