{"openapi":"3.1.0","info":{"title":"injectable.ai Agent Commerce API","version":"1.0.0","description":"Discover participating merchants, search exact variants, and create merchant-native cart links. A human completes checkout. No purchase or payment API."},"servers":[{"url":"https://staging.injectable.ai"}],"security":[{},{"BearerToken":[]}],"paths":{"/stores":{"get":{"operationId":"listStores","summary":"List participating merchants permitted for this client","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"stores":{"type":"array","items":{"$ref":"#/components/schemas/Store"}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid API key"},"403":{"description":"Merchant access policy denied request"},"404":{"description":"Not found"},"409":{"description":"Availability or live validation failed"},"422":{"description":"Cart adapter unavailable"},"429":{"description":"Rate limited; retry after 60 seconds"}}}},"/stores/search":{"get":{"operationId":"searchNetwork","summary":"Search participating merchants; maximum 100 combined results","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"min_price","in":"query","required":false,"schema":{"type":"number"}},{"name":"max_price","in":"query","required":false,"schema":{"type":"number"}},{"name":"currency","in":"query","required":false,"schema":{"type":"string"}},{"name":"available","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"size","in":"query","required":false,"schema":{"type":"string"}},{"name":"color","in":"query","required":false,"schema":{"type":"string"}},{"name":"attribute.material","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"products":{"type":"array","items":{"$ref":"#/components/schemas/Product"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"last_sync":{"type":["integer","null"]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid API key"},"403":{"description":"Merchant access policy denied request"},"404":{"description":"Not found"},"409":{"description":"Availability or live validation failed"},"422":{"description":"Cart adapter unavailable"},"429":{"description":"Rate limited; retry after 60 seconds"}}}},"/stores/{store_id}":{"get":{"operationId":"getStore","parameters":[{"name":"store_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Store"}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid API key"},"403":{"description":"Merchant access policy denied request"},"404":{"description":"Not found"},"409":{"description":"Availability or live validation failed"},"422":{"description":"Cart adapter unavailable"},"429":{"description":"Rate limited; retry after 60 seconds"}}}},"/stores/{store_id}/products":{"get":{"operationId":"listProducts","parameters":[{"name":"store_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"min_price","in":"query","required":false,"schema":{"type":"number"}},{"name":"max_price","in":"query","required":false,"schema":{"type":"number"}},{"name":"currency","in":"query","required":false,"schema":{"type":"string"}},{"name":"available","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"size","in":"query","required":false,"schema":{"type":"string"}},{"name":"color","in":"query","required":false,"schema":{"type":"string"}},{"name":"attribute.material","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"products":{"type":"array","items":{"$ref":"#/components/schemas/Product"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"last_sync":{"type":["integer","null"]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid API key"},"403":{"description":"Merchant access policy denied request"},"404":{"description":"Not found"},"409":{"description":"Availability or live validation failed"},"422":{"description":"Cart adapter unavailable"},"429":{"description":"Rate limited; retry after 60 seconds"}}}},"/stores/{store_id}/search":{"get":{"operationId":"searchProducts","summary":"Prices are major currency units and filter the same variant as attributes and availability","parameters":[{"name":"store_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"min_price","in":"query","required":false,"schema":{"type":"number"}},{"name":"max_price","in":"query","required":false,"schema":{"type":"number"}},{"name":"currency","in":"query","required":false,"schema":{"type":"string"}},{"name":"available","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"size","in":"query","required":false,"schema":{"type":"string"}},{"name":"color","in":"query","required":false,"schema":{"type":"string"}},{"name":"attribute.material","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"products":{"type":"array","items":{"$ref":"#/components/schemas/Product"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"last_sync":{"type":["integer","null"]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid API key"},"403":{"description":"Merchant access policy denied request"},"404":{"description":"Not found"},"409":{"description":"Availability or live validation failed"},"422":{"description":"Cart adapter unavailable"},"429":{"description":"Rate limited; retry after 60 seconds"}}}},"/stores/{store_id}/products/{product_id}":{"get":{"operationId":"getProduct","parameters":[{"name":"store_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"product_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid API key"},"403":{"description":"Merchant access policy denied request"},"404":{"description":"Not found"},"409":{"description":"Availability or live validation failed"},"422":{"description":"Cart adapter unavailable"},"429":{"description":"Rate limited; retry after 60 seconds"}}}},"/stores/{store_id}/carts":{"post":{"operationId":"createCart","summary":"Validate live availability and create a cart URL for user checkout","parameters":[{"name":"store_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"object","required":["variant_id","quantity"],"properties":{"variant_id":{"type":"string"},"quantity":{"type":"integer","minimum":1,"maximum":99}}}}}}}}},"responses":{"201":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["cart_url"],"properties":{"cart_url":{"type":"string","format":"uri"},"expires_at":{"type":["string","null"]},"strategy":{"type":"string"},"items":{"type":"array","items":{"type":"object"}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid API key"},"403":{"description":"Merchant access policy denied request"},"404":{"description":"Not found"},"409":{"description":"Availability or live validation failed"},"422":{"description":"Cart adapter unavailable"},"429":{"description":"Rate limited; retry after 60 seconds"}}}}},"components":{"securitySchemes":{"BearerToken":{"type":"http","scheme":"bearer","description":"Optional merchant-issued direct API token; scoped to one store."}},"schemas":{"Store":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"},"platform":{"type":"string"},"api_url":{"type":"string"},"last_sync":{"type":["string","null"]},"capabilities":{"type":"object","properties":{"cart":{"type":"boolean"}}}}},"Product":{"type":"object","properties":{"id":{"type":"string"},"native_id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"description":{"type":"string"},"images":{"type":"array","items":{"type":"string"}},"price":{"type":"number"},"currency":{"type":"string"},"available":{"type":"boolean"},"confidence":{"type":"string","enum":["high","low"]},"source":{"type":"string"},"variants":{"type":"array","items":{"$ref":"#/components/schemas/Variant"}}}},"Variant":{"type":"object","required":["id","native_id","price","currency","available","attributes"],"properties":{"id":{"type":"string"},"native_id":{"type":"string"},"sku":{"type":["string","null"]},"price":{"type":"number"},"currency":{"type":"string"},"available":{"type":"boolean"},"attributes":{"type":"object","additionalProperties":{"type":"string"}},"product_url":{"type":"string"}}}}}}