{"openapi":"3.1.0","info":{"title":"flipagent API","description":"The API to resell on eBay for AI agents. Every resource lives under `/v1/<resource>`, returns cents-int Money, ISO timestamps, lowercase status enums, and a `marketplace` discriminator. Auth is `X-API-Key` or `Authorization: Bearer`.","version":"0.0.1","contact":{"name":"flipagent","url":"https://flipagent.dev","email":"hello@flipagent.dev"},"license":{"name":"FSL-1.1-ALv2","url":"https://fsl.software/FSL-1.1-ALv2.template.md"}},"servers":[{"url":"https://api.flipagent.dev","description":"Production"}],"tags":[{"name":"Items","description":"Marketplace listings — search active or sold, get one."},{"name":"Listings","description":"Sell-side listing lifecycle (create / update / end / relist)."},{"name":"Evaluate","description":"Composite same-product score: fetch → search sold + active → LLM filter → score."},{"name":"Keys","description":"Issue, inspect, and revoke flipagent API keys."},{"name":"Billing","description":"Stripe-backed paid tier upgrades."},{"name":"Compliance","description":"Seller opt-out and ToS hygiene."},{"name":"System","description":"Service health."}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key"},"bearerToken":{"type":"http","scheme":"bearer","bearerFormat":"flipagent API key (fa_*)"}},"schemas":{}},"security":[{"apiKey":[]},{"bearerToken":[]}],"paths":{"/":{"get":{"responses":{"200":{"description":"Manifest of available paths.","content":{"application/json":{"schema":{"type":"object","required":["name","docs","ebay_compatible","paths"],"properties":{"name":{"type":"string"},"docs":{"type":"string"},"ebay_compatible":{"type":"boolean"},"paths":{"type":"array","items":{"type":"string"}}}}}}}},"operationId":"getIndex","tags":["System"],"parameters":[],"summary":"Service descriptor","security":[]}},"/healthz":{"get":{"responses":{"200":{"description":"Service healthy.","content":{"application/json":{"schema":{"type":"object","required":["status","db","proxy","latencyMs","version","ts"],"properties":{"status":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["degraded"]}]},"db":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"error":{"type":"string"}}},"proxy":{"anyOf":[{"type":"string","enum":["configured"]},{"type":"string","enum":["missing"]}]},"latencyMs":{"type":"integer"},"version":{"type":"string"},"ts":{"format":"date-time","type":"string"}}}}}},"503":{"description":"Degraded — DB unreachable.","content":{"application/json":{"schema":{"type":"object","required":["status","db","proxy","latencyMs","version","ts"],"properties":{"status":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["degraded"]}]},"db":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"error":{"type":"string"}}},"proxy":{"anyOf":[{"type":"string","enum":["configured"]},{"type":"string","enum":["missing"]}]},"latencyMs":{"type":"integer"},"version":{"type":"string"},"ts":{"format":"date-time","type":"string"}}}}}}},"operationId":"getHealthz","tags":["System"],"parameters":[],"summary":"Liveness + Postgres ping","security":[]}},"/v1/items/check-compatibility":{"post":{"responses":{"200":{"description":"Compatibility.","content":{"application/json":{"schema":{"type":"object","required":["compatible"],"properties":{"compatible":{"type":"boolean"},"warnings":{"type":"array","items":{"type":"string"}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1ItemsCheck-compatibility","tags":["Items"],"parameters":[],"summary":"Check parts/motors compatibility for an item","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["itemId","compatibilityProperties"],"properties":{"itemId":{"type":"string"},"compatibilityProperties":{"minItems":1,"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}}}}}}}}}}},"/v1/items/search-by-image":{"post":{"responses":{"200":{"description":"Items.","content":{"application/json":{"schema":{"type":"object","required":["limit","offset","items"],"properties":{"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"next":{"anyOf":[{"type":"string","nullable":true}]},"items":{"type":"array","items":{"type":"object","required":["id","marketplace","status","title","url","images"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["sold"]},{"type":"string","enum":["ended"]}]},"title":{"type":"string"},"url":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"condition":{"description":"Human-readable: 'New', 'Used', etc.","type":"string"},"conditionId":{"description":"eBay-style numeric id, kept for filtering.","type":"string"},"seller":{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"images":{"description":"Image URLs in seller-supplied order. First is primary.","type":"array","items":{"type":"string"}},"category":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"path":{"description":"Slash-joined breadcrumb if known.","type":"string"}}},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Flat key→value map.","type":"object","additionalProperties":true},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["auction"]},{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["best_offer"]}]}},"endsAt":{"description":"ISO 8601 listing end time.","type":"string"},"createdAt":{"description":"ISO 8601 listing creation time.","type":"string"},"watchCount":{"minimum":0,"type":"integer"},"bidding":{"type":"object","required":["count"],"properties":{"count":{"minimum":0,"type":"integer"},"currentBid":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"availableQuantity":{"minimum":0,"description":"Live stock remaining on the listing. Absent when eBay hides the count (e.g. 'More than 10 available') or for auctions.","type":"integer"},"soldQuantity":{"minimum":0,"description":"Rolling units shipped on this listing. Browse REST `estimatedSoldQuantity` for active, `totalSoldQuantity` for sold comps.","type":"integer"},"soldAt":{"description":"ISO 8601 sold/closed time.","type":"string"},"soldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","properties":{"cost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"free":{"type":"boolean"},"estimatedDeliveryFrom":{"type":"string"},"estimatedDeliveryTo":{"type":"string"},"shipsTo":{"type":"array","items":{"description":"Country codes, region names, or eBay region ids.","type":"string"}},"shipsToExcluded":{"type":"array","items":{"type":"string"}}}},"location":{"type":"object","properties":{"city":{"type":"string"},"region":{"type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"}}},"epid":{"description":"eBay catalog product id.","type":"string"},"gtin":{"description":"UPC / EAN / ISBN.","type":"string"},"mpn":{"description":"Manufacturer part number.","type":"string"},"groupId":{"type":"string"},"marketingPrice":{"type":"object","properties":{"originalPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountAmount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountPercentage":{"type":"string"},"priceTreatment":{"description":"STRIKETHROUGH | LIST_PRICE | MINIMUM_ADVERTISED_PRICE | MARKDOWN","type":"string"}}},"returnTerms":{"type":"object","properties":{"accepted":{"type":"boolean"},"periodDays":{"minimum":0,"type":"integer"},"shippingCostPayer":{"anyOf":[{"type":"string","enum":["buyer"]},{"type":"string","enum":["seller"]}]},"refundMethod":{"type":"string"},"returnMethod":{"type":"string"}}},"paymentMethods":{"description":"WALLET | CREDIT_CARD | …","type":"array","items":{"type":"string"}},"conditionDescriptors":{"type":"array","items":{"type":"object","required":["name","values"],"properties":{"name":{"description":"e.g. 'Professional Grader' or 'Grade'.","type":"string"},"values":{"type":"array","items":{"type":"string"}}}}},"topRatedBuyingExperience":{"type":"boolean"},"authenticityGuarantee":{"type":"boolean"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"},"qualifiedPrograms":{"description":"EBAY_REFURBISHED | AUTHENTICITY_GUARANTEE | …","type":"array","items":{"type":"string"}},"lotSize":{"minimum":0,"type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1ItemsSearch-by-image","tags":["Items"],"parameters":[],"summary":"Image-based item search","description":"Wraps Buy Browse `search_by_image`. Body carries a base64-encoded image; response is the same `ItemSearchResponse` as keyword `/search`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["image"],"properties":{"image":{"description":"Base64-encoded image bytes (no data: prefix).","type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"country":{"minLength":2,"maxLength":2,"type":"string"},"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"}}}}}}}},"/v1/items/search":{"get":{"responses":{"200":{"description":"Items page.","content":{"application/json":{"schema":{"type":"object","required":["limit","offset","items"],"properties":{"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"next":{"anyOf":[{"type":"string","nullable":true}]},"items":{"type":"array","items":{"type":"object","required":["id","marketplace","status","title","url","images"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["sold"]},{"type":"string","enum":["ended"]}]},"title":{"type":"string"},"url":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"condition":{"description":"Human-readable: 'New', 'Used', etc.","type":"string"},"conditionId":{"description":"eBay-style numeric id, kept for filtering.","type":"string"},"seller":{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"images":{"description":"Image URLs in seller-supplied order. First is primary.","type":"array","items":{"type":"string"}},"category":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"path":{"description":"Slash-joined breadcrumb if known.","type":"string"}}},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Flat key→value map.","type":"object","additionalProperties":true},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["auction"]},{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["best_offer"]}]}},"endsAt":{"description":"ISO 8601 listing end time.","type":"string"},"createdAt":{"description":"ISO 8601 listing creation time.","type":"string"},"watchCount":{"minimum":0,"type":"integer"},"bidding":{"type":"object","required":["count"],"properties":{"count":{"minimum":0,"type":"integer"},"currentBid":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"availableQuantity":{"minimum":0,"description":"Live stock remaining on the listing. Absent when eBay hides the count (e.g. 'More than 10 available') or for auctions.","type":"integer"},"soldQuantity":{"minimum":0,"description":"Rolling units shipped on this listing. Browse REST `estimatedSoldQuantity` for active, `totalSoldQuantity` for sold comps.","type":"integer"},"soldAt":{"description":"ISO 8601 sold/closed time.","type":"string"},"soldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","properties":{"cost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"free":{"type":"boolean"},"estimatedDeliveryFrom":{"type":"string"},"estimatedDeliveryTo":{"type":"string"},"shipsTo":{"type":"array","items":{"description":"Country codes, region names, or eBay region ids.","type":"string"}},"shipsToExcluded":{"type":"array","items":{"type":"string"}}}},"location":{"type":"object","properties":{"city":{"type":"string"},"region":{"type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"}}},"epid":{"description":"eBay catalog product id.","type":"string"},"gtin":{"description":"UPC / EAN / ISBN.","type":"string"},"mpn":{"description":"Manufacturer part number.","type":"string"},"groupId":{"type":"string"},"marketingPrice":{"type":"object","properties":{"originalPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountAmount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountPercentage":{"type":"string"},"priceTreatment":{"description":"STRIKETHROUGH | LIST_PRICE | MINIMUM_ADVERTISED_PRICE | MARKDOWN","type":"string"}}},"returnTerms":{"type":"object","properties":{"accepted":{"type":"boolean"},"periodDays":{"minimum":0,"type":"integer"},"shippingCostPayer":{"anyOf":[{"type":"string","enum":["buyer"]},{"type":"string","enum":["seller"]}]},"refundMethod":{"type":"string"},"returnMethod":{"type":"string"}}},"paymentMethods":{"description":"WALLET | CREDIT_CARD | …","type":"array","items":{"type":"string"}},"conditionDescriptors":{"type":"array","items":{"type":"object","required":["name","values"],"properties":{"name":{"description":"e.g. 'Professional Grader' or 'Grade'.","type":"string"},"values":{"type":"array","items":{"type":"string"}}}}},"topRatedBuyingExperience":{"type":"boolean"},"authenticityGuarantee":{"type":"boolean"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"},"qualifiedPrograms":{"description":"EBAY_REFURBISHED | AUTHENTICITY_GUARANTEE | …","type":"array","items":{"type":"string"}},"lotSize":{"minimum":0,"type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"}}}}}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Configured source unavailable (e.g. bridge not paired).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Tier monthly limit reached.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream marketplace or bridge transport failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Required source not configured on this server.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1ItemsSearch","tags":["Items"],"parameters":[{"in":"query","name":"q","required":false,"schema":{}},{"in":"query","name":"status","required":false,"schema":{}},{"in":"query","name":"marketplace","required":false,"schema":{}},{"in":"query","name":"limit","required":false,"schema":{}},{"in":"query","name":"offset","required":false,"schema":{}},{"in":"query","name":"categoryId","required":false,"schema":{}},{"in":"query","name":"conditionIds","required":false,"schema":{}},{"in":"query","name":"buyingOption","required":false,"schema":{}},{"in":"query","name":"priceMin","required":false,"schema":{}},{"in":"query","name":"priceMax","required":false,"schema":{}},{"in":"query","name":"epid","required":false,"schema":{}},{"in":"query","name":"gtin","required":false,"schema":{}},{"in":"query","name":"groupId","required":false,"schema":{}},{"in":"query","name":"sort","required":false,"schema":{}},{"in":"query","name":"country","required":false,"schema":{}},{"in":"query","name":"filter","required":false,"schema":{}},{"in":"query","name":"aspectFilter","required":false,"schema":{}},{"in":"query","name":"fieldgroups","required":false,"schema":{}},{"in":"query","name":"autoCorrect","required":false,"schema":{}},{"in":"query","name":"compatibilityFilter","required":false,"schema":{}},{"in":"query","name":"charityIds","required":false,"schema":{}}],"summary":"Search marketplace listings (active or sold)","description":"Unified across active (eBay Browse) and sold (Marketplace Insights). Pass `status=active` (default) or `status=sold`. Response is the normalized flipagent `ItemSearchResponse` — cents-int Money, ISO timestamps, `marketplace` on every record."}},"/v1/items/{id}":{"get":{"responses":{"200":{"description":"Item.","content":{"application/json":{"schema":{"type":"object","required":["id","marketplace","status","title","url","images"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["sold"]},{"type":"string","enum":["ended"]}]},"title":{"type":"string"},"url":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"condition":{"description":"Human-readable: 'New', 'Used', etc.","type":"string"},"conditionId":{"description":"eBay-style numeric id, kept for filtering.","type":"string"},"seller":{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"images":{"description":"Image URLs in seller-supplied order. First is primary.","type":"array","items":{"type":"string"}},"category":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"path":{"description":"Slash-joined breadcrumb if known.","type":"string"}}},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Flat key→value map.","type":"object","additionalProperties":true},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["auction"]},{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["best_offer"]}]}},"endsAt":{"description":"ISO 8601 listing end time.","type":"string"},"createdAt":{"description":"ISO 8601 listing creation time.","type":"string"},"watchCount":{"minimum":0,"type":"integer"},"bidding":{"type":"object","required":["count"],"properties":{"count":{"minimum":0,"type":"integer"},"currentBid":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"availableQuantity":{"minimum":0,"description":"Live stock remaining on the listing. Absent when eBay hides the count (e.g. 'More than 10 available') or for auctions.","type":"integer"},"soldQuantity":{"minimum":0,"description":"Rolling units shipped on this listing. Browse REST `estimatedSoldQuantity` for active, `totalSoldQuantity` for sold comps.","type":"integer"},"soldAt":{"description":"ISO 8601 sold/closed time.","type":"string"},"soldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","properties":{"cost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"free":{"type":"boolean"},"estimatedDeliveryFrom":{"type":"string"},"estimatedDeliveryTo":{"type":"string"},"shipsTo":{"type":"array","items":{"description":"Country codes, region names, or eBay region ids.","type":"string"}},"shipsToExcluded":{"type":"array","items":{"type":"string"}}}},"location":{"type":"object","properties":{"city":{"type":"string"},"region":{"type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"}}},"epid":{"description":"eBay catalog product id.","type":"string"},"gtin":{"description":"UPC / EAN / ISBN.","type":"string"},"mpn":{"description":"Manufacturer part number.","type":"string"},"groupId":{"type":"string"},"marketingPrice":{"type":"object","properties":{"originalPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountAmount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountPercentage":{"type":"string"},"priceTreatment":{"description":"STRIKETHROUGH | LIST_PRICE | MINIMUM_ADVERTISED_PRICE | MARKDOWN","type":"string"}}},"returnTerms":{"type":"object","properties":{"accepted":{"type":"boolean"},"periodDays":{"minimum":0,"type":"integer"},"shippingCostPayer":{"anyOf":[{"type":"string","enum":["buyer"]},{"type":"string","enum":["seller"]}]},"refundMethod":{"type":"string"},"returnMethod":{"type":"string"}}},"paymentMethods":{"description":"WALLET | CREDIT_CARD | …","type":"array","items":{"type":"string"}},"conditionDescriptors":{"type":"array","items":{"type":"object","required":["name","values"],"properties":{"name":{"description":"e.g. 'Professional Grader' or 'Grade'.","type":"string"},"values":{"type":"array","items":{"type":"string"}}}}},"topRatedBuyingExperience":{"type":"boolean"},"authenticityGuarantee":{"type":"boolean"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"},"qualifiedPrograms":{"description":"EBAY_REFURBISHED | AUTHENTICITY_GUARANTEE | …","type":"array","items":{"type":"string"}},"lotSize":{"minimum":0,"type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"}}}}}},"400":{"description":"Invalid id format.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Listing not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream marketplace failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Required source not configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1ItemsById","tags":["Items"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"query","name":"status","required":false,"schema":{}},{"in":"query","name":"marketplace","required":false,"schema":{}}],"summary":"Get a single listing by id","description":"Accepts any id form: bare numeric (`123456789012`), eBay v1 (`v1|123|0`), or full `ebay.com/itm/...` URL. Returns the normalized `Item`. Pass `?status=sold` to read a sold listing."}},"/v1/categories/suggest":{"get":{"responses":{"200":{"description":"Suggestions.","content":{"application/json":{"schema":{"type":"object","required":["suggestions"],"properties":{"suggestions":{"type":"array","items":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"path":{"type":"string"},"confidence":{"type":"number"}}}}}}}}},"401":{"description":"API key missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1CategoriesSuggest","tags":["Categories"],"parameters":[{"in":"query","name":"title","required":true,"schema":{}},{"in":"query","name":"marketplace","required":false,"schema":{}}],"summary":"Suggest a category from a listing title"}},"/v1/categories/{id}/compatibility-properties":{"get":{"responses":{"200":{"description":"Properties.","content":{"application/json":{"schema":{"type":"object","required":["properties"],"properties":{"properties":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"localizedName":{"type":"string"}}}}}}}}},"401":{"description":"API key missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1CategoriesByIdCompatibility-properties","tags":["Categories"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Compatibility properties for a category"}},"/v1/categories/item-aspects":{"get":{"responses":{"200":{"description":"Aspects.","content":{"application/json":{"schema":{"type":"object","required":["treeId","entries"],"properties":{"treeId":{"type":"string"},"entries":{"type":"array","items":{"type":"object","required":["categoryId","aspects"],"properties":{"categoryId":{"type":"string"},"aspects":{"type":"array","items":{"type":"object","required":["name","required","multiValued"],"properties":{"name":{"type":"string"},"required":{"type":"boolean"},"multiValued":{"type":"boolean"},"dataType":{"description":"STRING | NUMBER | DATE | …","type":"string"},"values":{"description":"Suggested or enumerated values.","type":"array","items":{"type":"string"}}}}}}}}}}}}},"401":{"description":"API key missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1CategoriesItem-aspects","tags":["Categories"],"parameters":[],"summary":"Bulk download every aspect for every category in the tree","description":"Wraps `commerce/taxonomy/v1/category_tree/{treeId}/fetch_item_aspects`. Heavyweight (multi-MB JSON for full eBay US tree). For one category in real-time UIs, use `/v1/categories/{id}/aspects`."}},"/v1/categories/{id}/aspects":{"get":{"responses":{"200":{"description":"Aspects.","content":{"application/json":{"schema":{"type":"object","required":["categoryId","aspects"],"properties":{"categoryId":{"type":"string"},"aspects":{"type":"array","items":{"type":"object","required":["name","required","multiValued"],"properties":{"name":{"type":"string"},"required":{"type":"boolean"},"multiValued":{"type":"boolean"},"dataType":{"description":"STRING | NUMBER | DATE | …","type":"string"},"values":{"description":"Suggested or enumerated values.","type":"array","items":{"type":"string"}}}}}}}}}},"401":{"description":"API key missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1CategoriesByIdAspects","tags":["Categories"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Required + recommended item-specifics for a category"}},"/v1/categories":{"get":{"responses":{"200":{"description":"Categories.","content":{"application/json":{"schema":{"type":"object","required":["categories"],"properties":{"categories":{"type":"array","items":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"path":{"type":"string"},"parentId":{"type":"string"},"isLeaf":{"type":"boolean"}}}}}}}}},"401":{"description":"API key missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1Categories","tags":["Categories"],"parameters":[{"in":"query","name":"marketplace","required":false,"schema":{}},{"in":"query","name":"parentId","required":false,"schema":{}}],"summary":"List categories (top-level or children of `parentId`)"}},"/v1/products/search":{"get":{"responses":{"200":{"description":"Products.","content":{"application/json":{"schema":{"type":"object","required":["limit","offset","products"],"properties":{"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"next":{"anyOf":[{"type":"string","nullable":true}]},"products":{"type":"array","items":{"type":"object","required":["epid","marketplace","title","images"],"properties":{"epid":{"description":"eBay catalog product id.","type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"title":{"type":"string"},"brand":{"type":"string"},"mpn":{"type":"string"},"gtin":{"type":"string"},"description":{"type":"string"},"images":{"type":"array","items":{"type":"string"}},"aspects":{"type":"object","additionalProperties":true},"category":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name":{"type":"string"}}},"averagePrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"listingCount":{"minimum":0,"type":"integer"}}}}}}}}},"503":{"description":"Catalog search not available on this server (needs a connected eBay account or operator approval).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1ProductsSearch","tags":["Products"],"parameters":[{"in":"query","name":"q","required":false,"schema":{}},{"in":"query","name":"gtin","required":false,"schema":{}},{"in":"query","name":"mpn","required":false,"schema":{}},{"in":"query","name":"brand","required":false,"schema":{}},{"in":"query","name":"categoryId","required":false,"schema":{}},{"in":"query","name":"limit","required":false,"schema":{}},{"in":"query","name":"offset","required":false,"schema":{}},{"in":"query","name":"marketplace","required":false,"schema":{}}],"summary":"Search the universal product catalog"}},"/v1/products/metadata":{"get":{"responses":{"200":{"description":"Metadata.","content":{"application/json":{"schema":{"type":"object","required":["aspects"],"properties":{"epid":{"type":"string"},"categoryId":{"type":"string"},"aspects":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"dataType":{"type":"string"},"required":{"type":"boolean"},"multiValued":{"type":"boolean"},"values":{"type":"array","items":{"type":"string"}}}}}}}}}},"400":{"description":"Provide ?epid= or ?categoryId=.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Catalog metadata not available on this server (needs a connected eBay account or operator approval).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1ProductsMetadata","tags":["Products"],"parameters":[{"in":"query","name":"epid","required":false,"schema":{}},{"in":"query","name":"categoryId","required":false,"schema":{}},{"in":"query","name":"marketplace","required":false,"schema":{}}],"summary":"Aspect metadata for an EPID or category","description":"Wraps `get_product_metadata`. Returns required + recommended aspects so agents can fill `aspects` correctly before listing."}},"/v1/products/category-metadata":{"get":{"responses":{"200":{"description":"Metadata.","content":{"application/json":{"schema":{"type":"object","required":["entries"],"properties":{"entries":{"type":"array","items":{"type":"object","required":["categoryId","aspects"],"properties":{"categoryId":{"type":"string"},"aspects":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"dataType":{"type":"string"},"required":{"type":"boolean"},"multiValued":{"type":"boolean"},"values":{"type":"array","items":{"type":"string"}}}}}}}}}}}}},"503":{"description":"Catalog metadata not available on this server (needs a connected eBay account or operator approval).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1ProductsCategory-metadata","tags":["Products"],"parameters":[{"in":"query","name":"categoryIds","required":true,"schema":{}},{"in":"query","name":"marketplace","required":false,"schema":{}}],"summary":"Aspect metadata for many categories in one call","description":"Wraps `get_product_metadata_for_categories`. Bulk variant of `/metadata` — pass `?categoryIds=a,b,c`."}},"/v1/products/{epid}":{"get":{"responses":{"200":{"description":"Product.","content":{"application/json":{"schema":{"type":"object","required":["epid","marketplace","title","images"],"properties":{"epid":{"description":"eBay catalog product id.","type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"title":{"type":"string"},"brand":{"type":"string"},"mpn":{"type":"string"},"gtin":{"type":"string"},"description":{"type":"string"},"images":{"type":"array","items":{"type":"string"}},"aspects":{"type":"object","additionalProperties":true},"category":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name":{"type":"string"}}},"averagePrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"listingCount":{"minimum":0,"type":"integer"}}}}}},"404":{"description":"EPID not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"No catalog transport available (REST + scrape both failed).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1ProductsByEpid","tags":["Products"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"epid","required":true}],"summary":"Get a product by EPID","description":"Resolves a product by EPID using whichever sources the server has available — connected-seller Catalog REST, app-credential REST when the operator has approval, and finally a public JSON-LD scrape."}},"/v1/evaluate":{"post":{"responses":{"200":{"description":"Final evaluation + pools.","content":{"application/json":{"schema":{"type":"object","required":["item","evaluation","market","sold","active","filter","returns","meta","soldPool","activePool","rejectedSoldPool","rejectedActivePool","rejectionReasons"],"properties":{"item":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"listingMarketplaceId":{"type":"string"},"sellerItemRevision":{"type":"string"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"description":{"type":"string"},"shortDescription":{"type":"string"},"categoryPath":{"type":"string"},"categoryId":{"type":"string"},"categoryIdPath":{"type":"string"},"localizedAspects":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"},"type":{"type":"string"}}}},"brand":{"type":"string"},"color":{"type":"string"},"size":{"type":"string"},"pattern":{"type":"string"},"material":{"type":"string"},"sizeType":{"type":"string"},"mpn":{"type":"string"},"gtin":{"type":"string"},"epid":{"type":"string"},"lotSize":{"type":"integer"},"quantityLimitPerBuyer":{"type":"integer"},"conditionDescription":{"type":"string"},"conditionDescriptors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"values":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"}}}}}}},"marketingPrice":{"type":"object","properties":{"originalPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"discountAmount":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"discountPercentage":{"type":"string"},"priceTreatment":{"type":"string"}}},"primaryProductReviewRating":{"type":"object","properties":{"reviewCount":{"type":"integer"},"averageRating":{"type":"string"},"ratingHistograms":{"type":"array","items":{"type":"object","required":["rating","count"],"properties":{"rating":{"type":"string"},"count":{"type":"integer"}}}}}},"warnings":{"type":"array","items":{"type":"object","properties":{"errorId":{"type":"integer"},"domain":{"type":"string"},"category":{"type":"string"},"message":{"type":"string"},"parameters":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}}}}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"priorityListing":{"type":"boolean"},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"estimatedAvailabilities":{"type":"array","items":{"type":"object","properties":{"estimatedAvailabilityStatus":{"type":"string"},"estimatedAvailableQuantity":{"type":"integer"},"estimatedSoldQuantity":{"type":"integer"},"estimatedRemainingQuantity":{"type":"integer"},"availabilityThreshold":{"type":"integer"},"availabilityThresholdType":{"type":"string"},"deliveryOptions":{"type":"array","items":{"type":"string"}}}}},"shipToLocations":{"type":"object","properties":{"regionIncluded":{"type":"array","items":{"type":"object","properties":{"regionName":{"type":"string"},"regionType":{"type":"string"},"regionId":{"type":"string"}}}},"regionExcluded":{"type":"array","items":{"type":"object","properties":{"regionName":{"type":"string"},"regionType":{"type":"string"},"regionId":{"type":"string"}}}}}},"returnTerms":{"type":"object","properties":{"returnsAccepted":{"type":"boolean"},"returnPeriod":{"type":"object","required":["value","unit"],"properties":{"value":{"type":"integer"},"unit":{"type":"string"}}},"returnShippingCostPayer":{"type":"string"},"refundMethod":{"type":"string"},"returnMethod":{"type":"string"}}},"taxes":{"type":"array","items":{"type":"object","properties":{"taxJurisdiction":{"type":"object","properties":{"region":{"type":"object","properties":{"regionName":{"type":"string"},"regionType":{"type":"string"}}},"taxJurisdictionId":{"type":"string"}}},"taxType":{"type":"string"},"shippingAndHandlingTaxed":{"type":"boolean"},"includedInPrice":{"type":"boolean"},"ebayCollectAndRemitTax":{"type":"boolean"},"taxPercentage":{"type":"string"}}}},"paymentMethods":{"type":"array","items":{"type":"object","properties":{"paymentMethodType":{"type":"string"},"paymentMethodBrands":{"type":"array","items":{"type":"object","properties":{"paymentMethodBrandType":{"type":"string"},"logoImage":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}}}}}}},"immediatePay":{"type":"boolean"},"enabledForGuestCheckout":{"type":"boolean"},"eligibleForInlineCheckout":{"type":"boolean"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"},"primaryItemGroup":{"type":"object","properties":{"itemGroupId":{"type":"string"},"itemGroupType":{"type":"string"},"itemGroupHref":{"type":"string"},"itemGroupTitle":{"type":"string"},"itemGroupImage":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"itemGroupAdditionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}}}},"unitPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"unitPricingMeasure":{"type":"string"}}},"evaluation":{"type":"object","required":["successNetCents","expectedNetCents","maxLossCents","landedCostCents","rating","reasonCode","reason","bidCeilingCents","safeBidBreakdown","netRangeCents","recommendedExit","risk"],"properties":{"successNetCents":{"anyOf":[{"type":"integer","nullable":true}]},"expectedNetCents":{"type":"integer"},"maxLossCents":{"anyOf":[{"type":"integer","nullable":true}]},"landedCostCents":{"anyOf":[{"type":"integer","nullable":true}]},"rating":{"anyOf":[{"type":"string","enum":["buy"]},{"type":"string","enum":["skip"]}]},"reasonCode":{"anyOf":[{"type":"string","enum":["cleared"]},{"type":"string","enum":["vetoed"]},{"type":"string","enum":["no_market"]},{"type":"string","enum":["insufficient_data"]},{"type":"string","enum":["below_min_net"]}]},"reason":{"type":"string"},"bidCeilingCents":{"anyOf":[{"type":"integer","nullable":true}]},"safeBidBreakdown":{"anyOf":[{"type":"object","required":["estimatedSaleCents","feesCents","shippingCents","targetNetCents"],"properties":{"estimatedSaleCents":{"type":"integer"},"feesCents":{"type":"integer"},"shippingCents":{"type":"integer"},"targetNetCents":{"type":"integer"}},"nullable":true}]},"netRangeCents":{"anyOf":[{"type":"object","required":["p10Cents","p90Cents"],"properties":{"p10Cents":{"type":"integer"},"p90Cents":{"type":"integer"}},"nullable":true}]},"recommendedExit":{"anyOf":[{"type":"object","required":["listPriceCents","expectedDaysToSell","daysLow","daysHigh","netCents","dollarsPerDay","queueAhead","asksAbove"],"properties":{"listPriceCents":{"type":"integer"},"expectedDaysToSell":{"type":"number"},"daysLow":{"type":"number"},"daysHigh":{"type":"number"},"netCents":{"type":"integer"},"dollarsPerDay":{"type":"integer"},"queueAhead":{"type":"integer"},"asksAbove":{"type":"integer"}},"nullable":true}]},"risk":{"anyOf":[{"type":"object","required":["P_fraud","withinReturnWindow","cycleDays","reason"],"properties":{"P_fraud":{"type":"number"},"withinReturnWindow":{"type":"boolean"},"cycleDays":{"type":"integer"},"reason":{"type":"string"}},"nullable":true}]}}},"evaluationAll":{"type":"object","required":["successNetCents","expectedNetCents","maxLossCents","landedCostCents","rating","reasonCode","reason","bidCeilingCents","safeBidBreakdown","netRangeCents","recommendedExit","risk"],"properties":{"successNetCents":{"anyOf":[{"type":"integer","nullable":true}]},"expectedNetCents":{"type":"integer"},"maxLossCents":{"anyOf":[{"type":"integer","nullable":true}]},"landedCostCents":{"anyOf":[{"type":"integer","nullable":true}]},"rating":{"anyOf":[{"type":"string","enum":["buy"]},{"type":"string","enum":["skip"]}]},"reasonCode":{"anyOf":[{"type":"string","enum":["cleared"]},{"type":"string","enum":["vetoed"]},{"type":"string","enum":["no_market"]},{"type":"string","enum":["insufficient_data"]},{"type":"string","enum":["below_min_net"]}]},"reason":{"type":"string"},"bidCeilingCents":{"anyOf":[{"type":"integer","nullable":true}]},"safeBidBreakdown":{"anyOf":[{"type":"object","required":["estimatedSaleCents","feesCents","shippingCents","targetNetCents"],"properties":{"estimatedSaleCents":{"type":"integer"},"feesCents":{"type":"integer"},"shippingCents":{"type":"integer"},"targetNetCents":{"type":"integer"}},"nullable":true}]},"netRangeCents":{"anyOf":[{"type":"object","required":["p10Cents","p90Cents"],"properties":{"p10Cents":{"type":"integer"},"p90Cents":{"type":"integer"}},"nullable":true}]},"recommendedExit":{"anyOf":[{"type":"object","required":["listPriceCents","expectedDaysToSell","daysLow","daysHigh","netCents","dollarsPerDay","queueAhead","asksAbove"],"properties":{"listPriceCents":{"type":"integer"},"expectedDaysToSell":{"type":"number"},"daysLow":{"type":"number"},"daysHigh":{"type":"number"},"netCents":{"type":"integer"},"dollarsPerDay":{"type":"integer"},"queueAhead":{"type":"integer"},"asksAbove":{"type":"integer"}},"nullable":true}]},"risk":{"anyOf":[{"type":"object","required":["P_fraud","withinReturnWindow","cycleDays","reason"],"properties":{"P_fraud":{"type":"number"},"withinReturnWindow":{"type":"boolean"},"cycleDays":{"type":"integer"},"reason":{"type":"string"}},"nullable":true}]}}},"market":{"type":"object","required":["keyword","marketplace","windowDays","meanCents","stdDevCents","medianCents","p25Cents","p75Cents","nObservations","salesPerDay","asOf"],"properties":{"keyword":{"type":"string"},"marketplace":{"type":"string"},"windowDays":{"type":"integer"},"meanCents":{"type":"integer"},"stdDevCents":{"type":"integer"},"medianCents":{"type":"integer"},"medianCiLowCents":{"type":"integer"},"medianCiHighCents":{"type":"integer"},"p25Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"nObservations":{"type":"integer"},"salesPerDay":{"type":"number"},"salesPerDayBaseline":{"type":"number"},"salesPerDaySeed":{"type":"number"},"meanDaysToSell":{"type":"number"},"daysStdDev":{"type":"number"},"daysP50":{"type":"number"},"daysP70":{"type":"number"},"daysP90":{"type":"number"},"nDurations":{"type":"integer"},"asks":{"type":"object","required":["meanCents","stdDevCents","medianCents","p25Cents","p75Cents","nActive"],"properties":{"meanCents":{"type":"integer"},"stdDevCents":{"type":"integer"},"medianCents":{"type":"integer"},"p25Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"nActive":{"type":"integer"}}},"asOf":{"type":"string"}}},"sold":{"type":"object","required":["count","windowDays","salesPerDay","meanDaysToSell","priceCents","priceHistogram","conditionMix","recentTrend","lastSaleAt","lastSalePriceCents"],"properties":{"count":{"type":"integer"},"windowDays":{"type":"integer"},"salesPerDay":{"type":"number"},"meanDaysToSell":{"anyOf":[{"type":"number","nullable":true}]},"priceCents":{"type":"object","required":["minCents","p10Cents","p25Cents","p50Cents","p75Cents","p90Cents","maxCents"],"properties":{"minCents":{"type":"integer"},"p10Cents":{"type":"integer"},"p25Cents":{"type":"integer"},"p50Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"p90Cents":{"type":"integer"},"maxCents":{"type":"integer"}}},"priceHistogram":{"type":"array","items":{"type":"object","required":["minCents","maxCents","count"],"properties":{"minCents":{"type":"integer"},"maxCents":{"type":"integer"},"count":{"type":"integer"}}}},"conditionMix":{"type":"object","additionalProperties":true},"recentTrend":{"anyOf":[{"type":"object","required":["direction","change14dPct"],"properties":{"direction":{"anyOf":[{"type":"string","enum":["up"]},{"type":"string","enum":["flat"]},{"type":"string","enum":["down"]}]},"change14dPct":{"type":"number"}},"nullable":true}]},"lastSaleAt":{"anyOf":[{"type":"string","nullable":true}]},"lastSalePriceCents":{"anyOf":[{"type":"integer","nullable":true}]}}},"active":{"type":"object","required":["count","priceCents","priceHistogram","conditionMix","bestPriceCents","sellerConcentration"],"properties":{"count":{"type":"integer"},"priceCents":{"type":"object","required":["minCents","p10Cents","p25Cents","p50Cents","p75Cents","p90Cents","maxCents"],"properties":{"minCents":{"type":"integer"},"p10Cents":{"type":"integer"},"p25Cents":{"type":"integer"},"p50Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"p90Cents":{"type":"integer"},"maxCents":{"type":"integer"}}},"priceHistogram":{"type":"array","items":{"type":"object","required":["minCents","maxCents","count"],"properties":{"minCents":{"type":"integer"},"maxCents":{"type":"integer"},"count":{"type":"integer"}}}},"conditionMix":{"type":"object","additionalProperties":true},"bestPriceCents":{"anyOf":[{"type":"integer","nullable":true}]},"sellerConcentration":{"anyOf":[{"type":"string","enum":["diverse"]},{"type":"string","enum":["few_sellers"]}]}}},"marketAll":{"type":"object","required":["keyword","marketplace","windowDays","meanCents","stdDevCents","medianCents","p25Cents","p75Cents","nObservations","salesPerDay","asOf"],"properties":{"keyword":{"type":"string"},"marketplace":{"type":"string"},"windowDays":{"type":"integer"},"meanCents":{"type":"integer"},"stdDevCents":{"type":"integer"},"medianCents":{"type":"integer"},"medianCiLowCents":{"type":"integer"},"medianCiHighCents":{"type":"integer"},"p25Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"nObservations":{"type":"integer"},"salesPerDay":{"type":"number"},"salesPerDayBaseline":{"type":"number"},"salesPerDaySeed":{"type":"number"},"meanDaysToSell":{"type":"number"},"daysStdDev":{"type":"number"},"daysP50":{"type":"number"},"daysP70":{"type":"number"},"daysP90":{"type":"number"},"nDurations":{"type":"integer"},"asks":{"type":"object","required":["meanCents","stdDevCents","medianCents","p25Cents","p75Cents","nActive"],"properties":{"meanCents":{"type":"integer"},"stdDevCents":{"type":"integer"},"medianCents":{"type":"integer"},"p25Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"nActive":{"type":"integer"}}},"asOf":{"type":"string"}}},"soldAll":{"type":"object","required":["count","windowDays","salesPerDay","meanDaysToSell","priceCents","priceHistogram","conditionMix","recentTrend","lastSaleAt","lastSalePriceCents"],"properties":{"count":{"type":"integer"},"windowDays":{"type":"integer"},"salesPerDay":{"type":"number"},"meanDaysToSell":{"anyOf":[{"type":"number","nullable":true}]},"priceCents":{"type":"object","required":["minCents","p10Cents","p25Cents","p50Cents","p75Cents","p90Cents","maxCents"],"properties":{"minCents":{"type":"integer"},"p10Cents":{"type":"integer"},"p25Cents":{"type":"integer"},"p50Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"p90Cents":{"type":"integer"},"maxCents":{"type":"integer"}}},"priceHistogram":{"type":"array","items":{"type":"object","required":["minCents","maxCents","count"],"properties":{"minCents":{"type":"integer"},"maxCents":{"type":"integer"},"count":{"type":"integer"}}}},"conditionMix":{"type":"object","additionalProperties":true},"recentTrend":{"anyOf":[{"type":"object","required":["direction","change14dPct"],"properties":{"direction":{"anyOf":[{"type":"string","enum":["up"]},{"type":"string","enum":["flat"]},{"type":"string","enum":["down"]}]},"change14dPct":{"type":"number"}},"nullable":true}]},"lastSaleAt":{"anyOf":[{"type":"string","nullable":true}]},"lastSalePriceCents":{"anyOf":[{"type":"integer","nullable":true}]}}},"activeAll":{"type":"object","required":["count","priceCents","priceHistogram","conditionMix","bestPriceCents","sellerConcentration"],"properties":{"count":{"type":"integer"},"priceCents":{"type":"object","required":["minCents","p10Cents","p25Cents","p50Cents","p75Cents","p90Cents","maxCents"],"properties":{"minCents":{"type":"integer"},"p10Cents":{"type":"integer"},"p25Cents":{"type":"integer"},"p50Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"p90Cents":{"type":"integer"},"maxCents":{"type":"integer"}}},"priceHistogram":{"type":"array","items":{"type":"object","required":["minCents","maxCents","count"],"properties":{"minCents":{"type":"integer"},"maxCents":{"type":"integer"},"count":{"type":"integer"}}}},"conditionMix":{"type":"object","additionalProperties":true},"bestPriceCents":{"anyOf":[{"type":"integer","nullable":true}]},"sellerConcentration":{"anyOf":[{"type":"string","enum":["diverse"]},{"type":"string","enum":["few_sellers"]}]}}},"filter":{"type":"object","required":["soldKept","soldRejected","activeKept","activeRejected","rejectionsByCategory"],"properties":{"soldKept":{"type":"integer"},"soldRejected":{"type":"integer"},"activeKept":{"type":"integer"},"activeRejected":{"type":"integer"},"rejectionsByCategory":{"type":"object","additionalProperties":true}}},"returns":{"anyOf":[{"type":"object","required":["accepted"],"properties":{"accepted":{"type":"boolean"},"periodDays":{"minimum":0,"type":"integer"},"shippingCostPaidBy":{"anyOf":[{"type":"string","enum":["BUYER"]},{"type":"string","enum":["SELLER"]}]}},"nullable":true}]},"meta":{"type":"object","required":["soldCount","activeCount","soldKept","soldRejected","activeKept","activeRejected"],"properties":{"soldCount":{"type":"integer"},"activeCount":{"type":"integer"},"soldKept":{"type":"integer"},"soldRejected":{"type":"integer"},"activeKept":{"type":"integer"},"activeRejected":{"type":"integer"}}},"soldPool":{"type":"array","items":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"itemAffiliateWebUrl":{"type":"string"},"itemHref":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"lastSoldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"lastSoldDate":{"type":"string"},"totalSoldQuantity":{"type":"integer"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"thumbnailImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"epid":{"type":"string"},"gtin":{"type":"string"},"categoryId":{"type":"string"},"leafCategoryIds":{"type":"array","items":{"type":"string"}},"itemGroupHref":{"type":"string"},"itemGroupType":{"type":"string"},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"listingMarketplaceId":{"type":"string"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"}}}},"activePool":{"type":"array","items":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"itemAffiliateWebUrl":{"type":"string"},"itemHref":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"lastSoldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"lastSoldDate":{"type":"string"},"totalSoldQuantity":{"type":"integer"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"thumbnailImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"epid":{"type":"string"},"gtin":{"type":"string"},"categoryId":{"type":"string"},"leafCategoryIds":{"type":"array","items":{"type":"string"}},"itemGroupHref":{"type":"string"},"itemGroupType":{"type":"string"},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"listingMarketplaceId":{"type":"string"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"}}}},"rejectedSoldPool":{"type":"array","items":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"itemAffiliateWebUrl":{"type":"string"},"itemHref":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"lastSoldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"lastSoldDate":{"type":"string"},"totalSoldQuantity":{"type":"integer"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"thumbnailImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"epid":{"type":"string"},"gtin":{"type":"string"},"categoryId":{"type":"string"},"leafCategoryIds":{"type":"array","items":{"type":"string"}},"itemGroupHref":{"type":"string"},"itemGroupType":{"type":"string"},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"listingMarketplaceId":{"type":"string"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"}}}},"rejectedActivePool":{"type":"array","items":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"itemAffiliateWebUrl":{"type":"string"},"itemHref":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"lastSoldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"lastSoldDate":{"type":"string"},"totalSoldQuantity":{"type":"integer"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"thumbnailImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"epid":{"type":"string"},"gtin":{"type":"string"},"categoryId":{"type":"string"},"leafCategoryIds":{"type":"array","items":{"type":"string"}},"itemGroupHref":{"type":"string"},"itemGroupType":{"type":"string"},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"listingMarketplaceId":{"type":"string"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"}}}},"rejectionReasons":{"type":"object","additionalProperties":true},"rejectionCategories":{"type":"object","additionalProperties":true},"suspiciousIds":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Item not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"422":{"description":"Too few sold matches to evaluate.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failure.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"eBay or scraper not configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1Evaluate","tags":["Evaluate"],"parameters":[],"summary":"Score a single listing as a flip opportunity (sync)","description":"Composite: server fetches the item detail, runs sold + active searches in parallel, LLM-filters to same-product, runs the evaluation. Returns `{ item, evaluation, meta, soldPool, activePool, rejectedSoldPool, rejectedActivePool, market }` once the pipeline reaches a terminal state. For a streaming view of each step, use `POST /v1/evaluate/jobs` then `GET /v1/evaluate/jobs/{id}/stream`. Internally this creates a compute_job and awaits terminal — same code path as the async surface, just collapsed for one-shot callers.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["itemId"],"properties":{"itemId":{"minLength":1,"type":"string"},"lookbackDays":{"minimum":1,"maximum":90,"type":"integer"},"soldLimit":{"minimum":1,"maximum":200,"type":"integer"},"opts":{"type":"object","properties":{"forwarder":{"type":"object","required":["destState","weightG"],"properties":{"destState":{"minLength":2,"maxLength":2,"description":"ISO 3166-2 US state code, e.g. NY, TX, HI.","type":"string"},"weightG":{"minimum":1,"description":"Package weight in grams.","type":"integer"},"dimsCm":{"type":"object","required":["l","w","h"],"properties":{"l":{"minimum":0,"type":"number"},"w":{"minimum":0,"type":"number"},"h":{"minimum":0,"type":"number"}}},"provider":{"description":"Forwarder provider id. Defaults to planet-express.","type":"string"},"itemCount":{"minimum":1,"description":"Items consolidated; default 1.","type":"integer"}}},"minNetCents":{"minimum":0,"type":"integer"},"outboundShippingCents":{"minimum":0,"type":"integer"}}}}}}}}}},"/v1/evaluate/{itemId}/pool":{"get":{"responses":{"200":{"description":"Same-product pools.","content":{"application/json":{"schema":{"type":"object","required":["itemId","evaluatedAt","sold","active"],"properties":{"itemId":{"type":"string"},"evaluatedAt":{"format":"date-time","type":"string"},"sold":{"type":"object","required":["kept","rejected"],"properties":{"kept":{"type":"array","items":{"type":"object","required":["itemId","title","priceCents","currency","itemWebUrl"],"properties":{"itemId":{"type":"string"},"title":{"type":"string"},"priceCents":{"type":"integer"},"currency":{"type":"string"},"condition":{"type":"string"},"sellerLogin":{"type":"string"},"itemWebUrl":{"format":"uri","type":"string"},"soldAt":{"type":"string"},"listedAt":{"type":"string"}}}},"rejected":{"type":"array","items":{"type":"object","required":["itemId","title","priceCents","currency","itemWebUrl","rejectionReason","rejectionCategory"],"properties":{"itemId":{"type":"string"},"title":{"type":"string"},"priceCents":{"type":"integer"},"currency":{"type":"string"},"condition":{"type":"string"},"sellerLogin":{"type":"string"},"itemWebUrl":{"format":"uri","type":"string"},"rejectionReason":{"type":"string"},"rejectionCategory":{"type":"string"}}}}}},"active":{"type":"object","required":["kept","rejected"],"properties":{"kept":{"type":"array","items":{"type":"object","required":["itemId","title","priceCents","currency","itemWebUrl"],"properties":{"itemId":{"type":"string"},"title":{"type":"string"},"priceCents":{"type":"integer"},"currency":{"type":"string"},"condition":{"type":"string"},"sellerLogin":{"type":"string"},"itemWebUrl":{"format":"uri","type":"string"},"soldAt":{"type":"string"},"listedAt":{"type":"string"}}}},"rejected":{"type":"array","items":{"type":"object","required":["itemId","title","priceCents","currency","itemWebUrl","rejectionReason","rejectionCategory"],"properties":{"itemId":{"type":"string"},"title":{"type":"string"},"priceCents":{"type":"integer"},"currency":{"type":"string"},"condition":{"type":"string"},"sellerLogin":{"type":"string"},"itemWebUrl":{"format":"uri","type":"string"},"rejectionReason":{"type":"string"},"rejectionCategory":{"type":"string"}}}}}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"No recent evaluation cached. Run POST /v1/evaluate first.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1EvaluateByItemIdPool","tags":["Evaluate"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"itemId","required":true}],"summary":"Drill into the same-product pools used to score one listing","description":"Returns the kept + rejected sold/active listings the LLM filter selected, with per-item rejection reason inline. Mirrors the playground's per-section 'View' expansion. Cache-only — call POST /v1/evaluate first within the cache TTL; on cache miss returns 412 with a next_action pointer."}},"/v1/evaluate/featured":{"get":{"responses":{"200":{"description":"Featured evaluation examples.","content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"type":"object","required":["itemId","title","itemWebUrl","completedAt"],"properties":{"itemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"format":"uri","type":"string"},"image":{"format":"uri","type":"string"},"completedAt":{"format":"date-time","type":"string"}}}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1EvaluateFeatured","tags":["Evaluate"],"parameters":[],"summary":"List recently-evaluated listings as showcase examples","description":"Server-curated \"Try one\" pool. Returns up to `limit` recent successful evaluate jobs (any caller, last 14 days, sold-pool ≥ 8) deduped by itemId, with takedown'd items excluded. Click-through hits the cached evaluate result so demo runs do not re-spend credits. Powers the playground's preset chips."}},"/v1/evaluate/jobs":{"post":{"responses":{"202":{"description":"Job queued.","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"format":"uuid","type":"string"},"status":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]}]}}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1EvaluateJobs","tags":["Evaluate"],"parameters":[],"summary":"Create an evaluate job (async — returns immediately)","description":"Creates a compute job, returns `{ id, status: \"queued\" }` immediately. Caller polls `GET /v1/evaluate/jobs/{id}` or subscribes to `GET /v1/evaluate/jobs/{id}/stream` for live trace events. Survives client disconnect — closing the tab mid-run does not abort the pipeline.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["itemId"],"properties":{"itemId":{"minLength":1,"type":"string"},"lookbackDays":{"minimum":1,"maximum":90,"type":"integer"},"soldLimit":{"minimum":1,"maximum":200,"type":"integer"},"opts":{"type":"object","properties":{"forwarder":{"type":"object","required":["destState","weightG"],"properties":{"destState":{"minLength":2,"maxLength":2,"description":"ISO 3166-2 US state code, e.g. NY, TX, HI.","type":"string"},"weightG":{"minimum":1,"description":"Package weight in grams.","type":"integer"},"dimsCm":{"type":"object","required":["l","w","h"],"properties":{"l":{"minimum":0,"type":"number"},"w":{"minimum":0,"type":"number"},"h":{"minimum":0,"type":"number"}}},"provider":{"description":"Forwarder provider id. Defaults to planet-express.","type":"string"},"itemCount":{"minimum":1,"description":"Items consolidated; default 1.","type":"integer"}}},"minNetCents":{"minimum":0,"type":"integer"},"outboundShippingCents":{"minimum":0,"type":"integer"}}}}}}}}}},"/v1/evaluate/jobs/{id}":{"get":{"responses":{"200":{"description":"Job state.","content":{"application/json":{"schema":{"type":"object","allOf":[{"type":"object","required":["id","kind","status","cancelRequested","createdAt","startedAt","completedAt","expiresAt"],"properties":{"id":{"format":"uuid","type":"string"},"kind":{"anyOf":[{"type":"string","enum":["evaluate"]},{"type":"string","enum":["search"]}]},"status":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]}]},"errorCode":{"anyOf":[{"type":"string","nullable":true}]},"errorMessage":{"anyOf":[{"type":"string","nullable":true}]},"errorDetails":{"anyOf":[{"nullable":true}]},"cancelRequested":{"type":"boolean"},"createdAt":{"format":"date-time","type":"string"},"startedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"completedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"expiresAt":{"format":"date-time","type":"string"}}},{"type":"object","required":["kind","params","result","partial"],"properties":{"kind":{"type":"string","enum":["evaluate"]},"params":{"type":"object","required":["itemId"],"properties":{"itemId":{"minLength":1,"type":"string"},"lookbackDays":{"minimum":1,"maximum":90,"type":"integer"},"soldLimit":{"minimum":1,"maximum":200,"type":"integer"},"opts":{"type":"object","properties":{"forwarder":{"type":"object","required":["destState","weightG"],"properties":{"destState":{"minLength":2,"maxLength":2,"description":"ISO 3166-2 US state code, e.g. NY, TX, HI.","type":"string"},"weightG":{"minimum":1,"description":"Package weight in grams.","type":"integer"},"dimsCm":{"type":"object","required":["l","w","h"],"properties":{"l":{"minimum":0,"type":"number"},"w":{"minimum":0,"type":"number"},"h":{"minimum":0,"type":"number"}}},"provider":{"description":"Forwarder provider id. Defaults to planet-express.","type":"string"},"itemCount":{"minimum":1,"description":"Items consolidated; default 1.","type":"integer"}}},"minNetCents":{"minimum":0,"type":"integer"},"outboundShippingCents":{"minimum":0,"type":"integer"}}}}},"result":{"anyOf":[{"type":"object","required":["item","evaluation","market","sold","active","filter","returns","meta","soldPool","activePool","rejectedSoldPool","rejectedActivePool","rejectionReasons"],"properties":{"item":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"listingMarketplaceId":{"type":"string"},"sellerItemRevision":{"type":"string"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"description":{"type":"string"},"shortDescription":{"type":"string"},"categoryPath":{"type":"string"},"categoryId":{"type":"string"},"categoryIdPath":{"type":"string"},"localizedAspects":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"},"type":{"type":"string"}}}},"brand":{"type":"string"},"color":{"type":"string"},"size":{"type":"string"},"pattern":{"type":"string"},"material":{"type":"string"},"sizeType":{"type":"string"},"mpn":{"type":"string"},"gtin":{"type":"string"},"epid":{"type":"string"},"lotSize":{"type":"integer"},"quantityLimitPerBuyer":{"type":"integer"},"conditionDescription":{"type":"string"},"conditionDescriptors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"values":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"}}}}}}},"marketingPrice":{"type":"object","properties":{"originalPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"discountAmount":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"discountPercentage":{"type":"string"},"priceTreatment":{"type":"string"}}},"primaryProductReviewRating":{"type":"object","properties":{"reviewCount":{"type":"integer"},"averageRating":{"type":"string"},"ratingHistograms":{"type":"array","items":{"type":"object","required":["rating","count"],"properties":{"rating":{"type":"string"},"count":{"type":"integer"}}}}}},"warnings":{"type":"array","items":{"type":"object","properties":{"errorId":{"type":"integer"},"domain":{"type":"string"},"category":{"type":"string"},"message":{"type":"string"},"parameters":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}}}}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"priorityListing":{"type":"boolean"},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"estimatedAvailabilities":{"type":"array","items":{"type":"object","properties":{"estimatedAvailabilityStatus":{"type":"string"},"estimatedAvailableQuantity":{"type":"integer"},"estimatedSoldQuantity":{"type":"integer"},"estimatedRemainingQuantity":{"type":"integer"},"availabilityThreshold":{"type":"integer"},"availabilityThresholdType":{"type":"string"},"deliveryOptions":{"type":"array","items":{"type":"string"}}}}},"shipToLocations":{"type":"object","properties":{"regionIncluded":{"type":"array","items":{"type":"object","properties":{"regionName":{"type":"string"},"regionType":{"type":"string"},"regionId":{"type":"string"}}}},"regionExcluded":{"type":"array","items":{"type":"object","properties":{"regionName":{"type":"string"},"regionType":{"type":"string"},"regionId":{"type":"string"}}}}}},"returnTerms":{"type":"object","properties":{"returnsAccepted":{"type":"boolean"},"returnPeriod":{"type":"object","required":["value","unit"],"properties":{"value":{"type":"integer"},"unit":{"type":"string"}}},"returnShippingCostPayer":{"type":"string"},"refundMethod":{"type":"string"},"returnMethod":{"type":"string"}}},"taxes":{"type":"array","items":{"type":"object","properties":{"taxJurisdiction":{"type":"object","properties":{"region":{"type":"object","properties":{"regionName":{"type":"string"},"regionType":{"type":"string"}}},"taxJurisdictionId":{"type":"string"}}},"taxType":{"type":"string"},"shippingAndHandlingTaxed":{"type":"boolean"},"includedInPrice":{"type":"boolean"},"ebayCollectAndRemitTax":{"type":"boolean"},"taxPercentage":{"type":"string"}}}},"paymentMethods":{"type":"array","items":{"type":"object","properties":{"paymentMethodType":{"type":"string"},"paymentMethodBrands":{"type":"array","items":{"type":"object","properties":{"paymentMethodBrandType":{"type":"string"},"logoImage":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}}}}}}},"immediatePay":{"type":"boolean"},"enabledForGuestCheckout":{"type":"boolean"},"eligibleForInlineCheckout":{"type":"boolean"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"},"primaryItemGroup":{"type":"object","properties":{"itemGroupId":{"type":"string"},"itemGroupType":{"type":"string"},"itemGroupHref":{"type":"string"},"itemGroupTitle":{"type":"string"},"itemGroupImage":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"itemGroupAdditionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}}}},"unitPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"unitPricingMeasure":{"type":"string"}}},"evaluation":{"type":"object","required":["successNetCents","expectedNetCents","maxLossCents","landedCostCents","rating","reasonCode","reason","bidCeilingCents","safeBidBreakdown","netRangeCents","recommendedExit","risk"],"properties":{"successNetCents":{"anyOf":[{"type":"integer","nullable":true}]},"expectedNetCents":{"type":"integer"},"maxLossCents":{"anyOf":[{"type":"integer","nullable":true}]},"landedCostCents":{"anyOf":[{"type":"integer","nullable":true}]},"rating":{"anyOf":[{"type":"string","enum":["buy"]},{"type":"string","enum":["skip"]}]},"reasonCode":{"anyOf":[{"type":"string","enum":["cleared"]},{"type":"string","enum":["vetoed"]},{"type":"string","enum":["no_market"]},{"type":"string","enum":["insufficient_data"]},{"type":"string","enum":["below_min_net"]}]},"reason":{"type":"string"},"bidCeilingCents":{"anyOf":[{"type":"integer","nullable":true}]},"safeBidBreakdown":{"anyOf":[{"type":"object","required":["estimatedSaleCents","feesCents","shippingCents","targetNetCents"],"properties":{"estimatedSaleCents":{"type":"integer"},"feesCents":{"type":"integer"},"shippingCents":{"type":"integer"},"targetNetCents":{"type":"integer"}},"nullable":true}]},"netRangeCents":{"anyOf":[{"type":"object","required":["p10Cents","p90Cents"],"properties":{"p10Cents":{"type":"integer"},"p90Cents":{"type":"integer"}},"nullable":true}]},"recommendedExit":{"anyOf":[{"type":"object","required":["listPriceCents","expectedDaysToSell","daysLow","daysHigh","netCents","dollarsPerDay","queueAhead","asksAbove"],"properties":{"listPriceCents":{"type":"integer"},"expectedDaysToSell":{"type":"number"},"daysLow":{"type":"number"},"daysHigh":{"type":"number"},"netCents":{"type":"integer"},"dollarsPerDay":{"type":"integer"},"queueAhead":{"type":"integer"},"asksAbove":{"type":"integer"}},"nullable":true}]},"risk":{"anyOf":[{"type":"object","required":["P_fraud","withinReturnWindow","cycleDays","reason"],"properties":{"P_fraud":{"type":"number"},"withinReturnWindow":{"type":"boolean"},"cycleDays":{"type":"integer"},"reason":{"type":"string"}},"nullable":true}]}}},"evaluationAll":{"type":"object","required":["successNetCents","expectedNetCents","maxLossCents","landedCostCents","rating","reasonCode","reason","bidCeilingCents","safeBidBreakdown","netRangeCents","recommendedExit","risk"],"properties":{"successNetCents":{"anyOf":[{"type":"integer","nullable":true}]},"expectedNetCents":{"type":"integer"},"maxLossCents":{"anyOf":[{"type":"integer","nullable":true}]},"landedCostCents":{"anyOf":[{"type":"integer","nullable":true}]},"rating":{"anyOf":[{"type":"string","enum":["buy"]},{"type":"string","enum":["skip"]}]},"reasonCode":{"anyOf":[{"type":"string","enum":["cleared"]},{"type":"string","enum":["vetoed"]},{"type":"string","enum":["no_market"]},{"type":"string","enum":["insufficient_data"]},{"type":"string","enum":["below_min_net"]}]},"reason":{"type":"string"},"bidCeilingCents":{"anyOf":[{"type":"integer","nullable":true}]},"safeBidBreakdown":{"anyOf":[{"type":"object","required":["estimatedSaleCents","feesCents","shippingCents","targetNetCents"],"properties":{"estimatedSaleCents":{"type":"integer"},"feesCents":{"type":"integer"},"shippingCents":{"type":"integer"},"targetNetCents":{"type":"integer"}},"nullable":true}]},"netRangeCents":{"anyOf":[{"type":"object","required":["p10Cents","p90Cents"],"properties":{"p10Cents":{"type":"integer"},"p90Cents":{"type":"integer"}},"nullable":true}]},"recommendedExit":{"anyOf":[{"type":"object","required":["listPriceCents","expectedDaysToSell","daysLow","daysHigh","netCents","dollarsPerDay","queueAhead","asksAbove"],"properties":{"listPriceCents":{"type":"integer"},"expectedDaysToSell":{"type":"number"},"daysLow":{"type":"number"},"daysHigh":{"type":"number"},"netCents":{"type":"integer"},"dollarsPerDay":{"type":"integer"},"queueAhead":{"type":"integer"},"asksAbove":{"type":"integer"}},"nullable":true}]},"risk":{"anyOf":[{"type":"object","required":["P_fraud","withinReturnWindow","cycleDays","reason"],"properties":{"P_fraud":{"type":"number"},"withinReturnWindow":{"type":"boolean"},"cycleDays":{"type":"integer"},"reason":{"type":"string"}},"nullable":true}]}}},"market":{"type":"object","required":["keyword","marketplace","windowDays","meanCents","stdDevCents","medianCents","p25Cents","p75Cents","nObservations","salesPerDay","asOf"],"properties":{"keyword":{"type":"string"},"marketplace":{"type":"string"},"windowDays":{"type":"integer"},"meanCents":{"type":"integer"},"stdDevCents":{"type":"integer"},"medianCents":{"type":"integer"},"medianCiLowCents":{"type":"integer"},"medianCiHighCents":{"type":"integer"},"p25Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"nObservations":{"type":"integer"},"salesPerDay":{"type":"number"},"salesPerDayBaseline":{"type":"number"},"salesPerDaySeed":{"type":"number"},"meanDaysToSell":{"type":"number"},"daysStdDev":{"type":"number"},"daysP50":{"type":"number"},"daysP70":{"type":"number"},"daysP90":{"type":"number"},"nDurations":{"type":"integer"},"asks":{"type":"object","required":["meanCents","stdDevCents","medianCents","p25Cents","p75Cents","nActive"],"properties":{"meanCents":{"type":"integer"},"stdDevCents":{"type":"integer"},"medianCents":{"type":"integer"},"p25Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"nActive":{"type":"integer"}}},"asOf":{"type":"string"}}},"sold":{"type":"object","required":["count","windowDays","salesPerDay","meanDaysToSell","priceCents","priceHistogram","conditionMix","recentTrend","lastSaleAt","lastSalePriceCents"],"properties":{"count":{"type":"integer"},"windowDays":{"type":"integer"},"salesPerDay":{"type":"number"},"meanDaysToSell":{"anyOf":[{"type":"number","nullable":true}]},"priceCents":{"type":"object","required":["minCents","p10Cents","p25Cents","p50Cents","p75Cents","p90Cents","maxCents"],"properties":{"minCents":{"type":"integer"},"p10Cents":{"type":"integer"},"p25Cents":{"type":"integer"},"p50Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"p90Cents":{"type":"integer"},"maxCents":{"type":"integer"}}},"priceHistogram":{"type":"array","items":{"type":"object","required":["minCents","maxCents","count"],"properties":{"minCents":{"type":"integer"},"maxCents":{"type":"integer"},"count":{"type":"integer"}}}},"conditionMix":{"type":"object","additionalProperties":true},"recentTrend":{"anyOf":[{"type":"object","required":["direction","change14dPct"],"properties":{"direction":{"anyOf":[{"type":"string","enum":["up"]},{"type":"string","enum":["flat"]},{"type":"string","enum":["down"]}]},"change14dPct":{"type":"number"}},"nullable":true}]},"lastSaleAt":{"anyOf":[{"type":"string","nullable":true}]},"lastSalePriceCents":{"anyOf":[{"type":"integer","nullable":true}]}}},"active":{"type":"object","required":["count","priceCents","priceHistogram","conditionMix","bestPriceCents","sellerConcentration"],"properties":{"count":{"type":"integer"},"priceCents":{"type":"object","required":["minCents","p10Cents","p25Cents","p50Cents","p75Cents","p90Cents","maxCents"],"properties":{"minCents":{"type":"integer"},"p10Cents":{"type":"integer"},"p25Cents":{"type":"integer"},"p50Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"p90Cents":{"type":"integer"},"maxCents":{"type":"integer"}}},"priceHistogram":{"type":"array","items":{"type":"object","required":["minCents","maxCents","count"],"properties":{"minCents":{"type":"integer"},"maxCents":{"type":"integer"},"count":{"type":"integer"}}}},"conditionMix":{"type":"object","additionalProperties":true},"bestPriceCents":{"anyOf":[{"type":"integer","nullable":true}]},"sellerConcentration":{"anyOf":[{"type":"string","enum":["diverse"]},{"type":"string","enum":["few_sellers"]}]}}},"marketAll":{"type":"object","required":["keyword","marketplace","windowDays","meanCents","stdDevCents","medianCents","p25Cents","p75Cents","nObservations","salesPerDay","asOf"],"properties":{"keyword":{"type":"string"},"marketplace":{"type":"string"},"windowDays":{"type":"integer"},"meanCents":{"type":"integer"},"stdDevCents":{"type":"integer"},"medianCents":{"type":"integer"},"medianCiLowCents":{"type":"integer"},"medianCiHighCents":{"type":"integer"},"p25Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"nObservations":{"type":"integer"},"salesPerDay":{"type":"number"},"salesPerDayBaseline":{"type":"number"},"salesPerDaySeed":{"type":"number"},"meanDaysToSell":{"type":"number"},"daysStdDev":{"type":"number"},"daysP50":{"type":"number"},"daysP70":{"type":"number"},"daysP90":{"type":"number"},"nDurations":{"type":"integer"},"asks":{"type":"object","required":["meanCents","stdDevCents","medianCents","p25Cents","p75Cents","nActive"],"properties":{"meanCents":{"type":"integer"},"stdDevCents":{"type":"integer"},"medianCents":{"type":"integer"},"p25Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"nActive":{"type":"integer"}}},"asOf":{"type":"string"}}},"soldAll":{"type":"object","required":["count","windowDays","salesPerDay","meanDaysToSell","priceCents","priceHistogram","conditionMix","recentTrend","lastSaleAt","lastSalePriceCents"],"properties":{"count":{"type":"integer"},"windowDays":{"type":"integer"},"salesPerDay":{"type":"number"},"meanDaysToSell":{"anyOf":[{"type":"number","nullable":true}]},"priceCents":{"type":"object","required":["minCents","p10Cents","p25Cents","p50Cents","p75Cents","p90Cents","maxCents"],"properties":{"minCents":{"type":"integer"},"p10Cents":{"type":"integer"},"p25Cents":{"type":"integer"},"p50Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"p90Cents":{"type":"integer"},"maxCents":{"type":"integer"}}},"priceHistogram":{"type":"array","items":{"type":"object","required":["minCents","maxCents","count"],"properties":{"minCents":{"type":"integer"},"maxCents":{"type":"integer"},"count":{"type":"integer"}}}},"conditionMix":{"type":"object","additionalProperties":true},"recentTrend":{"anyOf":[{"type":"object","required":["direction","change14dPct"],"properties":{"direction":{"anyOf":[{"type":"string","enum":["up"]},{"type":"string","enum":["flat"]},{"type":"string","enum":["down"]}]},"change14dPct":{"type":"number"}},"nullable":true}]},"lastSaleAt":{"anyOf":[{"type":"string","nullable":true}]},"lastSalePriceCents":{"anyOf":[{"type":"integer","nullable":true}]}}},"activeAll":{"type":"object","required":["count","priceCents","priceHistogram","conditionMix","bestPriceCents","sellerConcentration"],"properties":{"count":{"type":"integer"},"priceCents":{"type":"object","required":["minCents","p10Cents","p25Cents","p50Cents","p75Cents","p90Cents","maxCents"],"properties":{"minCents":{"type":"integer"},"p10Cents":{"type":"integer"},"p25Cents":{"type":"integer"},"p50Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"p90Cents":{"type":"integer"},"maxCents":{"type":"integer"}}},"priceHistogram":{"type":"array","items":{"type":"object","required":["minCents","maxCents","count"],"properties":{"minCents":{"type":"integer"},"maxCents":{"type":"integer"},"count":{"type":"integer"}}}},"conditionMix":{"type":"object","additionalProperties":true},"bestPriceCents":{"anyOf":[{"type":"integer","nullable":true}]},"sellerConcentration":{"anyOf":[{"type":"string","enum":["diverse"]},{"type":"string","enum":["few_sellers"]}]}}},"filter":{"type":"object","required":["soldKept","soldRejected","activeKept","activeRejected","rejectionsByCategory"],"properties":{"soldKept":{"type":"integer"},"soldRejected":{"type":"integer"},"activeKept":{"type":"integer"},"activeRejected":{"type":"integer"},"rejectionsByCategory":{"type":"object","additionalProperties":true}}},"returns":{"anyOf":[{"type":"object","required":["accepted"],"properties":{"accepted":{"type":"boolean"},"periodDays":{"minimum":0,"type":"integer"},"shippingCostPaidBy":{"anyOf":[{"type":"string","enum":["BUYER"]},{"type":"string","enum":["SELLER"]}]}},"nullable":true}]},"meta":{"type":"object","required":["soldCount","activeCount","soldKept","soldRejected","activeKept","activeRejected"],"properties":{"soldCount":{"type":"integer"},"activeCount":{"type":"integer"},"soldKept":{"type":"integer"},"soldRejected":{"type":"integer"},"activeKept":{"type":"integer"},"activeRejected":{"type":"integer"}}},"soldPool":{"type":"array","items":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"itemAffiliateWebUrl":{"type":"string"},"itemHref":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"lastSoldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"lastSoldDate":{"type":"string"},"totalSoldQuantity":{"type":"integer"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"thumbnailImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"epid":{"type":"string"},"gtin":{"type":"string"},"categoryId":{"type":"string"},"leafCategoryIds":{"type":"array","items":{"type":"string"}},"itemGroupHref":{"type":"string"},"itemGroupType":{"type":"string"},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"listingMarketplaceId":{"type":"string"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"}}}},"activePool":{"type":"array","items":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"itemAffiliateWebUrl":{"type":"string"},"itemHref":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"lastSoldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"lastSoldDate":{"type":"string"},"totalSoldQuantity":{"type":"integer"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"thumbnailImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"epid":{"type":"string"},"gtin":{"type":"string"},"categoryId":{"type":"string"},"leafCategoryIds":{"type":"array","items":{"type":"string"}},"itemGroupHref":{"type":"string"},"itemGroupType":{"type":"string"},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"listingMarketplaceId":{"type":"string"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"}}}},"rejectedSoldPool":{"type":"array","items":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"itemAffiliateWebUrl":{"type":"string"},"itemHref":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"lastSoldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"lastSoldDate":{"type":"string"},"totalSoldQuantity":{"type":"integer"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"thumbnailImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"epid":{"type":"string"},"gtin":{"type":"string"},"categoryId":{"type":"string"},"leafCategoryIds":{"type":"array","items":{"type":"string"}},"itemGroupHref":{"type":"string"},"itemGroupType":{"type":"string"},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"listingMarketplaceId":{"type":"string"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"}}}},"rejectedActivePool":{"type":"array","items":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"itemAffiliateWebUrl":{"type":"string"},"itemHref":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"lastSoldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"lastSoldDate":{"type":"string"},"totalSoldQuantity":{"type":"integer"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"thumbnailImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"epid":{"type":"string"},"gtin":{"type":"string"},"categoryId":{"type":"string"},"leafCategoryIds":{"type":"array","items":{"type":"string"}},"itemGroupHref":{"type":"string"},"itemGroupType":{"type":"string"},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"listingMarketplaceId":{"type":"string"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"}}}},"rejectionReasons":{"type":"object","additionalProperties":true},"rejectionCategories":{"type":"object","additionalProperties":true},"suspiciousIds":{"type":"object","additionalProperties":true}},"nullable":true}]},"partial":{"anyOf":[{"type":"object","properties":{"item":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"listingMarketplaceId":{"type":"string"},"sellerItemRevision":{"type":"string"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"description":{"type":"string"},"shortDescription":{"type":"string"},"categoryPath":{"type":"string"},"categoryId":{"type":"string"},"categoryIdPath":{"type":"string"},"localizedAspects":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"},"type":{"type":"string"}}}},"brand":{"type":"string"},"color":{"type":"string"},"size":{"type":"string"},"pattern":{"type":"string"},"material":{"type":"string"},"sizeType":{"type":"string"},"mpn":{"type":"string"},"gtin":{"type":"string"},"epid":{"type":"string"},"lotSize":{"type":"integer"},"quantityLimitPerBuyer":{"type":"integer"},"conditionDescription":{"type":"string"},"conditionDescriptors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"values":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"}}}}}}},"marketingPrice":{"type":"object","properties":{"originalPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"discountAmount":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"discountPercentage":{"type":"string"},"priceTreatment":{"type":"string"}}},"primaryProductReviewRating":{"type":"object","properties":{"reviewCount":{"type":"integer"},"averageRating":{"type":"string"},"ratingHistograms":{"type":"array","items":{"type":"object","required":["rating","count"],"properties":{"rating":{"type":"string"},"count":{"type":"integer"}}}}}},"warnings":{"type":"array","items":{"type":"object","properties":{"errorId":{"type":"integer"},"domain":{"type":"string"},"category":{"type":"string"},"message":{"type":"string"},"parameters":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}}}}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"priorityListing":{"type":"boolean"},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"estimatedAvailabilities":{"type":"array","items":{"type":"object","properties":{"estimatedAvailabilityStatus":{"type":"string"},"estimatedAvailableQuantity":{"type":"integer"},"estimatedSoldQuantity":{"type":"integer"},"estimatedRemainingQuantity":{"type":"integer"},"availabilityThreshold":{"type":"integer"},"availabilityThresholdType":{"type":"string"},"deliveryOptions":{"type":"array","items":{"type":"string"}}}}},"shipToLocations":{"type":"object","properties":{"regionIncluded":{"type":"array","items":{"type":"object","properties":{"regionName":{"type":"string"},"regionType":{"type":"string"},"regionId":{"type":"string"}}}},"regionExcluded":{"type":"array","items":{"type":"object","properties":{"regionName":{"type":"string"},"regionType":{"type":"string"},"regionId":{"type":"string"}}}}}},"returnTerms":{"type":"object","properties":{"returnsAccepted":{"type":"boolean"},"returnPeriod":{"type":"object","required":["value","unit"],"properties":{"value":{"type":"integer"},"unit":{"type":"string"}}},"returnShippingCostPayer":{"type":"string"},"refundMethod":{"type":"string"},"returnMethod":{"type":"string"}}},"taxes":{"type":"array","items":{"type":"object","properties":{"taxJurisdiction":{"type":"object","properties":{"region":{"type":"object","properties":{"regionName":{"type":"string"},"regionType":{"type":"string"}}},"taxJurisdictionId":{"type":"string"}}},"taxType":{"type":"string"},"shippingAndHandlingTaxed":{"type":"boolean"},"includedInPrice":{"type":"boolean"},"ebayCollectAndRemitTax":{"type":"boolean"},"taxPercentage":{"type":"string"}}}},"paymentMethods":{"type":"array","items":{"type":"object","properties":{"paymentMethodType":{"type":"string"},"paymentMethodBrands":{"type":"array","items":{"type":"object","properties":{"paymentMethodBrandType":{"type":"string"},"logoImage":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}}}}}}},"immediatePay":{"type":"boolean"},"enabledForGuestCheckout":{"type":"boolean"},"eligibleForInlineCheckout":{"type":"boolean"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"},"primaryItemGroup":{"type":"object","properties":{"itemGroupId":{"type":"string"},"itemGroupType":{"type":"string"},"itemGroupHref":{"type":"string"},"itemGroupTitle":{"type":"string"},"itemGroupImage":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"itemGroupAdditionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}}}},"unitPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"unitPricingMeasure":{"type":"string"}}},"soldPool":{"type":"array","items":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"itemAffiliateWebUrl":{"type":"string"},"itemHref":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"lastSoldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"lastSoldDate":{"type":"string"},"totalSoldQuantity":{"type":"integer"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"thumbnailImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"epid":{"type":"string"},"gtin":{"type":"string"},"categoryId":{"type":"string"},"leafCategoryIds":{"type":"array","items":{"type":"string"}},"itemGroupHref":{"type":"string"},"itemGroupType":{"type":"string"},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"listingMarketplaceId":{"type":"string"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"}}}},"activePool":{"type":"array","items":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"itemAffiliateWebUrl":{"type":"string"},"itemHref":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"lastSoldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"lastSoldDate":{"type":"string"},"totalSoldQuantity":{"type":"integer"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"thumbnailImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"epid":{"type":"string"},"gtin":{"type":"string"},"categoryId":{"type":"string"},"leafCategoryIds":{"type":"array","items":{"type":"string"}},"itemGroupHref":{"type":"string"},"itemGroupType":{"type":"string"},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"listingMarketplaceId":{"type":"string"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"}}}},"rejectedSoldPool":{"type":"array","items":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"itemAffiliateWebUrl":{"type":"string"},"itemHref":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"lastSoldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"lastSoldDate":{"type":"string"},"totalSoldQuantity":{"type":"integer"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"thumbnailImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"epid":{"type":"string"},"gtin":{"type":"string"},"categoryId":{"type":"string"},"leafCategoryIds":{"type":"array","items":{"type":"string"}},"itemGroupHref":{"type":"string"},"itemGroupType":{"type":"string"},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"listingMarketplaceId":{"type":"string"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"}}}},"rejectedActivePool":{"type":"array","items":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"itemAffiliateWebUrl":{"type":"string"},"itemHref":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"lastSoldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"lastSoldDate":{"type":"string"},"totalSoldQuantity":{"type":"integer"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"thumbnailImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"epid":{"type":"string"},"gtin":{"type":"string"},"categoryId":{"type":"string"},"leafCategoryIds":{"type":"array","items":{"type":"string"}},"itemGroupHref":{"type":"string"},"itemGroupType":{"type":"string"},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"listingMarketplaceId":{"type":"string"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"}}}},"rejectionReasons":{"type":"object","additionalProperties":true},"rejectionCategories":{"type":"object","additionalProperties":true},"market":{"type":"object","required":["keyword","marketplace","windowDays","meanCents","stdDevCents","medianCents","p25Cents","p75Cents","nObservations","salesPerDay","asOf"],"properties":{"keyword":{"type":"string"},"marketplace":{"type":"string"},"windowDays":{"type":"integer"},"meanCents":{"type":"integer"},"stdDevCents":{"type":"integer"},"medianCents":{"type":"integer"},"medianCiLowCents":{"type":"integer"},"medianCiHighCents":{"type":"integer"},"p25Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"nObservations":{"type":"integer"},"salesPerDay":{"type":"number"},"salesPerDayBaseline":{"type":"number"},"salesPerDaySeed":{"type":"number"},"meanDaysToSell":{"type":"number"},"daysStdDev":{"type":"number"},"daysP50":{"type":"number"},"daysP70":{"type":"number"},"daysP90":{"type":"number"},"nDurations":{"type":"integer"},"asks":{"type":"object","required":["meanCents","stdDevCents","medianCents","p25Cents","p75Cents","nActive"],"properties":{"meanCents":{"type":"integer"},"stdDevCents":{"type":"integer"},"medianCents":{"type":"integer"},"p25Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"nActive":{"type":"integer"}}},"asOf":{"type":"string"}}},"sold":{"type":"object","required":["count","windowDays","salesPerDay","meanDaysToSell","priceCents","priceHistogram","conditionMix","recentTrend","lastSaleAt","lastSalePriceCents"],"properties":{"count":{"type":"integer"},"windowDays":{"type":"integer"},"salesPerDay":{"type":"number"},"meanDaysToSell":{"anyOf":[{"type":"number","nullable":true}]},"priceCents":{"type":"object","required":["minCents","p10Cents","p25Cents","p50Cents","p75Cents","p90Cents","maxCents"],"properties":{"minCents":{"type":"integer"},"p10Cents":{"type":"integer"},"p25Cents":{"type":"integer"},"p50Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"p90Cents":{"type":"integer"},"maxCents":{"type":"integer"}}},"priceHistogram":{"type":"array","items":{"type":"object","required":["minCents","maxCents","count"],"properties":{"minCents":{"type":"integer"},"maxCents":{"type":"integer"},"count":{"type":"integer"}}}},"conditionMix":{"type":"object","additionalProperties":true},"recentTrend":{"anyOf":[{"type":"object","required":["direction","change14dPct"],"properties":{"direction":{"anyOf":[{"type":"string","enum":["up"]},{"type":"string","enum":["flat"]},{"type":"string","enum":["down"]}]},"change14dPct":{"type":"number"}},"nullable":true}]},"lastSaleAt":{"anyOf":[{"type":"string","nullable":true}]},"lastSalePriceCents":{"anyOf":[{"type":"integer","nullable":true}]}}},"active":{"type":"object","required":["count","priceCents","priceHistogram","conditionMix","bestPriceCents","sellerConcentration"],"properties":{"count":{"type":"integer"},"priceCents":{"type":"object","required":["minCents","p10Cents","p25Cents","p50Cents","p75Cents","p90Cents","maxCents"],"properties":{"minCents":{"type":"integer"},"p10Cents":{"type":"integer"},"p25Cents":{"type":"integer"},"p50Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"p90Cents":{"type":"integer"},"maxCents":{"type":"integer"}}},"priceHistogram":{"type":"array","items":{"type":"object","required":["minCents","maxCents","count"],"properties":{"minCents":{"type":"integer"},"maxCents":{"type":"integer"},"count":{"type":"integer"}}}},"conditionMix":{"type":"object","additionalProperties":true},"bestPriceCents":{"anyOf":[{"type":"integer","nullable":true}]},"sellerConcentration":{"anyOf":[{"type":"string","enum":["diverse"]},{"type":"string","enum":["few_sellers"]}]}}},"marketAll":{"type":"object","required":["keyword","marketplace","windowDays","meanCents","stdDevCents","medianCents","p25Cents","p75Cents","nObservations","salesPerDay","asOf"],"properties":{"keyword":{"type":"string"},"marketplace":{"type":"string"},"windowDays":{"type":"integer"},"meanCents":{"type":"integer"},"stdDevCents":{"type":"integer"},"medianCents":{"type":"integer"},"medianCiLowCents":{"type":"integer"},"medianCiHighCents":{"type":"integer"},"p25Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"nObservations":{"type":"integer"},"salesPerDay":{"type":"number"},"salesPerDayBaseline":{"type":"number"},"salesPerDaySeed":{"type":"number"},"meanDaysToSell":{"type":"number"},"daysStdDev":{"type":"number"},"daysP50":{"type":"number"},"daysP70":{"type":"number"},"daysP90":{"type":"number"},"nDurations":{"type":"integer"},"asks":{"type":"object","required":["meanCents","stdDevCents","medianCents","p25Cents","p75Cents","nActive"],"properties":{"meanCents":{"type":"integer"},"stdDevCents":{"type":"integer"},"medianCents":{"type":"integer"},"p25Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"nActive":{"type":"integer"}}},"asOf":{"type":"string"}}},"soldAll":{"type":"object","required":["count","windowDays","salesPerDay","meanDaysToSell","priceCents","priceHistogram","conditionMix","recentTrend","lastSaleAt","lastSalePriceCents"],"properties":{"count":{"type":"integer"},"windowDays":{"type":"integer"},"salesPerDay":{"type":"number"},"meanDaysToSell":{"anyOf":[{"type":"number","nullable":true}]},"priceCents":{"type":"object","required":["minCents","p10Cents","p25Cents","p50Cents","p75Cents","p90Cents","maxCents"],"properties":{"minCents":{"type":"integer"},"p10Cents":{"type":"integer"},"p25Cents":{"type":"integer"},"p50Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"p90Cents":{"type":"integer"},"maxCents":{"type":"integer"}}},"priceHistogram":{"type":"array","items":{"type":"object","required":["minCents","maxCents","count"],"properties":{"minCents":{"type":"integer"},"maxCents":{"type":"integer"},"count":{"type":"integer"}}}},"conditionMix":{"type":"object","additionalProperties":true},"recentTrend":{"anyOf":[{"type":"object","required":["direction","change14dPct"],"properties":{"direction":{"anyOf":[{"type":"string","enum":["up"]},{"type":"string","enum":["flat"]},{"type":"string","enum":["down"]}]},"change14dPct":{"type":"number"}},"nullable":true}]},"lastSaleAt":{"anyOf":[{"type":"string","nullable":true}]},"lastSalePriceCents":{"anyOf":[{"type":"integer","nullable":true}]}}},"activeAll":{"type":"object","required":["count","priceCents","priceHistogram","conditionMix","bestPriceCents","sellerConcentration"],"properties":{"count":{"type":"integer"},"priceCents":{"type":"object","required":["minCents","p10Cents","p25Cents","p50Cents","p75Cents","p90Cents","maxCents"],"properties":{"minCents":{"type":"integer"},"p10Cents":{"type":"integer"},"p25Cents":{"type":"integer"},"p50Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"p90Cents":{"type":"integer"},"maxCents":{"type":"integer"}}},"priceHistogram":{"type":"array","items":{"type":"object","required":["minCents","maxCents","count"],"properties":{"minCents":{"type":"integer"},"maxCents":{"type":"integer"},"count":{"type":"integer"}}}},"conditionMix":{"type":"object","additionalProperties":true},"bestPriceCents":{"anyOf":[{"type":"integer","nullable":true}]},"sellerConcentration":{"anyOf":[{"type":"string","enum":["diverse"]},{"type":"string","enum":["few_sellers"]}]}}},"filter":{"type":"object","required":["soldKept","soldRejected","activeKept","activeRejected","rejectionsByCategory"],"properties":{"soldKept":{"type":"integer"},"soldRejected":{"type":"integer"},"activeKept":{"type":"integer"},"activeRejected":{"type":"integer"},"rejectionsByCategory":{"type":"object","additionalProperties":true}}},"filterProgress":{"type":"object","required":["processed","total"],"properties":{"processed":{"minimum":0,"type":"integer"},"total":{"minimum":0,"type":"integer"}}},"returns":{"anyOf":[{"type":"object","required":["accepted"],"properties":{"accepted":{"type":"boolean"},"periodDays":{"minimum":0,"type":"integer"},"shippingCostPaidBy":{"anyOf":[{"type":"string","enum":["BUYER"]},{"type":"string","enum":["SELLER"]}]}},"nullable":true}]},"meta":{"type":"object","required":["soldCount","activeCount","soldKept","soldRejected","activeKept","activeRejected"],"properties":{"soldCount":{"type":"integer"},"activeCount":{"type":"integer"},"soldKept":{"type":"integer"},"soldRejected":{"type":"integer"},"activeKept":{"type":"integer"},"activeRejected":{"type":"integer"}}},"evaluation":{"type":"object","required":["successNetCents","expectedNetCents","maxLossCents","landedCostCents","rating","reasonCode","reason","bidCeilingCents","safeBidBreakdown","netRangeCents","recommendedExit","risk"],"properties":{"successNetCents":{"anyOf":[{"type":"integer","nullable":true}]},"expectedNetCents":{"type":"integer"},"maxLossCents":{"anyOf":[{"type":"integer","nullable":true}]},"landedCostCents":{"anyOf":[{"type":"integer","nullable":true}]},"rating":{"anyOf":[{"type":"string","enum":["buy"]},{"type":"string","enum":["skip"]}]},"reasonCode":{"anyOf":[{"type":"string","enum":["cleared"]},{"type":"string","enum":["vetoed"]},{"type":"string","enum":["no_market"]},{"type":"string","enum":["insufficient_data"]},{"type":"string","enum":["below_min_net"]}]},"reason":{"type":"string"},"bidCeilingCents":{"anyOf":[{"type":"integer","nullable":true}]},"safeBidBreakdown":{"anyOf":[{"type":"object","required":["estimatedSaleCents","feesCents","shippingCents","targetNetCents"],"properties":{"estimatedSaleCents":{"type":"integer"},"feesCents":{"type":"integer"},"shippingCents":{"type":"integer"},"targetNetCents":{"type":"integer"}},"nullable":true}]},"netRangeCents":{"anyOf":[{"type":"object","required":["p10Cents","p90Cents"],"properties":{"p10Cents":{"type":"integer"},"p90Cents":{"type":"integer"}},"nullable":true}]},"recommendedExit":{"anyOf":[{"type":"object","required":["listPriceCents","expectedDaysToSell","daysLow","daysHigh","netCents","dollarsPerDay","queueAhead","asksAbove"],"properties":{"listPriceCents":{"type":"integer"},"expectedDaysToSell":{"type":"number"},"daysLow":{"type":"number"},"daysHigh":{"type":"number"},"netCents":{"type":"integer"},"dollarsPerDay":{"type":"integer"},"queueAhead":{"type":"integer"},"asksAbove":{"type":"integer"}},"nullable":true}]},"risk":{"anyOf":[{"type":"object","required":["P_fraud","withinReturnWindow","cycleDays","reason"],"properties":{"P_fraud":{"type":"number"},"withinReturnWindow":{"type":"boolean"},"cycleDays":{"type":"integer"},"reason":{"type":"string"}},"nullable":true}]}}},"evaluationAll":{"type":"object","required":["successNetCents","expectedNetCents","maxLossCents","landedCostCents","rating","reasonCode","reason","bidCeilingCents","safeBidBreakdown","netRangeCents","recommendedExit","risk"],"properties":{"successNetCents":{"anyOf":[{"type":"integer","nullable":true}]},"expectedNetCents":{"type":"integer"},"maxLossCents":{"anyOf":[{"type":"integer","nullable":true}]},"landedCostCents":{"anyOf":[{"type":"integer","nullable":true}]},"rating":{"anyOf":[{"type":"string","enum":["buy"]},{"type":"string","enum":["skip"]}]},"reasonCode":{"anyOf":[{"type":"string","enum":["cleared"]},{"type":"string","enum":["vetoed"]},{"type":"string","enum":["no_market"]},{"type":"string","enum":["insufficient_data"]},{"type":"string","enum":["below_min_net"]}]},"reason":{"type":"string"},"bidCeilingCents":{"anyOf":[{"type":"integer","nullable":true}]},"safeBidBreakdown":{"anyOf":[{"type":"object","required":["estimatedSaleCents","feesCents","shippingCents","targetNetCents"],"properties":{"estimatedSaleCents":{"type":"integer"},"feesCents":{"type":"integer"},"shippingCents":{"type":"integer"},"targetNetCents":{"type":"integer"}},"nullable":true}]},"netRangeCents":{"anyOf":[{"type":"object","required":["p10Cents","p90Cents"],"properties":{"p10Cents":{"type":"integer"},"p90Cents":{"type":"integer"}},"nullable":true}]},"recommendedExit":{"anyOf":[{"type":"object","required":["listPriceCents","expectedDaysToSell","daysLow","daysHigh","netCents","dollarsPerDay","queueAhead","asksAbove"],"properties":{"listPriceCents":{"type":"integer"},"expectedDaysToSell":{"type":"number"},"daysLow":{"type":"number"},"daysHigh":{"type":"number"},"netCents":{"type":"integer"},"dollarsPerDay":{"type":"integer"},"queueAhead":{"type":"integer"},"asksAbove":{"type":"integer"}},"nullable":true}]},"risk":{"anyOf":[{"type":"object","required":["P_fraud","withinReturnWindow","cycleDays","reason"],"properties":{"P_fraud":{"type":"number"},"withinReturnWindow":{"type":"boolean"},"cycleDays":{"type":"integer"},"reason":{"type":"string"}},"nullable":true}]}}},"suspiciousIds":{"type":"object","additionalProperties":true},"preliminary":{"type":"boolean"}},"nullable":true}]}}}]}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Job not found or expired.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1EvaluateJobsById","tags":["Evaluate"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Get current state + result (when complete) for an evaluate job","description":"Returns the full job row — `status`, `params`, `result` (set iff `status === \"completed\"`), and `partial` (the merged `EvaluatePartial` accumulated so far, non-null once the run starts emitting state). 7-day retention; older rows return 404. Polling cadence at the caller's discretion; for live updates without polling, use `/stream`."}},"/v1/evaluate/active":{"get":{"responses":{"200":{"description":"Active job or null."},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1EvaluateActive","tags":["Evaluate"],"parameters":[],"summary":"Find the in-progress evaluate job for an itemId, if any","description":"Returns the active (queued or running) evaluate job for `(apiKey, itemId)`. Used by clients to attach to a job started by another surface (e.g. the extension chip auto-syncs with a playground run). Returns `null` when no active job exists."}},"/v1/evaluate/jobs/{id}/stream":{"get":{"responses":{"200":{"description":"SSE stream of pipeline events."},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Job not found or expired.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1EvaluateJobsByIdStream","tags":["Evaluate"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Live SSE stream of an evaluate job's events","description":"Replays accumulated step lifecycle (`started` / `succeeded` / `failed`) and `partial` state-hydration events from the job's `trace` column, then live-streams new events as the worker emits them, ending with a terminal `done` / `cancelled` / `error` event. Reconnect-safe: closing and reopening the stream replays everything from the start and resumes live, so a tab that reloaded mid-run picks up exactly where it left off."}},"/v1/evaluate/jobs/{id}/cancel":{"post":{"responses":{"200":{"description":"Cancel acknowledged.","content":{"application/json":{"schema":{"type":"object","required":["id","status"],"properties":{"id":{"format":"uuid","type":"string"},"status":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]}]}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Job not found or expired.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1EvaluateJobsByIdCancel","tags":["Evaluate"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Request cooperative cancel for an evaluate job","description":"Sets `cancel_requested = true` on the row. The worker checks this between pipeline steps and tears down at the next boundary, transitioning to `status: \"cancelled\"`. Mid-step IO (eBay scrape, LLM call) cannot be aborted but step boundaries are tight (≤ a few seconds each). Idempotent — calling cancel on a terminal job returns the current state unchanged."}},"/v1/jobs":{"get":{"responses":{"200":{"description":"Recent jobs.","content":{"application/json":{"schema":{"type":"object","required":["items","cursor"],"properties":{"items":{"type":"array","items":{"type":"object","required":["id","kind","status","label","params","errorCode","createdAt","completedAt"],"properties":{"id":{"format":"uuid","type":"string"},"kind":{"anyOf":[{"type":"string","enum":["evaluate"]},{"type":"string","enum":["search"]}]},"status":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]}]},"label":{"type":"string"},"subLabel":{"type":"string"},"imageUrl":{"format":"uri","type":"string"},"params":{},"errorCode":{"anyOf":[{"type":"string","nullable":true}]},"createdAt":{"format":"date-time","type":"string"},"completedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}}},"cursor":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}}}}},"400":{"description":"Invalid query parameter.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1Jobs","tags":["Jobs"],"parameters":[],"summary":"List recent operations (cross-surface, cross-kind history)","description":"Returns recent compute jobs created by this API key — across every surface (extension, playground, MCP, agent, SDK) and kind (evaluate, search). Lean per-row shape: `{ id, kind, status, label, subLabel?, imageUrl?, createdAt, completedAt }`. Click-through hits per-kind get (`/v1/evaluate/jobs/{id}` etc.) for the full result. Free read; never charged. Filters: `kind=evaluate|search`, `status=...`, `since=<ISO>`, `cursor=<ISO>` (keyset paging — pass the previous page's last `createdAt`), `limit` (default 20, max 100)."}},"/v1/purchases":{"post":{"responses":{"201":{"description":"Purchase (status may be terminal or pending).","content":{"application/json":{"schema":{"type":"object","required":["id","marketplace","status","items","createdAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["processing"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]}]},"items":{"type":"array","items":{"type":"object","required":["itemId","quantity"],"properties":{"itemId":{"type":"string"},"quantity":{"minimum":1,"type":"integer"},"variationId":{"type":"string"},"title":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"image":{"type":"string"}}}},"pricing":{"type":"object","properties":{"subtotal":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"tax":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"total":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"marketplaceOrderId":{"type":"string"},"receiptUrl":{"type":"string"},"failureReason":{"type":"string"},"createdAt":{"type":"string"},"completedAt":{"type":"string"},"nextAction":{"type":"object","required":["kind","url","instructions"],"properties":{"kind":{"type":"string"},"url":{"type":"string"},"instructions":{"type":"string"}}}}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Precondition failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream marketplace failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1Purchases","tags":["Purchases"],"parameters":[],"summary":"Buy an item (one-shot)","description":"Place a purchase. The response is either terminal (the order is fully placed; render the receipt) or non-terminal with `nextAction.url` (direct the user to that URL to complete the purchase on the marketplace UI, then poll `GET /v1/purchases/{id}`). Either way the response shape is identical.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","required":["itemId"],"properties":{"itemId":{"type":"string"},"quantity":{"minimum":1,"default":1,"type":"integer"},"variationId":{"type":"string"}}}},"marketplace":{"type":"string","enum":["ebay_us"]},"shipTo":{"type":"object","required":["line1","city","postalCode","country"],"properties":{"name":{"type":"string"},"line1":{"type":"string"},"line2":{"type":"string"},"city":{"type":"string"},"region":{"description":"State / province","type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"},"phone":{"type":"string"}}},"couponCode":{"type":"string"},"paymentInstruments":{"type":"array","items":{"type":"object","required":["paymentMethodType"],"properties":{"paymentMethodType":{"type":"string"},"paymentMethodBrand":{"type":"string"},"token":{"type":"string"}}}},"expectedPricing":{"type":"object","properties":{"subtotal":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"tax":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"total":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"guest":{"type":"boolean"}}}}}}},"get":{"responses":{"200":{"description":"Purchases page.","content":{"application/json":{"schema":{"type":"object","required":["limit","offset","purchases"],"properties":{"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"next":{"anyOf":[{"type":"string","nullable":true}]},"purchases":{"type":"array","items":{"type":"object","required":["id","marketplace","status","items","createdAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["processing"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]}]},"items":{"type":"array","items":{"type":"object","required":["itemId","quantity"],"properties":{"itemId":{"type":"string"},"quantity":{"minimum":1,"type":"integer"},"variationId":{"type":"string"},"title":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"image":{"type":"string"}}}},"pricing":{"type":"object","properties":{"subtotal":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"tax":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"total":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"marketplaceOrderId":{"type":"string"},"receiptUrl":{"type":"string"},"failureReason":{"type":"string"},"createdAt":{"type":"string"},"completedAt":{"type":"string"},"nextAction":{"type":"object","required":["kind","url","instructions"],"properties":{"kind":{"type":"string"},"url":{"type":"string"},"instructions":{"type":"string"}}}}}}}}}}},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Precondition failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream marketplace failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1Purchases","tags":["Purchases"],"parameters":[{"in":"query","name":"limit","required":false,"schema":{}},{"in":"query","name":"offset","required":false,"schema":{}},{"in":"query","name":"status","required":false,"schema":{}},{"in":"query","name":"marketplace","required":false,"schema":{}}],"summary":"List my purchases","description":"Newest first. Same Purchase shape as POST + GET single."}},"/v1/purchases/{id}":{"get":{"responses":{"200":{"description":"Purchase.","content":{"application/json":{"schema":{"type":"object","required":["id","marketplace","status","items","createdAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["processing"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]}]},"items":{"type":"array","items":{"type":"object","required":["itemId","quantity"],"properties":{"itemId":{"type":"string"},"quantity":{"minimum":1,"type":"integer"},"variationId":{"type":"string"},"title":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"image":{"type":"string"}}}},"pricing":{"type":"object","properties":{"subtotal":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"tax":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"total":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"marketplaceOrderId":{"type":"string"},"receiptUrl":{"type":"string"},"failureReason":{"type":"string"},"createdAt":{"type":"string"},"completedAt":{"type":"string"},"nextAction":{"type":"object","required":["kind","url","instructions"],"properties":{"kind":{"type":"string"},"url":{"type":"string"},"instructions":{"type":"string"}}}}}}}},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Purchase not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Precondition failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream marketplace failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1PurchasesById","tags":["Purchases"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Get a purchase"}},"/v1/purchases/{id}/shipping":{"patch":{"responses":{"200":{"description":"Updated purchase.","content":{"application/json":{"schema":{"type":"object","required":["id","marketplace","status","items","createdAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["processing"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]}]},"items":{"type":"array","items":{"type":"object","required":["itemId","quantity"],"properties":{"itemId":{"type":"string"},"quantity":{"minimum":1,"type":"integer"},"variationId":{"type":"string"},"title":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"image":{"type":"string"}}}},"pricing":{"type":"object","properties":{"subtotal":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"tax":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"total":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"marketplaceOrderId":{"type":"string"},"receiptUrl":{"type":"string"},"failureReason":{"type":"string"},"createdAt":{"type":"string"},"completedAt":{"type":"string"},"nextAction":{"type":"object","required":["kind","url","instructions"],"properties":{"kind":{"type":"string"},"url":{"type":"string"},"instructions":{"type":"string"}}}}}}}},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Precondition failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream marketplace failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"patchV1PurchasesByIdShipping","tags":["Purchases"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Update shipping address mid-checkout","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["shipTo"],"properties":{"shipTo":{"type":"object","required":["line1","city","postalCode","country"],"properties":{"name":{"type":"string"},"line1":{"type":"string"},"line2":{"type":"string"},"city":{"type":"string"},"region":{"description":"State / province","type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"},"phone":{"type":"string"}}}}}}}}}},"/v1/purchases/{id}/payment":{"patch":{"responses":{"200":{"description":"Updated purchase.","content":{"application/json":{"schema":{"type":"object","required":["id","marketplace","status","items","createdAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["processing"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]}]},"items":{"type":"array","items":{"type":"object","required":["itemId","quantity"],"properties":{"itemId":{"type":"string"},"quantity":{"minimum":1,"type":"integer"},"variationId":{"type":"string"},"title":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"image":{"type":"string"}}}},"pricing":{"type":"object","properties":{"subtotal":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"tax":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"total":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"marketplaceOrderId":{"type":"string"},"receiptUrl":{"type":"string"},"failureReason":{"type":"string"},"createdAt":{"type":"string"},"completedAt":{"type":"string"},"nextAction":{"type":"object","required":["kind","url","instructions"],"properties":{"kind":{"type":"string"},"url":{"type":"string"},"instructions":{"type":"string"}}}}}}}},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Precondition failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream marketplace failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"patchV1PurchasesByIdPayment","tags":["Purchases"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Update payment instrument mid-checkout","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["paymentInstruments"],"properties":{"paymentInstruments":{"type":"array","items":{"type":"object","required":["paymentMethodType"],"properties":{"paymentMethodType":{"type":"string"},"paymentMethodBrand":{"type":"string"},"token":{"type":"string"}}}}}}}}}}},"/v1/purchases/{id}/coupon":{"patch":{"responses":{"200":{"description":"Updated purchase.","content":{"application/json":{"schema":{"type":"object","required":["id","marketplace","status","items","createdAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["processing"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]}]},"items":{"type":"array","items":{"type":"object","required":["itemId","quantity"],"properties":{"itemId":{"type":"string"},"quantity":{"minimum":1,"type":"integer"},"variationId":{"type":"string"},"title":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"image":{"type":"string"}}}},"pricing":{"type":"object","properties":{"subtotal":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"tax":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"total":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"marketplaceOrderId":{"type":"string"},"receiptUrl":{"type":"string"},"failureReason":{"type":"string"},"createdAt":{"type":"string"},"completedAt":{"type":"string"},"nextAction":{"type":"object","required":["kind","url","instructions"],"properties":{"kind":{"type":"string"},"url":{"type":"string"},"instructions":{"type":"string"}}}}}}}},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Precondition failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream marketplace failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"patchV1PurchasesByIdCoupon","tags":["Purchases"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Apply or remove a coupon mid-checkout","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["couponCode"],"properties":{"couponCode":{"type":"string"}}}}}}},"delete":{"responses":{"200":{"description":"Updated purchase.","content":{"application/json":{"schema":{"type":"object","required":["id","marketplace","status","items","createdAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["processing"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]}]},"items":{"type":"array","items":{"type":"object","required":["itemId","quantity"],"properties":{"itemId":{"type":"string"},"quantity":{"minimum":1,"type":"integer"},"variationId":{"type":"string"},"title":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"image":{"type":"string"}}}},"pricing":{"type":"object","properties":{"subtotal":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"tax":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"total":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"marketplaceOrderId":{"type":"string"},"receiptUrl":{"type":"string"},"failureReason":{"type":"string"},"createdAt":{"type":"string"},"completedAt":{"type":"string"},"nextAction":{"type":"object","required":["kind","url","instructions"],"properties":{"kind":{"type":"string"},"url":{"type":"string"},"instructions":{"type":"string"}}}}}}}},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Precondition failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream marketplace failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1PurchasesByIdCoupon","tags":["Purchases"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Remove the applied coupon"}},"/v1/purchases/{id}/cancel":{"post":{"responses":{"200":{"description":"Purchase (now cancelled or terminal).","content":{"application/json":{"schema":{"type":"object","required":["id","marketplace","status","items","createdAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["processing"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]}]},"items":{"type":"array","items":{"type":"object","required":["itemId","quantity"],"properties":{"itemId":{"type":"string"},"quantity":{"minimum":1,"type":"integer"},"variationId":{"type":"string"},"title":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"image":{"type":"string"}}}},"pricing":{"type":"object","properties":{"subtotal":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"tax":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"total":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"marketplaceOrderId":{"type":"string"},"receiptUrl":{"type":"string"},"failureReason":{"type":"string"},"createdAt":{"type":"string"},"completedAt":{"type":"string"},"nextAction":{"type":"object","required":["kind","url","instructions"],"properties":{"kind":{"type":"string"},"url":{"type":"string"},"instructions":{"type":"string"}}}}}}}},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Purchase not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Precondition failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream marketplace failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1PurchasesByIdCancel","tags":["Purchases"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Cancel a non-terminal purchase","description":"Cancels orders that haven't been picked up yet (queued / pre-place processing). Once mid-place, cancel is a no-op and the order continues."}},"/v1/bids":{"get":{"responses":{"200":{"description":"Bids.","content":{"application/json":{"schema":{"type":"object","required":["bids"],"properties":{"bids":{"type":"array","items":{"type":"object","required":["id","marketplace","listingId","amount","status","placedAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"listingId":{"type":"string"},"amount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"maxBid":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"status":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["active"]},{"type":"string","enum":["outbid"]},{"type":"string","enum":["won"]},{"type":"string","enum":["lost"]},{"type":"string","enum":["cancelled"]}]},"bidder":{"type":"string"},"placedAt":{"type":"string"},"auctionEndsAt":{"type":"string"},"nextAction":{"type":"object","required":["kind","url","instructions"],"properties":{"kind":{"type":"string"},"url":{"type":"string"},"instructions":{"type":"string"}}}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1Bids","tags":["Bids"],"parameters":[],"summary":"List my active bids"},"post":{"responses":{"201":{"description":"Created.","content":{"application/json":{"schema":{"type":"object","required":["listingId","amount"],"properties":{"listingId":{"type":"string"},"amount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"maxBid":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream marketplace failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"504":{"description":"Bridge client did not respond in time.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1Bids","tags":["Bids"],"parameters":[],"summary":"Place a (proxy) bid on an auction","description":"Place a proxy bid. The response is either terminal (bid is on file with eBay) or non-terminal with `nextAction.url` (direct the user to that URL to click Place Bid on the marketplace UI, then poll `GET /v1/bids/{listingId}`). Either way the response shape is identical.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["listingId","amount"],"properties":{"listingId":{"type":"string"},"amount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"maxBid":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}}}}}}},"/v1/bids/{listingId}":{"get":{"responses":{"200":{"description":"Bid."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream marketplace failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"504":{"description":"Bridge client did not respond in time.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1BidsByListingId","tags":["Bids"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"listingId","required":true}],"summary":"Current bid status for one auction listing"}},"/v1/bids/{listingId}/cancel":{"post":{"responses":{"200":{"description":"Bid (now cancelled)."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"No in-flight bid for this listing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1BidsByListingIdCancel","tags":["Bids"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"listingId","required":true}],"summary":"Cancel an in-flight bid for this listing","description":"Cancels the most recent place-bid tracking row that's still queued / claimed / placing for this listing. Cannot retract a bid that already landed on eBay (eBay's retraction rules are narrow and require a manual ebay.com flow). Returns the cancelled Bid, or 404 if there's no in-flight job."}},"/v1/forwarder/{provider}/refresh":{"post":{"responses":{"200":{"description":"Job queued.","content":{"application/json":{"schema":{"type":"object","required":["jobId","status","expiresAt"],"properties":{"jobId":{"format":"uuid","type":"string"},"status":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["expired"]}]},"expiresAt":{"format":"date-time","type":"string"}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Unknown provider.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Forwarder session not active — sign in first.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1ForwarderByProviderRefresh","tags":["Forwarder"],"parameters":[{"in":"path","name":"provider","required":true,"schema":{}}],"summary":"Queue an inbox-refresh job for the named forwarder","description":"Bridge-driven: the user's flipagent Chrome extension reads their logged-in forwarder inbox and reports packages back. Returns immediately with `jobId`; poll `GET /v1/forwarder/{provider}/jobs/{jobId}` until terminal."}},"/v1/forwarder/{provider}/address":{"post":{"responses":{"200":{"description":"Job queued.","content":{"application/json":{"schema":{"type":"object","required":["jobId","status","expiresAt"],"properties":{"jobId":{"format":"uuid","type":"string"},"status":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["expired"]}]},"expiresAt":{"format":"date-time","type":"string"}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Unknown provider.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Forwarder session not active — sign in first.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1ForwarderByProviderAddress","tags":["Forwarder"],"parameters":[{"in":"path","name":"provider","required":true,"schema":{}}],"summary":"Queue a job to read the user's assigned suite + warehouse address","description":"Bridge-driven onboarding step: the extension navigates the forwarder's account / address page (logged-in session required) and reports back the assigned suite + warehouse address. Use the result to seed an eBay merchant location (POST /v1/locations) so listings have a valid US ship-from. Returns immediately with `jobId`; poll `GET /v1/forwarder/{provider}/jobs/{jobId}` until terminal, then read `address` off the response."}},"/v1/forwarder/{provider}/jobs/{jobId}":{"get":{"responses":{"200":{"description":"Job state.","content":{"application/json":{"schema":{"type":"object","required":["jobId","provider","status","failureReason","createdAt","updatedAt","expiresAt"],"properties":{"jobId":{"format":"uuid","type":"string"},"provider":{"type":"string","enum":["planetexpress"]},"status":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["expired"]}]},"packages":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"trackingNumber":{"type":"string"},"carrier":{"type":"string"},"description":{"type":"string"},"weightG":{"type":"integer"},"receivedAt":{"format":"date-time","type":"string"},"state":{"description":"provider-specific state — 'received', 'on_hand', 'shipped', etc.","type":"string"}}}},"photos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"format":"uri","type":"string"},"capturedAt":{"format":"date-time","type":"string"},"caption":{"type":"string"}}}},"shipment":{"type":"object","required":["shipmentId","carrier","tracking","costCents","labelUrl","shippedAt"],"properties":{"shipmentId":{"anyOf":[{"type":"string","nullable":true}]},"carrier":{"anyOf":[{"type":"string","nullable":true}]},"tracking":{"anyOf":[{"type":"string","nullable":true}]},"costCents":{"anyOf":[{"type":"integer","nullable":true}]},"labelUrl":{"anyOf":[{"format":"uri","type":"string","nullable":true}]},"shippedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}},"addresses":{"type":"array","items":{"type":"object","required":["label","isPrimary","name","line1","city","postalCode","country"],"properties":{"label":{"type":"string"},"isPrimary":{"type":"boolean"},"name":{"description":"Recipient name printed on labels (typically the user's account name + suite).","type":"string"},"line1":{"type":"string"},"line2":{"description":"Suite / unit number assigned to the user by the forwarder.","type":"string"},"city":{"type":"string"},"region":{"description":"ISO 3166-2 region; for US use 2-letter (e.g. NV). Optional because some non-US warehouses (e.g. UK) don't expose a state/region field.","type":"string"},"postalCode":{"type":"string"},"country":{"description":"ISO 3166-1 alpha-2 (e.g. US).","type":"string"},"phone":{"type":"string"}}}},"nextAction":{"type":"object","required":["kind","url","instructions"],"properties":{"kind":{"type":"string"},"url":{"type":"string"},"instructions":{"type":"string"}}},"failureReason":{"anyOf":[{"type":"string","nullable":true}]},"createdAt":{"format":"date-time","type":"string"},"updatedAt":{"format":"date-time","type":"string"},"expiresAt":{"format":"date-time","type":"string"}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Job not found for this api key + provider.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1ForwarderByProviderJobsByJobId","tags":["Forwarder"],"parameters":[{"in":"path","name":"provider","required":true,"schema":{}},{"in":"path","name":"jobId","required":true,"schema":{}}],"summary":"Read a forwarder job (status + payload)","description":"Polled by callers after queueing any forwarder action (refresh / photos / dispatch). The response carries one of `packages`, `photos`, or `shipment` depending on which task this job was created for. Non-terminal jobs return only status + timestamps."}},"/v1/forwarder/{provider}/packages/{packageId}/photos":{"post":{"responses":{"200":{"description":"Job queued.","content":{"application/json":{"schema":{"type":"object","required":["jobId","status","expiresAt"],"properties":{"jobId":{"format":"uuid","type":"string"},"status":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["expired"]}]},"expiresAt":{"format":"date-time","type":"string"}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Unknown provider.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1ForwarderByProviderPackagesByPackageIdPhotos","tags":["Forwarder"],"parameters":[{"in":"path","name":"provider","required":true,"schema":{}},{"in":"path","name":"packageId","required":true,"schema":{}}],"summary":"Queue a photo-fetch job for a forwarder package","description":"Bridge-driven: the extension opens the package detail page in the user's logged-in forwarder session, scrapes intake photos, and posts them back. Returns a `jobId` immediately; poll `GET /v1/forwarder/{provider}/jobs/{jobId}` until terminal, then read `photos` off the response."}},"/v1/forwarder/{provider}/inventory":{"get":{"responses":{"200":{"description":"Inventory rows.","content":{"application/json":{"schema":{"type":"object","required":["rows"],"properties":{"rows":{"type":"array","items":{"type":"object","required":["id","provider","packageId","sku","ebayOfferId","ebayInboundOrderId","status","photos","weightG","dimsCm","inboundTracking","outboundShipmentId","outboundCarrier","outboundTracking","outboundCostCents","outboundLabelUrl","shippedAt","createdAt","updatedAt"],"properties":{"id":{"format":"uuid","type":"string"},"provider":{"type":"string","enum":["planetexpress"]},"packageId":{"type":"string"},"sku":{"anyOf":[{"type":"string","nullable":true}]},"ebayOfferId":{"anyOf":[{"type":"string","nullable":true}]},"ebayInboundOrderId":{"anyOf":[{"type":"string","nullable":true}]},"status":{"anyOf":[{"type":"string","enum":["received"]},{"type":"string","enum":["photographed"]},{"type":"string","enum":["listed"]},{"type":"string","enum":["sold"]},{"type":"string","enum":["dispatched"]},{"type":"string","enum":["shipped"]}]},"photos":{"anyOf":[{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"format":"uri","type":"string"},"capturedAt":{"format":"date-time","type":"string"},"caption":{"type":"string"}}},"nullable":true}]},"weightG":{"anyOf":[{"type":"integer","nullable":true}]},"dimsCm":{"anyOf":[{"type":"object","properties":{"l":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"nullable":true}]},"inboundTracking":{"anyOf":[{"type":"string","nullable":true}]},"outboundShipmentId":{"anyOf":[{"type":"string","nullable":true}]},"outboundCarrier":{"anyOf":[{"type":"string","nullable":true}]},"outboundTracking":{"anyOf":[{"type":"string","nullable":true}]},"outboundCostCents":{"anyOf":[{"type":"integer","nullable":true}]},"outboundLabelUrl":{"anyOf":[{"type":"string","nullable":true}]},"shippedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"createdAt":{"format":"date-time","type":"string"},"updatedAt":{"format":"date-time","type":"string"}}}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Unknown provider.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1ForwarderByProviderInventory","tags":["Forwarder"],"parameters":[{"in":"path","name":"provider","required":true,"schema":{}}],"summary":"List forwarder inventory rows for this api key","description":"Returns every package the bridge has reconciled into the inventory table for this provider, newest first. Each row carries the per-package lifecycle state (received → photographed → listed → sold → dispatched → shipped) plus inbound + outbound shipment fields. The agent uses this to find a package's id by sku before queueing a dispatch."}},"/v1/forwarder/{provider}/inventory/{packageId}":{"get":{"responses":{"200":{"description":"Inventory row.","content":{"application/json":{"schema":{"type":"object","required":["id","provider","packageId","sku","ebayOfferId","ebayInboundOrderId","status","photos","weightG","dimsCm","inboundTracking","outboundShipmentId","outboundCarrier","outboundTracking","outboundCostCents","outboundLabelUrl","shippedAt","createdAt","updatedAt"],"properties":{"id":{"format":"uuid","type":"string"},"provider":{"type":"string","enum":["planetexpress"]},"packageId":{"type":"string"},"sku":{"anyOf":[{"type":"string","nullable":true}]},"ebayOfferId":{"anyOf":[{"type":"string","nullable":true}]},"ebayInboundOrderId":{"anyOf":[{"type":"string","nullable":true}]},"status":{"anyOf":[{"type":"string","enum":["received"]},{"type":"string","enum":["photographed"]},{"type":"string","enum":["listed"]},{"type":"string","enum":["sold"]},{"type":"string","enum":["dispatched"]},{"type":"string","enum":["shipped"]}]},"photos":{"anyOf":[{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"format":"uri","type":"string"},"capturedAt":{"format":"date-time","type":"string"},"caption":{"type":"string"}}},"nullable":true}]},"weightG":{"anyOf":[{"type":"integer","nullable":true}]},"dimsCm":{"anyOf":[{"type":"object","properties":{"l":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"nullable":true}]},"inboundTracking":{"anyOf":[{"type":"string","nullable":true}]},"outboundShipmentId":{"anyOf":[{"type":"string","nullable":true}]},"outboundCarrier":{"anyOf":[{"type":"string","nullable":true}]},"outboundTracking":{"anyOf":[{"type":"string","nullable":true}]},"outboundCostCents":{"anyOf":[{"type":"integer","nullable":true}]},"outboundLabelUrl":{"anyOf":[{"type":"string","nullable":true}]},"shippedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"createdAt":{"format":"date-time","type":"string"},"updatedAt":{"format":"date-time","type":"string"}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Package not found in this api key's inventory.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1ForwarderByProviderInventoryByPackageId","tags":["Forwarder"],"parameters":[{"in":"path","name":"provider","required":true,"schema":{}},{"in":"path","name":"packageId","required":true,"schema":{}}],"summary":"Read a single forwarder inventory row"}},"/v1/forwarder/{provider}/packages/{packageId}/link":{"post":{"responses":{"200":{"description":"Linked.","content":{"application/json":{"schema":{"type":"object","required":["id","provider","packageId","sku","ebayOfferId","ebayInboundOrderId","status","photos","weightG","dimsCm","inboundTracking","outboundShipmentId","outboundCarrier","outboundTracking","outboundCostCents","outboundLabelUrl","shippedAt","createdAt","updatedAt"],"properties":{"id":{"format":"uuid","type":"string"},"provider":{"type":"string","enum":["planetexpress"]},"packageId":{"type":"string"},"sku":{"anyOf":[{"type":"string","nullable":true}]},"ebayOfferId":{"anyOf":[{"type":"string","nullable":true}]},"ebayInboundOrderId":{"anyOf":[{"type":"string","nullable":true}]},"status":{"anyOf":[{"type":"string","enum":["received"]},{"type":"string","enum":["photographed"]},{"type":"string","enum":["listed"]},{"type":"string","enum":["sold"]},{"type":"string","enum":["dispatched"]},{"type":"string","enum":["shipped"]}]},"photos":{"anyOf":[{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"format":"uri","type":"string"},"capturedAt":{"format":"date-time","type":"string"},"caption":{"type":"string"}}},"nullable":true}]},"weightG":{"anyOf":[{"type":"integer","nullable":true}]},"dimsCm":{"anyOf":[{"type":"object","properties":{"l":{"type":"number"},"w":{"type":"number"},"h":{"type":"number"}},"nullable":true}]},"inboundTracking":{"anyOf":[{"type":"string","nullable":true}]},"outboundShipmentId":{"anyOf":[{"type":"string","nullable":true}]},"outboundCarrier":{"anyOf":[{"type":"string","nullable":true}]},"outboundTracking":{"anyOf":[{"type":"string","nullable":true}]},"outboundCostCents":{"anyOf":[{"type":"integer","nullable":true}]},"outboundLabelUrl":{"anyOf":[{"type":"string","nullable":true}]},"shippedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"createdAt":{"format":"date-time","type":"string"},"updatedAt":{"format":"date-time","type":"string"}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Unknown provider.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1ForwarderByProviderPackagesByPackageIdLink","tags":["Forwarder"],"parameters":[{"in":"path","name":"provider","required":true,"schema":{}},{"in":"path","name":"packageId","required":true,"schema":{}}],"summary":"Link a forwarder package to a marketplace sku + offer","description":"Called after `flipagent_relist_listing` succeeds. Stores `sku` (and optional `ebayOfferId`) on the inventory row so the sold-event handler can find the package without the agent threading the mapping by hand. Idempotent — re-linking the same sku is a no-op; re-linking a different sku overwrites.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["sku"],"properties":{"sku":{"minLength":1,"maxLength":200,"type":"string"},"ebayOfferId":{"maxLength":200,"type":"string"}}}}}}}},"/v1/forwarder/{provider}/packages/{packageId}/dispatch":{"post":{"responses":{"200":{"description":"Job queued.","content":{"application/json":{"schema":{"type":"object","required":["jobId","provider","status","failureReason","createdAt","updatedAt","expiresAt"],"properties":{"jobId":{"format":"uuid","type":"string"},"provider":{"type":"string","enum":["planetexpress"]},"status":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["running"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["expired"]}]},"packages":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"trackingNumber":{"type":"string"},"carrier":{"type":"string"},"description":{"type":"string"},"weightG":{"type":"integer"},"receivedAt":{"format":"date-time","type":"string"},"state":{"description":"provider-specific state — 'received', 'on_hand', 'shipped', etc.","type":"string"}}}},"photos":{"type":"array","items":{"type":"object","required":["url"],"properties":{"url":{"format":"uri","type":"string"},"capturedAt":{"format":"date-time","type":"string"},"caption":{"type":"string"}}}},"shipment":{"type":"object","required":["shipmentId","carrier","tracking","costCents","labelUrl","shippedAt"],"properties":{"shipmentId":{"anyOf":[{"type":"string","nullable":true}]},"carrier":{"anyOf":[{"type":"string","nullable":true}]},"tracking":{"anyOf":[{"type":"string","nullable":true}]},"costCents":{"anyOf":[{"type":"integer","nullable":true}]},"labelUrl":{"anyOf":[{"format":"uri","type":"string","nullable":true}]},"shippedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}},"addresses":{"type":"array","items":{"type":"object","required":["label","isPrimary","name","line1","city","postalCode","country"],"properties":{"label":{"type":"string"},"isPrimary":{"type":"boolean"},"name":{"description":"Recipient name printed on labels (typically the user's account name + suite).","type":"string"},"line1":{"type":"string"},"line2":{"description":"Suite / unit number assigned to the user by the forwarder.","type":"string"},"city":{"type":"string"},"region":{"description":"ISO 3166-2 region; for US use 2-letter (e.g. NV). Optional because some non-US warehouses (e.g. UK) don't expose a state/region field.","type":"string"},"postalCode":{"type":"string"},"country":{"description":"ISO 3166-1 alpha-2 (e.g. US).","type":"string"},"phone":{"type":"string"}}}},"nextAction":{"type":"object","required":["kind","url","instructions"],"properties":{"kind":{"type":"string"},"url":{"type":"string"},"instructions":{"type":"string"}}},"failureReason":{"anyOf":[{"type":"string","nullable":true}]},"createdAt":{"format":"date-time","type":"string"},"updatedAt":{"format":"date-time","type":"string"},"expiresAt":{"format":"date-time","type":"string"}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Unknown provider.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1ForwarderByProviderPackagesByPackageIdDispatch","tags":["Forwarder"],"parameters":[{"in":"path","name":"provider","required":true,"schema":{}},{"in":"path","name":"packageId","required":true,"schema":{}}],"summary":"Queue an outbound-shipment job for a forwarder package","description":"Sell-side ship-out. When the Chrome extension is paired, the bridge drives the forwarder's outbound flow with the supplied buyer address, picks the requested service tier, and reports back `shipment` (provider id + carrier + tracking + label url) once the label generates. When the extension isn't paired, the response carries `nextAction.url` pointing at the forwarder's outbound page so the user completes the dispatch manually; the tracking row is reconciled on the next inbox refresh. Idempotent on `(packageId, ebayOrderId)` so retried sold-event webhooks don't book two shipments.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["toAddress"],"properties":{"toAddress":{"type":"object","required":["name","line1","city","state","postalCode","country"],"properties":{"name":{"type":"string"},"line1":{"type":"string"},"line2":{"type":"string"},"city":{"type":"string"},"state":{"description":"ISO 3166-2 region; for US use 2-letter (e.g. NY)","type":"string"},"postalCode":{"type":"string"},"country":{"description":"ISO 3166-1 alpha-2 (e.g. US, KR)","type":"string"},"phone":{"type":"string"},"email":{"format":"email","type":"string"}}},"service":{"anyOf":[{"type":"string","enum":["usps_priority"]},{"type":"string","enum":["usps_ground_advantage"]},{"type":"string","enum":["ups_ground"]},{"type":"string","enum":["fedex_home"]}]},"declaredValueCents":{"minimum":0,"type":"integer"},"ebayOrderId":{"description":"Origin marketplace order id, for traceability.","type":"string"},"notes":{"type":"string"}}}}}}}},"/v1/listings/verify":{"post":{"responses":{"200":{"description":"Verification.","content":{"application/json":{"schema":{"type":"object","required":["passed"],"properties":{"passed":{"type":"boolean"},"fees":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"errors":{"type":"array","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}},"warnings":{"type":"array","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Trading API failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1ListingsVerify","tags":["Listings"],"parameters":[],"summary":"Dry-run a listing (VerifyAddItem) — returns fees + errors without publishing","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["title","price","categoryId","condition","images"],"properties":{"title":{"type":"string"},"description":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"quantity":{"minimum":1,"default":1,"type":"integer"},"categoryId":{"type":"string"},"condition":{"type":"string"},"images":{"minItems":1,"type":"array","items":{"type":"string"}},"aspects":{"type":"object","additionalProperties":true},"duration":{"description":"Days_30 | GTC | …","type":"string"}}}}}}}},"/v1/listings/draft":{"post":{"responses":{"200":{"description":"Draft.","content":{"application/json":{"schema":{"type":"object","required":["itemDraftId"],"properties":{"itemDraftId":{"type":"string"},"listingRedirectUrl":{"type":"string"}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1ListingsDraft","tags":["Listings"],"parameters":[],"summary":"Create a listing draft on eBay (seller finishes via redirect)","description":"Wraps Sell Listing v1_beta `item_draft`. Returns `itemDraftId` + `listingRedirectUrl` so the seller can review + publish on ebay.com. Useful for `give me a one-click pre-filled listing` agent flows.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["raw"],"properties":{"raw":{"description":"Pass-through to eBay's ItemDraft body shape. See sell/listing OAS for fields."},"marketplace":{"type":"string","enum":["ebay_us"]}}}}}}}},"/v1/listings":{"post":{"responses":{"201":{"description":"Listing created and live.","content":{"application/json":{"schema":{"type":"object","required":["id","sku","marketplace","status","title","price","quantity","condition","categoryId","images","format","createdAt"],"properties":{"id":{"type":"string"},"sku":{"type":"string"},"offerId":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["draft"]},{"type":"string","enum":["active"]},{"type":"string","enum":["ended"]},{"type":"string","enum":["withdrawn"]},{"type":"string","enum":["out_of_stock"]}]},"title":{"type":"string"},"description":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"quantity":{"minimum":0,"type":"integer"},"condition":{"anyOf":[{"type":"string","enum":["new"]},{"type":"string","enum":["like_new"]},{"type":"string","enum":["new_other"]},{"type":"string","enum":["new_with_defects"]},{"type":"string","enum":["manufacturer_refurbished"]},{"type":"string","enum":["certified_refurbished"]},{"type":"string","enum":["excellent_refurbished"]},{"type":"string","enum":["very_good_refurbished"]},{"type":"string","enum":["good_refurbished"]},{"type":"string","enum":["seller_refurbished"]},{"type":"string","enum":["used_excellent"]},{"type":"string","enum":["used_very_good"]},{"type":"string","enum":["used_good"]},{"type":"string","enum":["used_acceptable"]},{"type":"string","enum":["for_parts_or_not_working"]}]},"conditionDescription":{"type":"string"},"categoryId":{"type":"string"},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Multi-valued.","type":"object","additionalProperties":true},"images":{"type":"array","items":{"type":"string"}},"format":{"default":"fixed_price","anyOf":[{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["auction"]}]},"policies":{"type":"object","properties":{"fulfillmentPolicyId":{"type":"string"},"paymentPolicyId":{"type":"string"},"returnPolicyId":{"type":"string"}}},"merchantLocationKey":{"type":"string"},"package":{"type":"object","properties":{"weight":{"type":"object","required":["value","unit"],"properties":{"value":{"type":"number"},"unit":{"anyOf":[{"type":"string","enum":["pound"]},{"type":"string","enum":["ounce"]},{"type":"string","enum":["kilogram"]},{"type":"string","enum":["gram"]}]}}},"dimensions":{"type":"object","required":["length","width","height","unit"],"properties":{"length":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"unit":{"anyOf":[{"type":"string","enum":["inch"]},{"type":"string","enum":["feet"]},{"type":"string","enum":["centimeter"]},{"type":"string","enum":["meter"]}]}}},"packageType":{"type":"string"}}},"gtin":{"type":"string"},"upc":{"type":"array","items":{"type":"string"}},"ean":{"type":"array","items":{"type":"string"}},"isbn":{"type":"array","items":{"type":"string"}},"mpn":{"type":"string"},"brand":{"type":"string"},"epid":{"type":"string"},"lotSize":{"minimum":1,"type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"},"url":{"type":"string"},"createdAt":{"description":"ISO 8601 — first time the listing entered our system.","type":"string"},"updatedAt":{"type":"string"}}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Missing prerequisite — policies or merchant location not set.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1Listings","tags":["Listings"],"parameters":[],"summary":"Create a listing (one-shot publish)","description":"Compresses eBay's three-step Sell Inventory dance (PUT inventory_item → POST offer → POST publish) into one call. Returns the live `Listing` with `status='active'` on success. Required: `policies` (fulfillment/payment/return ids) + `merchantLocationKey`. Auto-discovery of those is a future enhancement.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["title","price","condition","categoryId","images"],"properties":{"title":{"maxLength":80,"type":"string"},"description":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"quantity":{"minimum":1,"default":1,"type":"integer"},"condition":{"anyOf":[{"type":"string","enum":["new"]},{"type":"string","enum":["like_new"]},{"type":"string","enum":["new_other"]},{"type":"string","enum":["new_with_defects"]},{"type":"string","enum":["manufacturer_refurbished"]},{"type":"string","enum":["certified_refurbished"]},{"type":"string","enum":["excellent_refurbished"]},{"type":"string","enum":["very_good_refurbished"]},{"type":"string","enum":["good_refurbished"]},{"type":"string","enum":["seller_refurbished"]},{"type":"string","enum":["used_excellent"]},{"type":"string","enum":["used_very_good"]},{"type":"string","enum":["used_good"]},{"type":"string","enum":["used_acceptable"]},{"type":"string","enum":["for_parts_or_not_working"]}]},"conditionDescription":{"type":"string"},"categoryId":{"type":"string"},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Multi-valued.","type":"object","additionalProperties":true},"images":{"minItems":1,"maxItems":24,"type":"array","items":{"type":"string"}},"format":{"default":"fixed_price","anyOf":[{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["auction"]}]},"marketplace":{"type":"string","enum":["ebay_us"]},"sku":{"type":"string"},"policies":{"type":"object","properties":{"fulfillmentPolicyId":{"type":"string"},"paymentPolicyId":{"type":"string"},"returnPolicyId":{"type":"string"}}},"merchantLocationKey":{"type":"string"},"package":{"type":"object","properties":{"weight":{"type":"object","required":["value","unit"],"properties":{"value":{"type":"number"},"unit":{"anyOf":[{"type":"string","enum":["pound"]},{"type":"string","enum":["ounce"]},{"type":"string","enum":["kilogram"]},{"type":"string","enum":["gram"]}]}}},"dimensions":{"type":"object","required":["length","width","height","unit"],"properties":{"length":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"unit":{"anyOf":[{"type":"string","enum":["inch"]},{"type":"string","enum":["feet"]},{"type":"string","enum":["centimeter"]},{"type":"string","enum":["meter"]}]}}},"packageType":{"type":"string"}}},"gtin":{"description":"Global trade id; eBay routes to upc/ean/isbn by length.","type":"string"},"upc":{"type":"array","items":{"type":"string"}},"ean":{"type":"array","items":{"type":"string"}},"isbn":{"type":"array","items":{"type":"string"}},"mpn":{"description":"Manufacturer part number.","type":"string"},"brand":{"type":"string"},"epid":{"description":"eBay catalog product id (links listing to canonical product).","type":"string"},"lotSize":{"minimum":1,"description":"Number of units in a lot listing.","type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"},"compatibility":{"type":"object","required":["compatibleProducts"],"properties":{"compatibleProducts":{"type":"array","items":{"type":"object","properties":{"productFamilyProperties":{"type":"object","properties":{"make":{"type":"string"},"model":{"type":"string"},"year":{"type":"string"},"trim":{"type":"string"},"engine":{"type":"string"}}},"productIdentifier":{"type":"object","properties":{"ePID":{"type":"string"},"gtin":{"type":"string"}}},"notes":{"type":"string"}}}}}},"pickupAtLocation":{"type":"array","items":{"type":"object","required":["merchantLocationKey","quantity"],"properties":{"merchantLocationKey":{"type":"string"},"quantity":{"minimum":0,"type":"integer"},"availabilityType":{"anyOf":[{"type":"string","enum":["IN_STOCK"]},{"type":"string","enum":["OUT_OF_STOCK"]},{"type":"string","enum":["SHIP_TO_STORE"]}]}}}}}}}}}},"get":{"responses":{"200":{"description":"Listings page.","content":{"application/json":{"schema":{"type":"object","required":["limit","offset","listings"],"properties":{"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"next":{"anyOf":[{"type":"string","nullable":true}]},"listings":{"type":"array","items":{"type":"object","required":["id","sku","marketplace","status","title","price","quantity","condition","categoryId","images","format","createdAt"],"properties":{"id":{"type":"string"},"sku":{"type":"string"},"offerId":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["draft"]},{"type":"string","enum":["active"]},{"type":"string","enum":["ended"]},{"type":"string","enum":["withdrawn"]},{"type":"string","enum":["out_of_stock"]}]},"title":{"type":"string"},"description":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"quantity":{"minimum":0,"type":"integer"},"condition":{"anyOf":[{"type":"string","enum":["new"]},{"type":"string","enum":["like_new"]},{"type":"string","enum":["new_other"]},{"type":"string","enum":["new_with_defects"]},{"type":"string","enum":["manufacturer_refurbished"]},{"type":"string","enum":["certified_refurbished"]},{"type":"string","enum":["excellent_refurbished"]},{"type":"string","enum":["very_good_refurbished"]},{"type":"string","enum":["good_refurbished"]},{"type":"string","enum":["seller_refurbished"]},{"type":"string","enum":["used_excellent"]},{"type":"string","enum":["used_very_good"]},{"type":"string","enum":["used_good"]},{"type":"string","enum":["used_acceptable"]},{"type":"string","enum":["for_parts_or_not_working"]}]},"conditionDescription":{"type":"string"},"categoryId":{"type":"string"},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Multi-valued.","type":"object","additionalProperties":true},"images":{"type":"array","items":{"type":"string"}},"format":{"default":"fixed_price","anyOf":[{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["auction"]}]},"policies":{"type":"object","properties":{"fulfillmentPolicyId":{"type":"string"},"paymentPolicyId":{"type":"string"},"returnPolicyId":{"type":"string"}}},"merchantLocationKey":{"type":"string"},"package":{"type":"object","properties":{"weight":{"type":"object","required":["value","unit"],"properties":{"value":{"type":"number"},"unit":{"anyOf":[{"type":"string","enum":["pound"]},{"type":"string","enum":["ounce"]},{"type":"string","enum":["kilogram"]},{"type":"string","enum":["gram"]}]}}},"dimensions":{"type":"object","required":["length","width","height","unit"],"properties":{"length":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"unit":{"anyOf":[{"type":"string","enum":["inch"]},{"type":"string","enum":["feet"]},{"type":"string","enum":["centimeter"]},{"type":"string","enum":["meter"]}]}}},"packageType":{"type":"string"}}},"gtin":{"type":"string"},"upc":{"type":"array","items":{"type":"string"}},"ean":{"type":"array","items":{"type":"string"}},"isbn":{"type":"array","items":{"type":"string"}},"mpn":{"type":"string"},"brand":{"type":"string"},"epid":{"type":"string"},"lotSize":{"minimum":1,"type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"},"url":{"type":"string"},"createdAt":{"description":"ISO 8601 — first time the listing entered our system.","type":"string"},"updatedAt":{"type":"string"}}}}}}}}},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Missing prerequisite — policies or merchant location not set.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1Listings","tags":["Listings"],"parameters":[{"in":"query","name":"limit","required":false,"schema":{}},{"in":"query","name":"offset","required":false,"schema":{}},{"in":"query","name":"status","required":false,"schema":{}},{"in":"query","name":"marketplace","required":false,"schema":{}}],"summary":"List my listings","description":"Paginated list of my inventory + offers, merged into the `Listing` shape."}},"/v1/listings/{sku}":{"get":{"responses":{"200":{"description":"Listing.","content":{"application/json":{"schema":{"type":"object","required":["id","sku","marketplace","status","title","price","quantity","condition","categoryId","images","format","createdAt"],"properties":{"id":{"type":"string"},"sku":{"type":"string"},"offerId":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["draft"]},{"type":"string","enum":["active"]},{"type":"string","enum":["ended"]},{"type":"string","enum":["withdrawn"]},{"type":"string","enum":["out_of_stock"]}]},"title":{"type":"string"},"description":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"quantity":{"minimum":0,"type":"integer"},"condition":{"anyOf":[{"type":"string","enum":["new"]},{"type":"string","enum":["like_new"]},{"type":"string","enum":["new_other"]},{"type":"string","enum":["new_with_defects"]},{"type":"string","enum":["manufacturer_refurbished"]},{"type":"string","enum":["certified_refurbished"]},{"type":"string","enum":["excellent_refurbished"]},{"type":"string","enum":["very_good_refurbished"]},{"type":"string","enum":["good_refurbished"]},{"type":"string","enum":["seller_refurbished"]},{"type":"string","enum":["used_excellent"]},{"type":"string","enum":["used_very_good"]},{"type":"string","enum":["used_good"]},{"type":"string","enum":["used_acceptable"]},{"type":"string","enum":["for_parts_or_not_working"]}]},"conditionDescription":{"type":"string"},"categoryId":{"type":"string"},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Multi-valued.","type":"object","additionalProperties":true},"images":{"type":"array","items":{"type":"string"}},"format":{"default":"fixed_price","anyOf":[{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["auction"]}]},"policies":{"type":"object","properties":{"fulfillmentPolicyId":{"type":"string"},"paymentPolicyId":{"type":"string"},"returnPolicyId":{"type":"string"}}},"merchantLocationKey":{"type":"string"},"package":{"type":"object","properties":{"weight":{"type":"object","required":["value","unit"],"properties":{"value":{"type":"number"},"unit":{"anyOf":[{"type":"string","enum":["pound"]},{"type":"string","enum":["ounce"]},{"type":"string","enum":["kilogram"]},{"type":"string","enum":["gram"]}]}}},"dimensions":{"type":"object","required":["length","width","height","unit"],"properties":{"length":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"unit":{"anyOf":[{"type":"string","enum":["inch"]},{"type":"string","enum":["feet"]},{"type":"string","enum":["centimeter"]},{"type":"string","enum":["meter"]}]}}},"packageType":{"type":"string"}}},"gtin":{"type":"string"},"upc":{"type":"array","items":{"type":"string"}},"ean":{"type":"array","items":{"type":"string"}},"isbn":{"type":"array","items":{"type":"string"}},"mpn":{"type":"string"},"brand":{"type":"string"},"epid":{"type":"string"},"lotSize":{"minimum":1,"type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"},"url":{"type":"string"},"createdAt":{"description":"ISO 8601 — first time the listing entered our system.","type":"string"},"updatedAt":{"type":"string"}}}}}},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Listing not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Missing prerequisite — policies or merchant location not set.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1ListingsBySku","tags":["Listings"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"sku","required":true}],"summary":"Get a listing by SKU"},"patch":{"responses":{"200":{"description":"Updated listing.","content":{"application/json":{"schema":{"type":"object","required":["id","sku","marketplace","status","title","price","quantity","condition","categoryId","images","format","createdAt"],"properties":{"id":{"type":"string"},"sku":{"type":"string"},"offerId":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["draft"]},{"type":"string","enum":["active"]},{"type":"string","enum":["ended"]},{"type":"string","enum":["withdrawn"]},{"type":"string","enum":["out_of_stock"]}]},"title":{"type":"string"},"description":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"quantity":{"minimum":0,"type":"integer"},"condition":{"anyOf":[{"type":"string","enum":["new"]},{"type":"string","enum":["like_new"]},{"type":"string","enum":["new_other"]},{"type":"string","enum":["new_with_defects"]},{"type":"string","enum":["manufacturer_refurbished"]},{"type":"string","enum":["certified_refurbished"]},{"type":"string","enum":["excellent_refurbished"]},{"type":"string","enum":["very_good_refurbished"]},{"type":"string","enum":["good_refurbished"]},{"type":"string","enum":["seller_refurbished"]},{"type":"string","enum":["used_excellent"]},{"type":"string","enum":["used_very_good"]},{"type":"string","enum":["used_good"]},{"type":"string","enum":["used_acceptable"]},{"type":"string","enum":["for_parts_or_not_working"]}]},"conditionDescription":{"type":"string"},"categoryId":{"type":"string"},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Multi-valued.","type":"object","additionalProperties":true},"images":{"type":"array","items":{"type":"string"}},"format":{"default":"fixed_price","anyOf":[{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["auction"]}]},"policies":{"type":"object","properties":{"fulfillmentPolicyId":{"type":"string"},"paymentPolicyId":{"type":"string"},"returnPolicyId":{"type":"string"}}},"merchantLocationKey":{"type":"string"},"package":{"type":"object","properties":{"weight":{"type":"object","required":["value","unit"],"properties":{"value":{"type":"number"},"unit":{"anyOf":[{"type":"string","enum":["pound"]},{"type":"string","enum":["ounce"]},{"type":"string","enum":["kilogram"]},{"type":"string","enum":["gram"]}]}}},"dimensions":{"type":"object","required":["length","width","height","unit"],"properties":{"length":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"unit":{"anyOf":[{"type":"string","enum":["inch"]},{"type":"string","enum":["feet"]},{"type":"string","enum":["centimeter"]},{"type":"string","enum":["meter"]}]}}},"packageType":{"type":"string"}}},"gtin":{"type":"string"},"upc":{"type":"array","items":{"type":"string"}},"ean":{"type":"array","items":{"type":"string"}},"isbn":{"type":"array","items":{"type":"string"}},"mpn":{"type":"string"},"brand":{"type":"string"},"epid":{"type":"string"},"lotSize":{"minimum":1,"type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"},"url":{"type":"string"},"createdAt":{"description":"ISO 8601 — first time the listing entered our system.","type":"string"},"updatedAt":{"type":"string"}}}}}},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Listing not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Missing prerequisite — policies or merchant location not set.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"patchV1ListingsBySku","tags":["Listings"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"sku","required":true}],"summary":"Update a listing","description":"Patch price, quantity, aspects, images, etc. Title is a full replace per eBay semantics.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"maxLength":80,"type":"string"},"description":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"quantity":{"minimum":0,"type":"integer"},"conditionDescription":{"type":"string"},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Multi-valued.","type":"object","additionalProperties":true},"images":{"minItems":1,"maxItems":24,"type":"array","items":{"type":"string"}},"policies":{"type":"object","properties":{"fulfillmentPolicyId":{"type":"string"},"paymentPolicyId":{"type":"string"},"returnPolicyId":{"type":"string"}}},"package":{"type":"object","properties":{"weight":{"type":"object","required":["value","unit"],"properties":{"value":{"type":"number"},"unit":{"anyOf":[{"type":"string","enum":["pound"]},{"type":"string","enum":["ounce"]},{"type":"string","enum":["kilogram"]},{"type":"string","enum":["gram"]}]}}},"dimensions":{"type":"object","required":["length","width","height","unit"],"properties":{"length":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"unit":{"anyOf":[{"type":"string","enum":["inch"]},{"type":"string","enum":["feet"]},{"type":"string","enum":["centimeter"]},{"type":"string","enum":["meter"]}]}}},"packageType":{"type":"string"}}}}}}}}},"delete":{"responses":{"200":{"description":"Listing ended.","content":{"application/json":{"schema":{"type":"object","required":["id","sku","marketplace","status","title","price","quantity","condition","categoryId","images","format","createdAt"],"properties":{"id":{"type":"string"},"sku":{"type":"string"},"offerId":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["draft"]},{"type":"string","enum":["active"]},{"type":"string","enum":["ended"]},{"type":"string","enum":["withdrawn"]},{"type":"string","enum":["out_of_stock"]}]},"title":{"type":"string"},"description":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"quantity":{"minimum":0,"type":"integer"},"condition":{"anyOf":[{"type":"string","enum":["new"]},{"type":"string","enum":["like_new"]},{"type":"string","enum":["new_other"]},{"type":"string","enum":["new_with_defects"]},{"type":"string","enum":["manufacturer_refurbished"]},{"type":"string","enum":["certified_refurbished"]},{"type":"string","enum":["excellent_refurbished"]},{"type":"string","enum":["very_good_refurbished"]},{"type":"string","enum":["good_refurbished"]},{"type":"string","enum":["seller_refurbished"]},{"type":"string","enum":["used_excellent"]},{"type":"string","enum":["used_very_good"]},{"type":"string","enum":["used_good"]},{"type":"string","enum":["used_acceptable"]},{"type":"string","enum":["for_parts_or_not_working"]}]},"conditionDescription":{"type":"string"},"categoryId":{"type":"string"},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Multi-valued.","type":"object","additionalProperties":true},"images":{"type":"array","items":{"type":"string"}},"format":{"default":"fixed_price","anyOf":[{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["auction"]}]},"policies":{"type":"object","properties":{"fulfillmentPolicyId":{"type":"string"},"paymentPolicyId":{"type":"string"},"returnPolicyId":{"type":"string"}}},"merchantLocationKey":{"type":"string"},"package":{"type":"object","properties":{"weight":{"type":"object","required":["value","unit"],"properties":{"value":{"type":"number"},"unit":{"anyOf":[{"type":"string","enum":["pound"]},{"type":"string","enum":["ounce"]},{"type":"string","enum":["kilogram"]},{"type":"string","enum":["gram"]}]}}},"dimensions":{"type":"object","required":["length","width","height","unit"],"properties":{"length":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"unit":{"anyOf":[{"type":"string","enum":["inch"]},{"type":"string","enum":["feet"]},{"type":"string","enum":["centimeter"]},{"type":"string","enum":["meter"]}]}}},"packageType":{"type":"string"}}},"gtin":{"type":"string"},"upc":{"type":"array","items":{"type":"string"}},"ean":{"type":"array","items":{"type":"string"}},"isbn":{"type":"array","items":{"type":"string"}},"mpn":{"type":"string"},"brand":{"type":"string"},"epid":{"type":"string"},"lotSize":{"minimum":1,"type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"},"url":{"type":"string"},"createdAt":{"description":"ISO 8601 — first time the listing entered our system.","type":"string"},"updatedAt":{"type":"string"}}}}}},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Listing not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Missing prerequisite — policies or merchant location not set.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1ListingsBySku","tags":["Listings"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"sku","required":true}],"summary":"End a listing","description":"Withdraws the offer (if active) and deletes the inventory item."}},"/v1/listings/groups/{groupKey}/publish":{"post":{"responses":{"200":{"description":"Published.","content":{"application/json":{"schema":{"type":"object","required":["listingId","warnings"],"properties":{"listingId":{"anyOf":[{"type":"string","nullable":true}]},"warnings":{"type":"array","items":{"type":"object","required":["message"],"properties":{"message":{"type":"string"},"errorId":{"type":"integer"}}}}}}}}},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Missing prerequisite — policies or merchant location not set.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1ListingsGroupsByGroupKeyPublish","tags":["Listings"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"groupKey","required":true}],"summary":"Publish all variant offers under an inventory_item_group","description":"Wraps Sell Inventory `POST /offer/publish_by_inventory_item_group`. Publishes every offer attached to the named group on the named marketplace in one call — useful for multi-variation listings (size/color matrices) where individually-publishing each variant would race.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["inventoryItemGroupKey","marketplaceId"],"properties":{"inventoryItemGroupKey":{"type":"string"},"marketplaceId":{"description":"EBAY_US, EBAY_DE, etc.","type":"string"}}}}}}}},"/v1/listings/groups/{groupKey}/withdraw":{"post":{"responses":{"200":{"description":"Withdrawn."},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Missing prerequisite — policies or merchant location not set.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1ListingsGroupsByGroupKeyWithdraw","tags":["Listings"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"groupKey","required":true}],"summary":"Withdraw all variant offers under an inventory_item_group","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["inventoryItemGroupKey","marketplaceId"],"properties":{"inventoryItemGroupKey":{"type":"string"},"marketplaceId":{"description":"EBAY_US, EBAY_DE, etc.","type":"string"}}}}}}}},"/v1/listings/{sku}/compatibility":{"get":{"responses":{"200":{"description":"Compatibility list.","content":{"application/json":{"schema":{"type":"object","required":["compatibleProducts"],"properties":{"compatibleProducts":{"type":"array","items":{"type":"object","required":["properties"],"properties":{"productFamilyProperties":{"type":"object","additionalProperties":true},"properties":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}}}},"notes":{"type":"string"}}}}}}}}},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"No compatibility set.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Missing prerequisite — policies or merchant location not set.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1ListingsBySkuCompatibility","tags":["Listings"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"sku","required":true}],"summary":"Get product compatibility (parts/motors fitment)"},"put":{"responses":{"200":{"description":"Set."},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Missing prerequisite — policies or merchant location not set.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"putV1ListingsBySkuCompatibility","tags":["Listings"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"sku","required":true}],"summary":"Set product compatibility (parts/motors fitment list)","description":"Replaces the compatibility set for one inventory item. Each row lists property/value pairs (Year, Make, Model, ...) that describe one compatible product. Used by parts sellers — without compatibility, eBay's parts-finder can't surface the listing.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["compatibleProducts"],"properties":{"compatibleProducts":{"type":"array","items":{"type":"object","required":["properties"],"properties":{"productFamilyProperties":{"type":"object","additionalProperties":true},"properties":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"}}}},"notes":{"type":"string"}}}}}}}}}},"delete":{"responses":{"204":{"description":"Deleted."},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Missing prerequisite — policies or merchant location not set.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1ListingsBySkuCompatibility","tags":["Listings"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"sku","required":true}],"summary":"Delete the product-compatibility set"}},"/v1/listings/{listingId}/skus/{sku}/locations":{"get":{"responses":{"200":{"description":"Locations.","content":{"application/json":{"schema":{"type":"object","required":["locations"],"properties":{"locations":{"type":"array","items":{"type":"object","required":["merchantLocationKey"],"properties":{"merchantLocationKey":{"type":"string"},"availability":{"type":"object","required":["quantity"],"properties":{"quantity":{"minimum":0,"type":"integer"},"allocationByFormat":{"type":"object","properties":{"auction":{"minimum":0,"type":"integer"},"fixedPrice":{"minimum":0,"type":"integer"}}}}}}}}}}}}},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"No locations mapped.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Missing prerequisite — policies or merchant location not set.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1ListingsByListingIdSkusBySkuLocations","tags":["Listings"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"listingId","required":true},{"schema":{"type":"string"},"in":"path","name":"sku","required":true}],"summary":"Get fulfillment-center mappings for one SKU within a listing"},"put":{"responses":{"200":{"description":"Mappings set."},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Missing prerequisite — policies or merchant location not set.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"putV1ListingsByListingIdSkusBySkuLocations","tags":["Listings"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"listingId","required":true},{"schema":{"type":"string"},"in":"path","name":"sku","required":true}],"summary":"Map fulfillment-center locations + per-location stock to one SKU","description":"Replaces the SKU's location set. Each entry pins a `merchantLocationKey` + per-location `quantity`. Used by sellers with multi-warehouse fulfillment so eBay calculates EDD per buyer location. Cap: first 50 locations are considered for EDD math.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["locations"],"properties":{"locations":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","required":["merchantLocationKey"],"properties":{"merchantLocationKey":{"type":"string"},"availability":{"type":"object","required":["quantity"],"properties":{"quantity":{"minimum":0,"type":"integer"},"allocationByFormat":{"type":"object","properties":{"auction":{"minimum":0,"type":"integer"},"fixedPrice":{"minimum":0,"type":"integer"}}}}}}}}}}}}}},"delete":{"responses":{"204":{"description":"Cleared."},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Missing prerequisite — policies or merchant location not set.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1ListingsByListingIdSkusBySkuLocations","tags":["Listings"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"listingId","required":true},{"schema":{"type":"string"},"in":"path","name":"sku","required":true}],"summary":"Clear all SKU→location mappings"}},"/v1/listings/preview-fees":{"post":{"responses":{"200":{"description":"Fees grouped by marketplace.","content":{"application/json":{"schema":{"type":"object","required":["summaries"],"properties":{"summaries":{"type":"array","items":{"type":"object","required":["marketplaceId","fees","totalCents"],"properties":{"marketplaceId":{"type":"string"},"fees":{"type":"array","items":{"type":"object","required":["feeType","amount"],"properties":{"feeType":{"description":"eBay fee category — InsertionFee, FinalValueFee, etc.","type":"string"},"amount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"promotionalDiscount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}}},"totalCents":{"minimum":0,"description":"Sum of fee amounts (after promotional discounts).","type":"integer"},"warnings":{"type":"array","items":{"type":"object","required":["message"],"properties":{"message":{"type":"string"},"errorId":{"type":"integer"}}}}}}}}}}}},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Missing prerequisite — policies or merchant location not set.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1ListingsPreview-fees","tags":["Listings"],"parameters":[],"summary":"Preview eBay fees for unpublished offer drafts","description":"Wraps Sell Inventory `POST /offer/get_listing_fees`. Pass an array of UNPUBLISHED `offerId` values (errors with 25754 on published offers). Returns fees grouped by marketplace — eBay does not break out fees per offer. For 'estimate fees on a hypothetical listing I haven't drafted yet', use POST /v1/listings/verify instead.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["offerIds"],"properties":{"offerIds":{"minItems":1,"maxItems":250,"type":"array","items":{"type":"string"}}}}}}}}},"/v1/listings/{sku}/relist":{"post":{"responses":{"200":{"description":"Listing relisted.","content":{"application/json":{"schema":{"type":"object","required":["id","sku","marketplace","status","title","price","quantity","condition","categoryId","images","format","createdAt"],"properties":{"id":{"type":"string"},"sku":{"type":"string"},"offerId":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["draft"]},{"type":"string","enum":["active"]},{"type":"string","enum":["ended"]},{"type":"string","enum":["withdrawn"]},{"type":"string","enum":["out_of_stock"]}]},"title":{"type":"string"},"description":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"quantity":{"minimum":0,"type":"integer"},"condition":{"anyOf":[{"type":"string","enum":["new"]},{"type":"string","enum":["like_new"]},{"type":"string","enum":["new_other"]},{"type":"string","enum":["new_with_defects"]},{"type":"string","enum":["manufacturer_refurbished"]},{"type":"string","enum":["certified_refurbished"]},{"type":"string","enum":["excellent_refurbished"]},{"type":"string","enum":["very_good_refurbished"]},{"type":"string","enum":["good_refurbished"]},{"type":"string","enum":["seller_refurbished"]},{"type":"string","enum":["used_excellent"]},{"type":"string","enum":["used_very_good"]},{"type":"string","enum":["used_good"]},{"type":"string","enum":["used_acceptable"]},{"type":"string","enum":["for_parts_or_not_working"]}]},"conditionDescription":{"type":"string"},"categoryId":{"type":"string"},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Multi-valued.","type":"object","additionalProperties":true},"images":{"type":"array","items":{"type":"string"}},"format":{"default":"fixed_price","anyOf":[{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["auction"]}]},"policies":{"type":"object","properties":{"fulfillmentPolicyId":{"type":"string"},"paymentPolicyId":{"type":"string"},"returnPolicyId":{"type":"string"}}},"merchantLocationKey":{"type":"string"},"package":{"type":"object","properties":{"weight":{"type":"object","required":["value","unit"],"properties":{"value":{"type":"number"},"unit":{"anyOf":[{"type":"string","enum":["pound"]},{"type":"string","enum":["ounce"]},{"type":"string","enum":["kilogram"]},{"type":"string","enum":["gram"]}]}}},"dimensions":{"type":"object","required":["length","width","height","unit"],"properties":{"length":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"unit":{"anyOf":[{"type":"string","enum":["inch"]},{"type":"string","enum":["feet"]},{"type":"string","enum":["centimeter"]},{"type":"string","enum":["meter"]}]}}},"packageType":{"type":"string"}}},"gtin":{"type":"string"},"upc":{"type":"array","items":{"type":"string"}},"ean":{"type":"array","items":{"type":"string"}},"isbn":{"type":"array","items":{"type":"string"}},"mpn":{"type":"string"},"brand":{"type":"string"},"epid":{"type":"string"},"lotSize":{"minimum":1,"type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"},"url":{"type":"string"},"createdAt":{"description":"ISO 8601 — first time the listing entered our system.","type":"string"},"updatedAt":{"type":"string"}}}}}},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Listing not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"412":{"description":"Missing prerequisite — policies or merchant location not set.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1ListingsBySkuRelist","tags":["Listings"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"sku","required":true}],"summary":"Re-publish a draft / withdrawn listing","description":"Re-runs the eBay publish step against the existing offer. Used to recover after a publish-step failure."}},"/v1/locations":{"get":{"responses":{"200":{"description":"Locations.","content":{"application/json":{"schema":{"type":"object","required":["locations"],"properties":{"locations":{"type":"array","items":{"type":"object","required":["id","address","status"],"properties":{"id":{"description":"merchantLocationKey.","type":"string"},"name":{"type":"string"},"phone":{"type":"string"},"address":{"type":"object","required":["line1","city","postalCode","country"],"properties":{"name":{"type":"string"},"line1":{"type":"string"},"line2":{"type":"string"},"city":{"type":"string"},"region":{"description":"State / province","type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"},"phone":{"type":"string"}}},"locationTypes":{"type":"array","items":{"description":"STORE | WAREHOUSE | …","type":"string"}},"status":{"anyOf":[{"type":"string","enum":["enabled"]},{"type":"string","enum":["disabled"]}]},"hours":{"type":"array","items":{"type":"object","required":["dayOfWeekEnum","intervals"],"properties":{"dayOfWeekEnum":{"type":"string"},"intervals":{"type":"array","items":{"type":"object","required":["open","close"],"properties":{"open":{"type":"string"},"close":{"type":"string"}}}}}}},"specialHours":{"type":"array","items":{"type":"object","required":["date","intervals"],"properties":{"date":{"type":"string"},"intervals":{"type":"array","items":{"type":"object","required":["open","close"],"properties":{"open":{"type":"string"},"close":{"type":"string"}}}}}}},"instructions":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1Locations","tags":["Locations"],"parameters":[],"summary":"List merchant locations"}},"/v1/locations/{id}":{"get":{"responses":{"200":{"description":"Location.","content":{"application/json":{"schema":{"type":"object","required":["id","address","status"],"properties":{"id":{"description":"merchantLocationKey.","type":"string"},"name":{"type":"string"},"phone":{"type":"string"},"address":{"type":"object","required":["line1","city","postalCode","country"],"properties":{"name":{"type":"string"},"line1":{"type":"string"},"line2":{"type":"string"},"city":{"type":"string"},"region":{"description":"State / province","type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"},"phone":{"type":"string"}}},"locationTypes":{"type":"array","items":{"description":"STORE | WAREHOUSE | …","type":"string"}},"status":{"anyOf":[{"type":"string","enum":["enabled"]},{"type":"string","enum":["disabled"]}]},"hours":{"type":"array","items":{"type":"object","required":["dayOfWeekEnum","intervals"],"properties":{"dayOfWeekEnum":{"type":"string"},"intervals":{"type":"array","items":{"type":"object","required":["open","close"],"properties":{"open":{"type":"string"},"close":{"type":"string"}}}}}}},"specialHours":{"type":"array","items":{"type":"object","required":["date","intervals"],"properties":{"date":{"type":"string"},"intervals":{"type":"array","items":{"type":"object","required":["open","close"],"properties":{"open":{"type":"string"},"close":{"type":"string"}}}}}}},"instructions":{"type":"string"}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1LocationsById","tags":["Locations"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Get a merchant location"},"put":{"responses":{"201":{"description":"Created.","content":{"application/json":{"schema":{"type":"object","required":["id","address","status"],"properties":{"id":{"description":"merchantLocationKey.","type":"string"},"name":{"type":"string"},"phone":{"type":"string"},"address":{"type":"object","required":["line1","city","postalCode","country"],"properties":{"name":{"type":"string"},"line1":{"type":"string"},"line2":{"type":"string"},"city":{"type":"string"},"region":{"description":"State / province","type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"},"phone":{"type":"string"}}},"locationTypes":{"type":"array","items":{"description":"STORE | WAREHOUSE | …","type":"string"}},"status":{"anyOf":[{"type":"string","enum":["enabled"]},{"type":"string","enum":["disabled"]}]},"hours":{"type":"array","items":{"type":"object","required":["dayOfWeekEnum","intervals"],"properties":{"dayOfWeekEnum":{"type":"string"},"intervals":{"type":"array","items":{"type":"object","required":["open","close"],"properties":{"open":{"type":"string"},"close":{"type":"string"}}}}}}},"specialHours":{"type":"array","items":{"type":"object","required":["date","intervals"],"properties":{"date":{"type":"string"},"intervals":{"type":"array","items":{"type":"object","required":["open","close"],"properties":{"open":{"type":"string"},"close":{"type":"string"}}}}}}},"instructions":{"type":"string"}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"putV1LocationsById","tags":["Locations"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Create or replace a merchant location","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["address"],"properties":{"name":{"type":"string"},"phone":{"type":"string"},"address":{"type":"object","required":["line1","city","postalCode","country"],"properties":{"name":{"type":"string"},"line1":{"type":"string"},"line2":{"type":"string"},"city":{"type":"string"},"region":{"description":"State / province","type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"},"phone":{"type":"string"}}},"locationTypes":{"type":"array","items":{"type":"string"}},"instructions":{"type":"string"}}}}}}},"delete":{"responses":{"204":{"description":"Deleted."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1LocationsById","tags":["Locations"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Delete a merchant location"},"patch":{"responses":{"200":{"description":"Updated.","content":{"application/json":{"schema":{"type":"object","required":["id","address","status"],"properties":{"id":{"description":"merchantLocationKey.","type":"string"},"name":{"type":"string"},"phone":{"type":"string"},"address":{"type":"object","required":["line1","city","postalCode","country"],"properties":{"name":{"type":"string"},"line1":{"type":"string"},"line2":{"type":"string"},"city":{"type":"string"},"region":{"description":"State / province","type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"},"phone":{"type":"string"}}},"locationTypes":{"type":"array","items":{"description":"STORE | WAREHOUSE | …","type":"string"}},"status":{"anyOf":[{"type":"string","enum":["enabled"]},{"type":"string","enum":["disabled"]}]},"hours":{"type":"array","items":{"type":"object","required":["dayOfWeekEnum","intervals"],"properties":{"dayOfWeekEnum":{"type":"string"},"intervals":{"type":"array","items":{"type":"object","required":["open","close"],"properties":{"open":{"type":"string"},"close":{"type":"string"}}}}}}},"specialHours":{"type":"array","items":{"type":"object","required":["date","intervals"],"properties":{"date":{"type":"string"},"intervals":{"type":"array","items":{"type":"object","required":["open","close"],"properties":{"open":{"type":"string"},"close":{"type":"string"}}}}}}},"instructions":{"type":"string"}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"patchV1LocationsById","tags":["Locations"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Patch one or more fields on a location","description":"Wraps `POST /sell/inventory/v1/location/{id}/update_location_details`. Unlike `PUT /v1/locations/{id}` (which fully replaces), this only updates the supplied fields. Useful for moving a warehouse without re-entering operating hours."}},"/v1/locations/{id}/enable":{"post":{"responses":{"200":{"description":"Updated.","content":{"application/json":{"schema":{"type":"object","required":["id","address","status"],"properties":{"id":{"description":"merchantLocationKey.","type":"string"},"name":{"type":"string"},"phone":{"type":"string"},"address":{"type":"object","required":["line1","city","postalCode","country"],"properties":{"name":{"type":"string"},"line1":{"type":"string"},"line2":{"type":"string"},"city":{"type":"string"},"region":{"description":"State / province","type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"},"phone":{"type":"string"}}},"locationTypes":{"type":"array","items":{"description":"STORE | WAREHOUSE | …","type":"string"}},"status":{"anyOf":[{"type":"string","enum":["enabled"]},{"type":"string","enum":["disabled"]}]},"hours":{"type":"array","items":{"type":"object","required":["dayOfWeekEnum","intervals"],"properties":{"dayOfWeekEnum":{"type":"string"},"intervals":{"type":"array","items":{"type":"object","required":["open","close"],"properties":{"open":{"type":"string"},"close":{"type":"string"}}}}}}},"specialHours":{"type":"array","items":{"type":"object","required":["date","intervals"],"properties":{"date":{"type":"string"},"intervals":{"type":"array","items":{"type":"object","required":["open","close"],"properties":{"open":{"type":"string"},"close":{"type":"string"}}}}}}},"instructions":{"type":"string"}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1LocationsByIdEnable","tags":["Locations"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Enable a location"}},"/v1/locations/{id}/disable":{"post":{"responses":{"200":{"description":"Updated.","content":{"application/json":{"schema":{"type":"object","required":["id","address","status"],"properties":{"id":{"description":"merchantLocationKey.","type":"string"},"name":{"type":"string"},"phone":{"type":"string"},"address":{"type":"object","required":["line1","city","postalCode","country"],"properties":{"name":{"type":"string"},"line1":{"type":"string"},"line2":{"type":"string"},"city":{"type":"string"},"region":{"description":"State / province","type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"},"phone":{"type":"string"}}},"locationTypes":{"type":"array","items":{"description":"STORE | WAREHOUSE | …","type":"string"}},"status":{"anyOf":[{"type":"string","enum":["enabled"]},{"type":"string","enum":["disabled"]}]},"hours":{"type":"array","items":{"type":"object","required":["dayOfWeekEnum","intervals"],"properties":{"dayOfWeekEnum":{"type":"string"},"intervals":{"type":"array","items":{"type":"object","required":["open","close"],"properties":{"open":{"type":"string"},"close":{"type":"string"}}}}}}},"specialHours":{"type":"array","items":{"type":"object","required":["date","intervals"],"properties":{"date":{"type":"string"},"intervals":{"type":"array","items":{"type":"object","required":["open","close"],"properties":{"open":{"type":"string"},"close":{"type":"string"}}}}}}},"instructions":{"type":"string"}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1LocationsByIdDisable","tags":["Locations"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Disable a location"}},"/v1/policies":{"get":{"responses":{"200":{"description":"Policies.","content":{"application/json":{"schema":{"type":"object","required":["limit","offset","policies"],"properties":{"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"next":{"anyOf":[{"type":"string","nullable":true}]},"policies":{"type":"array","items":{"type":"object","required":["id","type","marketplace","name"],"properties":{"id":{"type":"string"},"type":{"anyOf":[{"type":"string","enum":["return"]},{"type":"string","enum":["payment"]},{"type":"string","enum":["fulfillment"]}]},"marketplace":{"type":"string","enum":["ebay_us"]},"name":{"type":"string"},"description":{"type":"string"},"default":{"type":"boolean"},"returnsAccepted":{"type":"boolean"},"returnPeriodDays":{"minimum":0,"type":"integer"},"refundMethod":{"type":"string"},"returnShippingCostPayer":{"anyOf":[{"type":"string","enum":["buyer"]},{"type":"string","enum":["seller"]}]},"paymentMethods":{"type":"array","items":{"type":"string"}},"immediatePay":{"type":"boolean"},"handlingTimeDays":{"minimum":0,"type":"integer"},"shippingOptions":{"type":"array","items":{"type":"object","required":["service"],"properties":{"service":{"type":"string"},"cost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"additional":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}}},"freightShipping":{"type":"boolean"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1Policies","tags":["Policies"],"parameters":[],"summary":"List all policies (return + payment + fulfillment)"},"post":{"responses":{"201":{"description":"Created.","content":{"application/json":{"schema":{"type":"object","required":["type","name"],"properties":{"type":{"anyOf":[{"type":"string","enum":["return"]},{"type":"string","enum":["payment"]},{"type":"string","enum":["fulfillment"]}]},"name":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"description":{"type":"string"},"categoryType":{"anyOf":[{"type":"string","enum":["ALL_EXCLUDING_MOTORS_VEHICLES"]},{"type":"string","enum":["MOTORS_VEHICLES"]}]},"returnsAccepted":{"type":"boolean"},"returnPeriodDays":{"minimum":0,"type":"integer"},"refundMethod":{"anyOf":[{"type":"string","enum":["MONEY_BACK"]},{"type":"string","enum":["MERCHANDISE_CREDIT"]}]},"returnShippingCostPayer":{"anyOf":[{"type":"string","enum":["BUYER"]},{"type":"string","enum":["SELLER"]}]},"immediatePay":{"type":"boolean"},"handlingTimeDays":{"minimum":0,"type":"integer"},"shippingOptions":{"type":"array","items":{"type":"object","required":["optionType","costType","shippingServices"],"properties":{"optionType":{"anyOf":[{"type":"string","enum":["DOMESTIC"]},{"type":"string","enum":["INTERNATIONAL"]}]},"costType":{"anyOf":[{"type":"string","enum":["FLAT_RATE"]},{"type":"string","enum":["CALCULATED"]},{"type":"string","enum":["NOT_SPECIFIED"]}]},"shippingServices":{"type":"array","items":{"type":"object","required":["shippingServiceCode"],"properties":{"shippingServiceCode":{"type":"string"},"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"additionalShippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"freeShipping":{"type":"boolean"}}}}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1Policies","tags":["Policies"],"parameters":[],"summary":"Create a return / payment / fulfillment policy","description":"Body discriminator `type` picks the right `/sell/account/v1/{type}_policy` POST. Each policy type uses different required fields (return needs `returnsAccepted`; fulfillment needs `handlingTimeDays` + at least one `shippingOptions[]`; payment needs `immediatePay`). Account must be opted into `SELLING_POLICY_MANAGEMENT` first (see `POST /v1/me/programs/opt-in`).","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["type","name"],"properties":{"type":{"anyOf":[{"type":"string","enum":["return"]},{"type":"string","enum":["payment"]},{"type":"string","enum":["fulfillment"]}]},"name":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"description":{"type":"string"},"categoryType":{"anyOf":[{"type":"string","enum":["ALL_EXCLUDING_MOTORS_VEHICLES"]},{"type":"string","enum":["MOTORS_VEHICLES"]}]},"returnsAccepted":{"type":"boolean"},"returnPeriodDays":{"minimum":0,"type":"integer"},"refundMethod":{"anyOf":[{"type":"string","enum":["MONEY_BACK"]},{"type":"string","enum":["MERCHANDISE_CREDIT"]}]},"returnShippingCostPayer":{"anyOf":[{"type":"string","enum":["BUYER"]},{"type":"string","enum":["SELLER"]}]},"immediatePay":{"type":"boolean"},"handlingTimeDays":{"minimum":0,"type":"integer"},"shippingOptions":{"type":"array","items":{"type":"object","required":["optionType","costType","shippingServices"],"properties":{"optionType":{"anyOf":[{"type":"string","enum":["DOMESTIC"]},{"type":"string","enum":["INTERNATIONAL"]}]},"costType":{"anyOf":[{"type":"string","enum":["FLAT_RATE"]},{"type":"string","enum":["CALCULATED"]},{"type":"string","enum":["NOT_SPECIFIED"]}]},"shippingServices":{"type":"array","items":{"type":"object","required":["shippingServiceCode"],"properties":{"shippingServiceCode":{"type":"string"},"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"additionalShippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"freeShipping":{"type":"boolean"}}}}}}}}}}}}}},"/v1/policies/by-name":{"get":{"responses":{"200":{"description":"Policy."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1PoliciesBy-name","tags":["Policies"],"parameters":[],"summary":"Look up a policy by exact name (idempotency helper)","description":"Wraps Sell Account `/sell/account/v1/{type}_policy/get_by_policy_name?marketplace_id=&name=`. Useful for scripts that want to check whether a named policy exists before creating it (avoid duplicates)."}},"/v1/policies/rate-tables":{"get":{"responses":{"200":{"description":"Rate tables.","content":{"application/json":{"schema":{"type":"object","required":["rateTables"],"properties":{"rateTables":{"type":"array","items":{"type":"object","required":["id","name","marketplace"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"shippingOption":{"description":"DOMESTIC | INTERNATIONAL","type":"string"},"countryCode":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1PoliciesRate-tables","tags":["Policies"],"parameters":[],"summary":"List shipping rate tables"}},"/v1/policies/custom":{"get":{"responses":{"200":{"description":"Custom policies.","content":{"application/json":{"schema":{"type":"object","required":["customPolicies"],"properties":{"customPolicies":{"type":"array","items":{"type":"object","required":["id","name","policyType","marketplace"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"policyType":{"description":"PRODUCT_COMPLIANCE | TAKE_BACK","type":"string"},"description":{"type":"string"},"label":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1PoliciesCustom","tags":["Policies"],"parameters":[],"summary":"List custom policies (product-compliance / take-back)"},"post":{"responses":{"201":{"description":"Created.","content":{"application/json":{"schema":{"type":"object","required":["name","policyType"],"properties":{"name":{"type":"string"},"policyType":{"description":"PRODUCT_COMPLIANCE | TAKE_BACK","type":"string"},"description":{"type":"string"},"label":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1PoliciesCustom","tags":["Policies"],"parameters":[],"summary":"Create a custom policy","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["name","policyType"],"properties":{"name":{"type":"string"},"policyType":{"description":"PRODUCT_COMPLIANCE | TAKE_BACK","type":"string"},"description":{"type":"string"},"label":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]}}}}}}}},"/v1/policies/{id}/transfer":{"post":{"responses":{"200":{"description":"Transferred."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1PoliciesByIdTransfer","tags":["Policies"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Transfer a fulfillment policy to another seller","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["targetUsername"],"properties":{"targetUsername":{"type":"string"}}}}}}}},"/v1/policies/setup":{"post":{"responses":{"200":{"description":"Policies ready.","content":{"application/json":{"schema":{"type":"object","required":["returnPolicyId","paymentPolicyId","fulfillmentPolicyId","created"],"properties":{"returnPolicyId":{"type":"string"},"paymentPolicyId":{"type":"string"},"fulfillmentPolicyId":{"type":"string"},"created":{"type":"object","required":["return","payment","fulfillment"],"properties":{"return":{"anyOf":[{"type":"string","enum":["created"]},{"type":"string","enum":["existing"]}]},"payment":{"anyOf":[{"type":"string","enum":["created"]},{"type":"string","enum":["existing"]}]},"fulfillment":{"anyOf":[{"type":"string","enum":["created"]},{"type":"string","enum":["existing"]}]}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1PoliciesSetup","tags":["Policies"],"parameters":[],"summary":"Atomically ensure return + payment + fulfillment policies exist","description":"One-shot setup tied to the user's actual preferences (returns yes/no + period + payer; handling time + shipping mode/service). Idempotent: re-uses existing policies on the seller account when present, only creates the missing ones. Returns the three ids ready to pass to `POST /v1/listings`. **Replaces hidden auto-create.** Earlier `/v1/listings` invented sane-looking defaults (free shipping, 30-day buyer-pays returns) on the seller's behalf — that silently lost real money. Now agents gather the few decisions from the user via MCP and POST them here once.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["returns","fulfillment"],"properties":{"returns":{"type":"object","required":["accepted"],"properties":{"accepted":{"type":"boolean"},"periodDays":{"anyOf":[{"type":"number","enum":[14]},{"type":"number","enum":[30]},{"type":"number","enum":[60]}]},"shippingPayer":{"anyOf":[{"type":"string","enum":["buyer"]},{"type":"string","enum":["seller"]}]}}},"fulfillment":{"type":"object","required":["handlingTimeDays","shipping"],"properties":{"handlingTimeDays":{"minimum":0,"maximum":30,"type":"integer"},"shipping":{"type":"object","required":["mode","serviceCode"],"properties":{"mode":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["flat"]},{"type":"string","enum":["calculated"]}]},"serviceCode":{"minLength":2,"maxLength":60,"type":"string"},"flatRateCents":{"minimum":0,"type":"integer"}}}}},"marketplace":{"type":"string","enum":["ebay_us"]}}}}}}}},"/v1/policies/{type}/{id}":{"put":{"responses":{"200":{"description":"Updated.","content":{"application/json":{"schema":{"type":"object","required":["type","name"],"properties":{"type":{"anyOf":[{"type":"string","enum":["return"]},{"type":"string","enum":["payment"]},{"type":"string","enum":["fulfillment"]}]},"name":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"description":{"type":"string"},"categoryType":{"anyOf":[{"type":"string","enum":["ALL_EXCLUDING_MOTORS_VEHICLES"]},{"type":"string","enum":["MOTORS_VEHICLES"]}]},"returnsAccepted":{"type":"boolean"},"returnPeriodDays":{"minimum":0,"type":"integer"},"refundMethod":{"anyOf":[{"type":"string","enum":["MONEY_BACK"]},{"type":"string","enum":["MERCHANDISE_CREDIT"]}]},"returnShippingCostPayer":{"anyOf":[{"type":"string","enum":["BUYER"]},{"type":"string","enum":["SELLER"]}]},"immediatePay":{"type":"boolean"},"handlingTimeDays":{"minimum":0,"type":"integer"},"shippingOptions":{"type":"array","items":{"type":"object","required":["optionType","costType","shippingServices"],"properties":{"optionType":{"anyOf":[{"type":"string","enum":["DOMESTIC"]},{"type":"string","enum":["INTERNATIONAL"]}]},"costType":{"anyOf":[{"type":"string","enum":["FLAT_RATE"]},{"type":"string","enum":["CALCULATED"]},{"type":"string","enum":["NOT_SPECIFIED"]}]},"shippingServices":{"type":"array","items":{"type":"object","required":["shippingServiceCode"],"properties":{"shippingServiceCode":{"type":"string"},"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"additionalShippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"freeShipping":{"type":"boolean"}}}}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"putV1PoliciesByTypeById","tags":["Policies"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"type","required":true},{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Replace one return / payment / fulfillment policy","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["type","name"],"properties":{"type":{"anyOf":[{"type":"string","enum":["return"]},{"type":"string","enum":["payment"]},{"type":"string","enum":["fulfillment"]}]},"name":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"description":{"type":"string"},"categoryType":{"anyOf":[{"type":"string","enum":["ALL_EXCLUDING_MOTORS_VEHICLES"]},{"type":"string","enum":["MOTORS_VEHICLES"]}]},"returnsAccepted":{"type":"boolean"},"returnPeriodDays":{"minimum":0,"type":"integer"},"refundMethod":{"anyOf":[{"type":"string","enum":["MONEY_BACK"]},{"type":"string","enum":["MERCHANDISE_CREDIT"]}]},"returnShippingCostPayer":{"anyOf":[{"type":"string","enum":["BUYER"]},{"type":"string","enum":["SELLER"]}]},"immediatePay":{"type":"boolean"},"handlingTimeDays":{"minimum":0,"type":"integer"},"shippingOptions":{"type":"array","items":{"type":"object","required":["optionType","costType","shippingServices"],"properties":{"optionType":{"anyOf":[{"type":"string","enum":["DOMESTIC"]},{"type":"string","enum":["INTERNATIONAL"]}]},"costType":{"anyOf":[{"type":"string","enum":["FLAT_RATE"]},{"type":"string","enum":["CALCULATED"]},{"type":"string","enum":["NOT_SPECIFIED"]}]},"shippingServices":{"type":"array","items":{"type":"object","required":["shippingServiceCode"],"properties":{"shippingServiceCode":{"type":"string"},"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"additionalShippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"freeShipping":{"type":"boolean"}}}}}}}}}}}}},"delete":{"responses":{"200":{"description":"Deleted."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1PoliciesByTypeById","tags":["Policies"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"type","required":true},{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Delete a return / payment / fulfillment policy"}},"/v1/media/uploads":{"post":{"responses":{"201":{"description":"Upload URL."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Image hosting not configured — set BLOB_CONNECTION_STRING.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1MediaUploads","tags":["Media"],"parameters":[],"summary":"Get a pre-signed image / video upload URL","description":"Returns `{mediaId, uploadUrl, uploadHeaders, expiresAt}` plus `publicUrl` for image uploads. PUT the binary directly to `uploadUrl` with the supplied headers. Use `publicUrl` in the listing's `imageUrls[]`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["type"],"properties":{"type":{"anyOf":[{"type":"string","enum":["image"]},{"type":"string","enum":["video"]}]},"contentType":{"description":"MIME type the caller will PUT (default: image/jpeg). Image uploads only.","type":"string"}}}}}}}},"/v1/media/ebay-pictures":{"post":{"responses":{"201":{"description":"Picture uploaded; URL ready to use in `imageUrls[]`."},"401":{"description":"API key missing or eBay account not connected (POST /v1/connect/ebay).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1MediaEbay-pictures","tags":["Media"],"parameters":[],"summary":"Upload an image directly to eBay's Picture Hosting (Trading API)","description":"One-shot eBay-direct upload. Caller supplies a public `sourceUrl`; flipagent fetches it, wraps in multipart, forwards to eBay's `UploadSiteHostedPictures`, returns the stable `https://i.ebayimg.com/...` URL. Use when you want eBay to host the image (eBay-only listing, no third-party storage in the flow). For multi-marketplace / permanent catalog use, prefer `POST /v1/media/uploads` (flipagent-hosted blob)."}},"/v1/media/{id}":{"get":{"responses":{"200":{"description":"Media."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MediaById","tags":["Media"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Get media status"}},"/v1/sales":{"get":{"responses":{"200":{"description":"Sales page.","content":{"application/json":{"schema":{"type":"object","required":["limit","offset","sales"],"properties":{"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"next":{"anyOf":[{"type":"string","nullable":true}]},"sales":{"type":"array","items":{"type":"object","required":["id","marketplace","status","items","pricing","paidAt","createdAt"],"properties":{"id":{"description":"eBay orderId — '27-12345-67890' form.","type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["paid"]},{"type":"string","enum":["shipped"]},{"type":"string","enum":["delivered"]},{"type":"string","enum":["refunded"]},{"type":"string","enum":["cancelled"]}]},"items":{"type":"array","items":{"type":"object","required":["lineItemId","itemId","title","quantity","price"],"properties":{"lineItemId":{"type":"string"},"itemId":{"type":"string"},"sku":{"type":"string"},"title":{"type":"string"},"quantity":{"minimum":1,"type":"integer"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"image":{"type":"string"},"variationId":{"type":"string"}}}},"buyer":{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"email":{"type":"string"}}},"shipTo":{"type":"object","required":["line1","city","postalCode","country"],"properties":{"name":{"type":"string"},"line1":{"type":"string"},"line2":{"type":"string"},"city":{"type":"string"},"region":{"description":"State / province","type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"},"phone":{"type":"string"}}},"pricing":{"type":"object","required":["total"],"properties":{"subtotal":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"tax":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"total":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"shipping":{"type":"object","properties":{"carrier":{"type":"string"},"trackingNumber":{"type":"string"},"shippedAt":{"type":"string"},"deliveredAt":{"type":"string"}}},"paidAt":{"type":"string"},"createdAt":{"type":"string"}}}}}}}}},"401":{"description":"API key missing or eBay account not connected.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1Sales","tags":["Sales"],"parameters":[{"in":"query","name":"limit","required":false,"schema":{}},{"in":"query","name":"offset","required":false,"schema":{}},{"in":"query","name":"status","required":false,"schema":{}},{"in":"query","name":"marketplace","required":false,"schema":{}}],"summary":"List my sales (orders received)"}},"/v1/sales/{id}":{"get":{"responses":{"200":{"description":"Sale.","content":{"application/json":{"schema":{"type":"object","required":["id","marketplace","status","items","pricing","paidAt","createdAt"],"properties":{"id":{"description":"eBay orderId — '27-12345-67890' form.","type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["paid"]},{"type":"string","enum":["shipped"]},{"type":"string","enum":["delivered"]},{"type":"string","enum":["refunded"]},{"type":"string","enum":["cancelled"]}]},"items":{"type":"array","items":{"type":"object","required":["lineItemId","itemId","title","quantity","price"],"properties":{"lineItemId":{"type":"string"},"itemId":{"type":"string"},"sku":{"type":"string"},"title":{"type":"string"},"quantity":{"minimum":1,"type":"integer"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"image":{"type":"string"},"variationId":{"type":"string"}}}},"buyer":{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"email":{"type":"string"}}},"shipTo":{"type":"object","required":["line1","city","postalCode","country"],"properties":{"name":{"type":"string"},"line1":{"type":"string"},"line2":{"type":"string"},"city":{"type":"string"},"region":{"description":"State / province","type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"},"phone":{"type":"string"}}},"pricing":{"type":"object","required":["total"],"properties":{"subtotal":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"tax":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"total":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"shipping":{"type":"object","properties":{"carrier":{"type":"string"},"trackingNumber":{"type":"string"},"shippedAt":{"type":"string"},"deliveredAt":{"type":"string"}}},"paidAt":{"type":"string"},"createdAt":{"type":"string"}}}}}},"401":{"description":"API key missing or eBay account not connected.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1SalesById","tags":["Sales"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Get a sale"}},"/v1/sales/{id}/ship":{"post":{"responses":{"200":{"description":"Updated sale.","content":{"application/json":{"schema":{"type":"object","required":["id","marketplace","status","items","pricing","paidAt","createdAt"],"properties":{"id":{"description":"eBay orderId — '27-12345-67890' form.","type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["paid"]},{"type":"string","enum":["shipped"]},{"type":"string","enum":["delivered"]},{"type":"string","enum":["refunded"]},{"type":"string","enum":["cancelled"]}]},"items":{"type":"array","items":{"type":"object","required":["lineItemId","itemId","title","quantity","price"],"properties":{"lineItemId":{"type":"string"},"itemId":{"type":"string"},"sku":{"type":"string"},"title":{"type":"string"},"quantity":{"minimum":1,"type":"integer"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"image":{"type":"string"},"variationId":{"type":"string"}}}},"buyer":{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"email":{"type":"string"}}},"shipTo":{"type":"object","required":["line1","city","postalCode","country"],"properties":{"name":{"type":"string"},"line1":{"type":"string"},"line2":{"type":"string"},"city":{"type":"string"},"region":{"description":"State / province","type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"},"phone":{"type":"string"}}},"pricing":{"type":"object","required":["total"],"properties":{"subtotal":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"tax":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"total":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"shipping":{"type":"object","properties":{"carrier":{"type":"string"},"trackingNumber":{"type":"string"},"shippedAt":{"type":"string"},"deliveredAt":{"type":"string"}}},"paidAt":{"type":"string"},"createdAt":{"type":"string"}}}}}},"401":{"description":"API key missing or eBay account not connected.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1SalesByIdShip","tags":["Sales"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Mark shipped + tracking","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["trackingNumber","carrier"],"properties":{"trackingNumber":{"type":"string"},"carrier":{"description":"USPS | UPS | FEDEX | DHL | …","type":"string"},"lineItemIds":{"description":"Defaults to all line items.","type":"array","items":{"type":"string"}},"shippedAt":{"type":"string"}}}}}}}},"/v1/sales/{id}/refund":{"post":{"responses":{"200":{"description":"Updated sale.","content":{"application/json":{"schema":{"type":"object","required":["id","marketplace","status","items","pricing","paidAt","createdAt"],"properties":{"id":{"description":"eBay orderId — '27-12345-67890' form.","type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["paid"]},{"type":"string","enum":["shipped"]},{"type":"string","enum":["delivered"]},{"type":"string","enum":["refunded"]},{"type":"string","enum":["cancelled"]}]},"items":{"type":"array","items":{"type":"object","required":["lineItemId","itemId","title","quantity","price"],"properties":{"lineItemId":{"type":"string"},"itemId":{"type":"string"},"sku":{"type":"string"},"title":{"type":"string"},"quantity":{"minimum":1,"type":"integer"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"image":{"type":"string"},"variationId":{"type":"string"}}}},"buyer":{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"email":{"type":"string"}}},"shipTo":{"type":"object","required":["line1","city","postalCode","country"],"properties":{"name":{"type":"string"},"line1":{"type":"string"},"line2":{"type":"string"},"city":{"type":"string"},"region":{"description":"State / province","type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"},"phone":{"type":"string"}}},"pricing":{"type":"object","required":["total"],"properties":{"subtotal":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"tax":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"total":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"shipping":{"type":"object","properties":{"carrier":{"type":"string"},"trackingNumber":{"type":"string"},"shippedAt":{"type":"string"},"deliveredAt":{"type":"string"}}},"paidAt":{"type":"string"},"createdAt":{"type":"string"}}}}}},"401":{"description":"API key missing or eBay account not connected.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1SalesByIdRefund","tags":["Sales"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Issue refund","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["reason"],"properties":{"amount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"reason":{"description":"BUYER_RETURN | NOT_AS_DESCRIBED | SHIPPING_LOST | OUT_OF_STOCK_OR_CANNOT_FULFILL | …","type":"string"},"lineItemIds":{"type":"array","items":{"type":"string"}},"comment":{"type":"string"}}}}}}}},"/v1/labels/quote":{"post":{"responses":{"200":{"description":"Quotes.","content":{"application/json":{"schema":{"type":"object","required":["options"],"properties":{"options":{"type":"array","items":{"type":"object","required":["quoteId","serviceCode","carrier","cost"],"properties":{"quoteId":{"type":"string"},"serviceCode":{"type":"string"},"carrier":{"type":"string"},"cost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"estimatedDeliveryFrom":{"type":"string"},"estimatedDeliveryTo":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1LabelsQuote","tags":["Labels"],"parameters":[],"summary":"Get rate quotes for an eBay-issued shipping label","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["shipFrom","shipTo","weight"],"properties":{"shipFrom":{"type":"object","required":["line1","city","postalCode","country"],"properties":{"name":{"type":"string"},"line1":{"type":"string"},"line2":{"type":"string"},"city":{"type":"string"},"region":{"description":"State / province","type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"},"phone":{"type":"string"}}},"shipTo":{"type":"object","required":["line1","city","postalCode","country"],"properties":{"name":{"type":"string"},"line1":{"type":"string"},"line2":{"type":"string"},"city":{"type":"string"},"region":{"description":"State / province","type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"},"phone":{"type":"string"}}},"weight":{"type":"object","required":["value","unit"],"properties":{"value":{"type":"number"},"unit":{"anyOf":[{"type":"string","enum":["ounce"]},{"type":"string","enum":["pound"]},{"type":"string","enum":["gram"]},{"type":"string","enum":["kilogram"]}]}}},"dimensions":{"type":"object","required":["length","width","height","unit"],"properties":{"length":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"unit":{"anyOf":[{"type":"string","enum":["inch"]},{"type":"string","enum":["centimeter"]}]}}}}}}}}}},"/v1/labels":{"post":{"responses":{"201":{"description":"Label.","content":{"application/json":{"schema":{"type":"object","required":["id","serviceCode","carrier","cost","voidable","purchasedAt"],"properties":{"id":{"type":"string"},"serviceCode":{"type":"string"},"carrier":{"type":"string"},"trackingNumber":{"type":"string"},"labelUrl":{"type":"string"},"cost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"voidable":{"type":"boolean"},"purchasedAt":{"type":"string"}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1Labels","tags":["Labels"],"parameters":[],"summary":"Buy a shipping label from a quote","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["quoteId"],"properties":{"quoteId":{"type":"string"},"orderId":{"type":"string"}}}}}}}},"/v1/labels/{id}":{"delete":{"responses":{"200":{"description":"Voided."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1LabelsById","tags":["Labels"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Void a shipping label"}},"/v1/ship/quote":{"post":{"responses":{"200":{"description":"Landed-cost breakdown.","content":{"application/json":{"schema":{"type":"object","required":["itemPriceCents","shippingCents","forwarderCents","taxCents","totalCents","forwarderProviderId","forwarderEtaDays","forwarderCaveats"],"properties":{"itemPriceCents":{"type":"integer"},"shippingCents":{"type":"integer"},"forwarderCents":{"type":"integer"},"taxCents":{"type":"integer"},"totalCents":{"type":"integer"},"forwarderProviderId":{"type":"string"},"forwarderEtaDays":{"type":"array","items":[{"type":"integer"},{"type":"integer"}],"minItems":2,"maxItems":2,"x-additionalItems":false},"forwarderCaveats":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1ShipQuote","tags":["Ship"],"parameters":[],"summary":"Compute landed cost via a US-domestic forwarder","description":"Sums item price + eBay seller's listed shipping + forwarder fees. Tax is currently 0 — destination-state sales tax is the caller's responsibility. Returns the forwarder's ETA window and any caveats verbatim (e.g. dim-weight billed, service doesn't serve AK/HI).","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["item","forwarder"],"properties":{"item":{"anyOf":[{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"itemAffiliateWebUrl":{"type":"string"},"itemHref":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"lastSoldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"lastSoldDate":{"type":"string"},"totalSoldQuantity":{"type":"integer"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"thumbnailImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"epid":{"type":"string"},"gtin":{"type":"string"},"categoryId":{"type":"string"},"leafCategoryIds":{"type":"array","items":{"type":"string"}},"itemGroupHref":{"type":"string"},"itemGroupType":{"type":"string"},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"listingMarketplaceId":{"type":"string"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"}}},{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"listingMarketplaceId":{"type":"string"},"sellerItemRevision":{"type":"string"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"description":{"type":"string"},"shortDescription":{"type":"string"},"categoryPath":{"type":"string"},"categoryId":{"type":"string"},"categoryIdPath":{"type":"string"},"localizedAspects":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"},"type":{"type":"string"}}}},"brand":{"type":"string"},"color":{"type":"string"},"size":{"type":"string"},"pattern":{"type":"string"},"material":{"type":"string"},"sizeType":{"type":"string"},"mpn":{"type":"string"},"gtin":{"type":"string"},"epid":{"type":"string"},"lotSize":{"type":"integer"},"quantityLimitPerBuyer":{"type":"integer"},"conditionDescription":{"type":"string"},"conditionDescriptors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"values":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"}}}}}}},"marketingPrice":{"type":"object","properties":{"originalPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"discountAmount":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"discountPercentage":{"type":"string"},"priceTreatment":{"type":"string"}}},"primaryProductReviewRating":{"type":"object","properties":{"reviewCount":{"type":"integer"},"averageRating":{"type":"string"},"ratingHistograms":{"type":"array","items":{"type":"object","required":["rating","count"],"properties":{"rating":{"type":"string"},"count":{"type":"integer"}}}}}},"warnings":{"type":"array","items":{"type":"object","properties":{"errorId":{"type":"integer"},"domain":{"type":"string"},"category":{"type":"string"},"message":{"type":"string"},"parameters":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}}}}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"priorityListing":{"type":"boolean"},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"estimatedAvailabilities":{"type":"array","items":{"type":"object","properties":{"estimatedAvailabilityStatus":{"type":"string"},"estimatedAvailableQuantity":{"type":"integer"},"estimatedSoldQuantity":{"type":"integer"},"estimatedRemainingQuantity":{"type":"integer"},"availabilityThreshold":{"type":"integer"},"availabilityThresholdType":{"type":"string"},"deliveryOptions":{"type":"array","items":{"type":"string"}}}}},"shipToLocations":{"type":"object","properties":{"regionIncluded":{"type":"array","items":{"type":"object","properties":{"regionName":{"type":"string"},"regionType":{"type":"string"},"regionId":{"type":"string"}}}},"regionExcluded":{"type":"array","items":{"type":"object","properties":{"regionName":{"type":"string"},"regionType":{"type":"string"},"regionId":{"type":"string"}}}}}},"returnTerms":{"type":"object","properties":{"returnsAccepted":{"type":"boolean"},"returnPeriod":{"type":"object","required":["value","unit"],"properties":{"value":{"type":"integer"},"unit":{"type":"string"}}},"returnShippingCostPayer":{"type":"string"},"refundMethod":{"type":"string"},"returnMethod":{"type":"string"}}},"taxes":{"type":"array","items":{"type":"object","properties":{"taxJurisdiction":{"type":"object","properties":{"region":{"type":"object","properties":{"regionName":{"type":"string"},"regionType":{"type":"string"}}},"taxJurisdictionId":{"type":"string"}}},"taxType":{"type":"string"},"shippingAndHandlingTaxed":{"type":"boolean"},"includedInPrice":{"type":"boolean"},"ebayCollectAndRemitTax":{"type":"boolean"},"taxPercentage":{"type":"string"}}}},"paymentMethods":{"type":"array","items":{"type":"object","properties":{"paymentMethodType":{"type":"string"},"paymentMethodBrands":{"type":"array","items":{"type":"object","properties":{"paymentMethodBrandType":{"type":"string"},"logoImage":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}}}}}}},"immediatePay":{"type":"boolean"},"enabledForGuestCheckout":{"type":"boolean"},"eligibleForInlineCheckout":{"type":"boolean"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"},"primaryItemGroup":{"type":"object","properties":{"itemGroupId":{"type":"string"},"itemGroupType":{"type":"string"},"itemGroupHref":{"type":"string"},"itemGroupTitle":{"type":"string"},"itemGroupImage":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"itemGroupAdditionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}}}},"unitPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"unitPricingMeasure":{"type":"string"}}}]},"forwarder":{"type":"object","required":["destState","weightG"],"properties":{"destState":{"minLength":2,"maxLength":2,"description":"ISO 3166-2 US state code, e.g. NY, TX, HI.","type":"string"},"weightG":{"minimum":1,"description":"Package weight in grams.","type":"integer"},"dimsCm":{"type":"object","required":["l","w","h"],"properties":{"l":{"minimum":0,"type":"number"},"w":{"minimum":0,"type":"number"},"h":{"minimum":0,"type":"number"}}},"provider":{"description":"Forwarder provider id. Defaults to planet-express.","type":"string"},"itemCount":{"minimum":1,"description":"Items consolidated; default 1.","type":"integer"}}}}}}}}}},"/v1/ship/providers":{"get":{"responses":{"200":{"description":"Forwarder catalog.","content":{"application/json":{"schema":{"type":"object","required":["providers"],"properties":{"providers":{"type":"array","items":{"type":"object","required":["id","name","originState","handlingCents","perExtraItemCents","consolidationCents","dimDivisor","defaultService","supportedServices","notes"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"originState":{"type":"string"},"handlingCents":{"type":"integer"},"perExtraItemCents":{"type":"integer"},"consolidationCents":{"type":"integer"},"dimDivisor":{"type":"integer"},"defaultService":{"type":"string"},"supportedServices":{"type":"array","items":{"type":"string"}},"notes":{"type":"array","items":{"type":"string"}}}}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1ShipProviders","tags":["Ship"],"parameters":[],"summary":"List available forwarder providers","description":"Returns the forwarders flipagent supports for landed-cost quotes. Each entry exposes per-package handling, consolidation fees, dim-weight divisor, and the carrier services it can route through."}},"/v1/messages":{"get":{"responses":{"200":{"description":"Conversation page.","content":{"application/json":{"schema":{"type":"object","required":["limit","offset","conversations"],"properties":{"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"next":{"anyOf":[{"type":"string","nullable":true}]},"conversations":{"type":"array","items":{"type":"object","required":["id","marketplace","type","status","unreadCount","createdAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"type":{"anyOf":[{"description":"System messages from eBay (returns, payments, listing reminders, promos).","type":"string","enum":["from_ebay"]},{"description":"Member-to-member chat (buyer ↔ seller).","type":"string","enum":["from_members"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]}]},"title":{"type":"string"},"referenceId":{"description":"Item ID when referenceType=listing.","type":"string"},"referenceType":{"description":"Currently always `listing` from eBay.","type":"string"},"unreadCount":{"minimum":0,"type":"integer"},"latestMessage":{"type":"object","required":["id","body","createdAt"],"properties":{"id":{"type":"string"},"body":{"type":"string"},"senderUsername":{"type":"string"},"recipientUsername":{"type":"string"},"subject":{"type":"string"},"readStatus":{"type":"boolean"},"createdAt":{"type":"string"}}},"createdAt":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1Messages","tags":["Messages"],"parameters":[{"in":"query","name":"limit","required":false,"schema":{}},{"in":"query","name":"offset","required":false,"schema":{}},{"in":"query","name":"type","required":false,"schema":{}},{"in":"query","name":"marketplace","required":false,"schema":{}}],"summary":"List conversations"},"post":{"responses":{"200":{"description":"Sent.","content":{"application/json":{"schema":{"type":"object","required":["id","body","createdAt"],"properties":{"id":{"type":"string"},"conversationId":{"type":"string"},"senderUsername":{"type":"string"},"recipientUsername":{"type":"string"},"subject":{"type":"string"},"body":{"type":"string"},"createdAt":{"type":"string"},"redactions":{"type":"array","items":{"type":"object","required":["kind","original"],"properties":{"kind":{"type":"string"},"original":{"type":"string"}}}}}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"422":{"description":"Off-eBay contact info detected; edit + retry or pass ?force_send=1.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1Messages","tags":["Messages"],"parameters":[],"summary":"Send a message (reply into a thread or open a new one)","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["messageText"],"properties":{"conversationId":{"description":"Reply into this thread.","type":"string"},"otherPartyUsername":{"description":"Open a new thread with this eBay user.","type":"string"},"reference":{"type":"object","required":["referenceType","referenceId"],"properties":{"referenceType":{"description":"Currently `listing` only.","type":"string"},"referenceId":{"description":"eBay item ID for `listing` references.","type":"string"}}},"messageText":{"minLength":1,"maxLength":2000,"type":"string"},"emailCopyToSender":{"type":"boolean"}}}}}}}},"/v1/messages/{conversationId}":{"get":{"responses":{"200":{"description":"Conversation thread.","content":{"application/json":{"schema":{"type":"object","required":["limit","offset","conversation","messages"],"properties":{"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"next":{"anyOf":[{"type":"string","nullable":true}]},"conversation":{"type":"object","required":["id","marketplace","type","status","unreadCount","createdAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"type":{"anyOf":[{"description":"System messages from eBay (returns, payments, listing reminders, promos).","type":"string","enum":["from_ebay"]},{"description":"Member-to-member chat (buyer ↔ seller).","type":"string","enum":["from_members"]}]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["archived"]}]},"title":{"type":"string"},"referenceId":{"description":"Item ID when referenceType=listing.","type":"string"},"referenceType":{"description":"Currently always `listing` from eBay.","type":"string"},"unreadCount":{"minimum":0,"type":"integer"},"latestMessage":{"type":"object","required":["id","body","createdAt"],"properties":{"id":{"type":"string"},"body":{"type":"string"},"senderUsername":{"type":"string"},"recipientUsername":{"type":"string"},"subject":{"type":"string"},"readStatus":{"type":"boolean"},"createdAt":{"type":"string"}}},"createdAt":{"type":"string"}}},"messages":{"type":"array","items":{"type":"object","required":["id","body","createdAt"],"properties":{"id":{"type":"string"},"body":{"type":"string"},"senderUsername":{"type":"string"},"recipientUsername":{"type":"string"},"subject":{"type":"string"},"readStatus":{"type":"boolean"},"createdAt":{"type":"string"}}}}}}}}},"400":{"description":"Validation failed (type query param required).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MessagesByConversationId","tags":["Messages"],"parameters":[{"in":"query","name":"type","required":true,"schema":{}},{"in":"query","name":"limit","required":false,"schema":{}},{"in":"query","name":"offset","required":false,"schema":{}},{"schema":{"type":"string"},"in":"path","name":"conversationId","required":true}],"summary":"Get the messages in one conversation thread"}},"/v1/messages/conversations/bulk":{"patch":{"responses":{"200":{"description":"Updated.","content":{"application/json":{"schema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"patchV1MessagesConversationsBulk","tags":["Messages"],"parameters":[],"summary":"Mark / archive many conversations at once","description":"Wraps eBay `commerce/message/v1/bulk_update_conversation`. Action: `mark_read` | `mark_unread` | `archive` | `unarchive`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["conversationIds","action"],"properties":{"conversationIds":{"minItems":1,"type":"array","items":{"type":"string"}},"action":{"anyOf":[{"type":"string","enum":["mark_read"]},{"type":"string","enum":["mark_unread"]},{"type":"string","enum":["archive"]},{"type":"string","enum":["unarchive"]}]}}}}}}}},"/v1/messages/conversations/{id}":{"patch":{"responses":{"200":{"description":"Updated.","content":{"application/json":{"schema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"patchV1MessagesConversationsById","tags":["Messages"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Mark / archive one conversation","description":"Wraps eBay `commerce/message/v1/update_conversation`. Action: `mark_read` | `mark_unread` | `archive` | `unarchive`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["action"],"properties":{"action":{"anyOf":[{"type":"string","enum":["mark_read"]},{"type":"string","enum":["mark_unread"]},{"type":"string","enum":["archive"]},{"type":"string","enum":["unarchive"]}]}}}}}}}},"/v1/feedback":{"get":{"responses":{"200":{"description":"Feedback page.","content":{"application/json":{"schema":{"type":"object","required":["limit","offset","feedback"],"properties":{"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"next":{"anyOf":[{"type":"string","nullable":true}]},"feedback":{"type":"array","items":{"type":"object","required":["id","marketplace","role","rating","comment","fromUser","toUser","createdAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"role":{"anyOf":[{"type":"string","enum":["buyer"]},{"type":"string","enum":["seller"]}]},"rating":{"anyOf":[{"type":"string","enum":["positive"]},{"type":"string","enum":["neutral"]},{"type":"string","enum":["negative"]}]},"comment":{"type":"string"},"fromUser":{"type":"string"},"toUser":{"type":"string"},"listingId":{"type":"string"},"orderId":{"type":"string"},"createdAt":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1Feedback","tags":["Feedback"],"parameters":[{"in":"query","name":"limit","required":false,"schema":{}},{"in":"query","name":"offset","required":false,"schema":{}},{"in":"query","name":"role","required":false,"schema":{}},{"in":"query","name":"marketplace","required":false,"schema":{}}],"summary":"List feedback (sent or received)"},"post":{"responses":{"200":{"description":"Acknowledged.","content":{"application/json":{"schema":{"type":"object","required":["limit","offset","feedback"],"properties":{"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"next":{"anyOf":[{"type":"string","nullable":true}]},"feedback":{"type":"array","items":{"type":"object","required":["id","marketplace","role","rating","comment","fromUser","toUser","createdAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"role":{"anyOf":[{"type":"string","enum":["buyer"]},{"type":"string","enum":["seller"]}]},"rating":{"anyOf":[{"type":"string","enum":["positive"]},{"type":"string","enum":["neutral"]},{"type":"string","enum":["negative"]}]},"comment":{"type":"string"},"fromUser":{"type":"string"},"toUser":{"type":"string"},"listingId":{"type":"string"},"orderId":{"type":"string"},"createdAt":{"type":"string"}}}}}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1Feedback","tags":["Feedback"],"parameters":[],"summary":"Leave feedback","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["orderId","toUser","rating","comment"],"properties":{"orderId":{"type":"string"},"toUser":{"type":"string"},"rating":{"anyOf":[{"type":"string","enum":["positive"]},{"type":"string","enum":["neutral"]},{"type":"string","enum":["negative"]}]},"comment":{"minLength":1,"maxLength":80,"type":"string"}}}}}}}},"/v1/feedback/awaiting":{"get":{"responses":{"200":{"description":"Awaiting.","content":{"application/json":{"schema":{"type":"object","required":["role","items"],"properties":{"role":{"anyOf":[{"type":"string","enum":["seller"]},{"type":"string","enum":["buyer"]}]},"items":{"type":"array","items":{"type":"object","required":["orderId","listingId","counterparty","title","price","transactionDate"],"properties":{"orderId":{"type":"string"},"listingId":{"type":"string"},"counterparty":{"type":"string"},"title":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"transactionDate":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1FeedbackAwaiting","tags":["Feedback"],"parameters":[],"summary":"Orders awaiting feedback"}},"/v1/feedback/{id}/respond":{"post":{"responses":{"200":{"description":"Acknowledged."},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"422":{"description":"Off-eBay contact info detected.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1FeedbackByIdRespond","tags":["Feedback"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Respond to feedback the order partner left","description":"REST `commerce/feedback/v1/respond_to_feedback`. The connected user must be the recipient of the original feedback. Same off-eBay-contact hygiene as `/v1/feedback` POST."}},"/v1/notifications/ebay/inbound":{"post":{"responses":{"200":{"description":"Notification logged (idempotent)."}},"operationId":"postV1NotificationsEbayInbound","tags":["Notifications"],"parameters":[],"summary":"eBay Trading API Platform Notifications receiver","description":"Public endpoint eBay POSTs SOAP/XML envelopes to. Signature verified locally via DevID + AppID + CertID + message Timestamp. Always returns 200 once the row is logged so eBay does not retry — replays are dropped via sha256 dedupe."}},"/v1/notifications/ebay/subscribe":{"post":{"responses":{"200":{"description":"Subscription updated."},"401":{"description":"API key missing or eBay account not connected.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream Trading API call failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay notifications configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1NotificationsEbaySubscribe","tags":["Notifications"],"parameters":[],"summary":"Subscribe the connected eBay seller to flipagent notifications","description":"Calls Trading API SetNotificationPreferences and enables ItemSold + AuctionCheckoutComplete + FixedPriceTransaction + OutBid + ItemUnsold for this user, pointing eBay at the operator-configured callback URL. Idempotent — safe to retry."},"get":{"responses":{"200":{"description":"Current ApplicationURL + enabled events."},"401":{"description":"API key missing or eBay account not connected.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay notifications configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1NotificationsEbaySubscribe","tags":["Notifications"],"parameters":[],"summary":"Read the current eBay notification subscription for this seller"}},"/v1/notifications/recent":{"get":{"responses":{"200":{"description":"Recent notifications."}},"operationId":"getV1NotificationsRecent","tags":["Notifications"],"parameters":[],"summary":"Last 50 inbound platform notifications for this account (debug)"}},"/v1/notifications/topics":{"get":{"responses":{"200":{"description":"Topics."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1NotificationsTopics","tags":["Notifications"],"parameters":[],"summary":"List available notification topics"}},"/v1/notifications/destinations":{"get":{"responses":{"200":{"description":"Destinations."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1NotificationsDestinations","tags":["Notifications"],"parameters":[],"summary":"List notification destinations"}},"/v1/notifications/subscriptions":{"get":{"responses":{"200":{"description":"Subscriptions.","content":{"application/json":{"schema":{"type":"object","required":["subscriptions"],"properties":{"subscriptions":{"type":"array","items":{"type":"object","required":["id","topicId","destinationId","status"],"properties":{"id":{"type":"string"},"topicId":{"description":"ITEM_SOLD | RETURN_OPENED | …","type":"string"},"destinationId":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["enabled"]},{"type":"string","enum":["disabled"]}]},"filterExpression":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1NotificationsSubscriptions","tags":["Notifications"],"parameters":[],"summary":"List subscriptions"},"post":{"responses":{"201":{"description":"Created."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1NotificationsSubscriptions","tags":["Notifications"],"parameters":[],"summary":"Create subscription","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["topicId","destinationId"],"properties":{"topicId":{"type":"string"},"destinationId":{"type":"string"},"filterExpression":{"type":"string"}}}}}}}},"/v1/notifications/subscriptions/{id}":{"get":{"responses":{"200":{"description":"Subscription."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1NotificationsSubscriptionsById","tags":["Notifications"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Get subscription"},"delete":{"responses":{"204":{"description":"Deleted."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1NotificationsSubscriptionsById","tags":["Notifications"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Delete subscription"}},"/v1/notifications/subscriptions/{id}/enable":{"post":{"responses":{"204":{"description":"Enabled."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1NotificationsSubscriptionsByIdEnable","tags":["Notifications"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Enable a paused subscription"}},"/v1/notifications/subscriptions/{id}/disable":{"post":{"responses":{"204":{"description":"Disabled."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1NotificationsSubscriptionsByIdDisable","tags":["Notifications"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Disable an active subscription (events stop firing)"}},"/v1/notifications/subscriptions/{id}/test":{"post":{"responses":{"204":{"description":"Test dispatched."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1NotificationsSubscriptionsByIdTest","tags":["Notifications"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Send a test event to the destination","description":"eBay POSTs a synthetic event payload to the destination URL wired on this subscription. Use this to verify webhook delivery + signature verification round-trip end-to-end before relying on live events."}},"/v1/notifications/subscriptions/{id}/filters/{filterId}":{"get":{"responses":{"200":{"description":"Filter."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1NotificationsSubscriptionsByIdFiltersByFilterId","tags":["Notifications"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"filterId","required":true}],"summary":"Get one subscription filter"},"delete":{"responses":{"204":{"description":"Removed."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1NotificationsSubscriptionsByIdFiltersByFilterId","tags":["Notifications"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"filterId","required":true}],"summary":"Remove a subscription filter"}},"/v1/notifications/subscriptions/{id}/filters":{"post":{"responses":{"201":{"description":"Filter created."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1NotificationsSubscriptionsByIdFilters","tags":["Notifications"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Add a filter expression to a subscription","description":"Filter expressions narrow which events fire on this subscription (e.g. only events for a specific listing). See eBay docs for filter expression syntax."}},"/v1/notifications/config":{"get":{"responses":{"200":{"description":"Config."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1NotificationsConfig","tags":["Notifications"],"parameters":[],"summary":"Get notification config (alert email)"},"put":{"responses":{"204":{"description":"Updated."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"putV1NotificationsConfig","tags":["Notifications"],"parameters":[],"summary":"Update notification config (alert email destination)"}},"/v1/notifications/public-keys/{id}":{"get":{"responses":{"200":{"description":"Public key."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1NotificationsPublic-keysById","tags":["Notifications"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Get a notification signing public key","description":"eBay rotates webhook signing keys. The kid header on inbound notifications references one of these keys; fetch it here to verify signatures locally."}},"/v1/webhooks":{"post":{"responses":{"201":{"description":"Webhook registered.","content":{"application/json":{"schema":{"type":"object","allOf":[{"type":"object","required":["id","url","events","description","createdAt","lastDeliveryAt","lastErrorAt"],"properties":{"id":{"format":"uuid","type":"string"},"url":{"format":"uri","type":"string"},"events":{"type":"array","items":{"anyOf":[{"type":"string","enum":["order.queued"]},{"type":"string","enum":["order.claimed"]},{"type":"string","enum":["order.awaiting_user_confirm"]},{"type":"string","enum":["order.placing"]},{"type":"string","enum":["order.completed"]},{"type":"string","enum":["order.failed"]},{"type":"string","enum":["order.cancelled"]},{"type":"string","enum":["order.expired"]},{"type":"string","enum":["item.sold"]},{"type":"string","enum":["forwarder.received"]},{"type":"string","enum":["forwarder.shipped"]}]}},"description":{"anyOf":[{"type":"string","nullable":true}]},"createdAt":{"format":"date-time","type":"string"},"lastDeliveryAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"lastErrorAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}},{"type":"object","required":["secret"],"properties":{"secret":{"description":"HMAC-SHA256 shared secret. Shown once. Store it on the receiver.","type":"string"}}}]}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1Webhooks","tags":["Webhooks"],"parameters":[],"summary":"Register a webhook endpoint","description":"Returns the secret in the response — store it on the receiver to verify the `Flipagent-Signature` header on incoming deliveries. The secret is shown only at registration; it cannot be retrieved later.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["url","events"],"properties":{"url":{"format":"uri","minLength":8,"maxLength":2048,"type":"string"},"events":{"minItems":1,"type":"array","items":{"anyOf":[{"type":"string","enum":["order.queued"]},{"type":"string","enum":["order.claimed"]},{"type":"string","enum":["order.awaiting_user_confirm"]},{"type":"string","enum":["order.placing"]},{"type":"string","enum":["order.completed"]},{"type":"string","enum":["order.failed"]},{"type":"string","enum":["order.cancelled"]},{"type":"string","enum":["order.expired"]},{"type":"string","enum":["item.sold"]},{"type":"string","enum":["forwarder.received"]},{"type":"string","enum":["forwarder.shipped"]}]}},"description":{"maxLength":200,"type":"string"}}}}}}},"get":{"responses":{"200":{"description":"Endpoint list (secrets are not returned).","content":{"application/json":{"schema":{"type":"object","required":["endpoints"],"properties":{"endpoints":{"type":"array","items":{"type":"object","required":["id","url","events","description","createdAt","lastDeliveryAt","lastErrorAt"],"properties":{"id":{"format":"uuid","type":"string"},"url":{"format":"uri","type":"string"},"events":{"type":"array","items":{"anyOf":[{"type":"string","enum":["order.queued"]},{"type":"string","enum":["order.claimed"]},{"type":"string","enum":["order.awaiting_user_confirm"]},{"type":"string","enum":["order.placing"]},{"type":"string","enum":["order.completed"]},{"type":"string","enum":["order.failed"]},{"type":"string","enum":["order.cancelled"]},{"type":"string","enum":["order.expired"]},{"type":"string","enum":["item.sold"]},{"type":"string","enum":["forwarder.received"]},{"type":"string","enum":["forwarder.shipped"]}]}},"description":{"anyOf":[{"type":"string","nullable":true}]},"createdAt":{"format":"date-time","type":"string"},"lastDeliveryAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"lastErrorAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1Webhooks","tags":["Webhooks"],"parameters":[],"summary":"List active webhook endpoints"}},"/v1/webhooks/{id}":{"delete":{"responses":{"204":{"description":"Revoked."},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Endpoint not found for this api key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1WebhooksById","tags":["Webhooks"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Revoke a webhook endpoint (soft-delete)"}},"/v1/offers":{"get":{"responses":{"200":{"description":"Offers page.","content":{"application/json":{"schema":{"type":"object","required":["limit","offset","offers"],"properties":{"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"next":{"anyOf":[{"type":"string","nullable":true}]},"offers":{"type":"array","items":{"type":"object","required":["id","marketplace","direction","status","listingId","price","quantity","createdAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"direction":{"anyOf":[{"type":"string","enum":["incoming"]},{"type":"string","enum":["outgoing"]}]},"status":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["accepted"]},{"type":"string","enum":["declined"]},{"type":"string","enum":["countered"]},{"type":"string","enum":["expired"]}]},"listingId":{"type":"string"},"buyer":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"quantity":{"minimum":1,"default":1,"type":"integer"},"message":{"type":"string"},"expiresAt":{"type":"string"},"createdAt":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1Offers","tags":["Offers"],"parameters":[{"in":"query","name":"limit","required":false,"schema":{}},{"in":"query","name":"offset","required":false,"schema":{}},{"in":"query","name":"direction","required":false,"schema":{}},{"in":"query","name":"status","required":false,"schema":{}},{"in":"query","name":"listingId","required":false,"schema":{}},{"in":"query","name":"marketplace","required":false,"schema":{}}],"summary":"List Best Offers (inbound today; outbound future)"},"post":{"responses":{"201":{"description":"Created.","content":{"application/json":{"schema":{"type":"object","required":["limit","offset","offers"],"properties":{"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"next":{"anyOf":[{"type":"string","nullable":true}]},"offers":{"type":"array","items":{"type":"object","required":["id","marketplace","direction","status","listingId","price","quantity","createdAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"direction":{"anyOf":[{"type":"string","enum":["incoming"]},{"type":"string","enum":["outgoing"]}]},"status":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["accepted"]},{"type":"string","enum":["declined"]},{"type":"string","enum":["countered"]},{"type":"string","enum":["expired"]}]},"listingId":{"type":"string"},"buyer":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"quantity":{"minimum":1,"default":1,"type":"integer"},"message":{"type":"string"},"expiresAt":{"type":"string"},"createdAt":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1Offers","tags":["Offers"],"parameters":[],"summary":"Send a Best Offer outbound to a listing's watchers","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["listingId","discountPercent"],"properties":{"listingId":{"type":"string"},"watchers":{"description":"Buyer usernames; defaults to all watchers.","type":"array","items":{"type":"string"}},"discountPercent":{"minimum":1,"maximum":50,"type":"integer"},"expiresIn":{"description":"Hours until expiry. eBay default 48h.","type":"integer"},"message":{"maxLength":1000,"type":"string"}}}}}}}},"/v1/offers/eligible-listings":{"get":{"responses":{"200":{"description":"Eligible items."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1OffersEligible-listings","tags":["Offers"],"parameters":[],"summary":"List eligible listings for outbound Best Offer"}},"/v1/offers/{id}/respond":{"post":{"responses":{"200":{"description":"Acknowledged.","content":{"application/json":{"schema":{"type":"object","required":["limit","offset","offers"],"properties":{"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"next":{"anyOf":[{"type":"string","nullable":true}]},"offers":{"type":"array","items":{"type":"object","required":["id","marketplace","direction","status","listingId","price","quantity","createdAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"direction":{"anyOf":[{"type":"string","enum":["incoming"]},{"type":"string","enum":["outgoing"]}]},"status":{"anyOf":[{"type":"string","enum":["pending"]},{"type":"string","enum":["accepted"]},{"type":"string","enum":["declined"]},{"type":"string","enum":["countered"]},{"type":"string","enum":["expired"]}]},"listingId":{"type":"string"},"buyer":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"quantity":{"minimum":1,"default":1,"type":"integer"},"message":{"type":"string"},"expiresAt":{"type":"string"},"createdAt":{"type":"string"}}}}}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1OffersByIdRespond","tags":["Offers"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Respond to an incoming Best Offer (accept / decline / counter)","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["action"],"properties":{"action":{"anyOf":[{"type":"string","enum":["accept"]},{"type":"string","enum":["decline"]},{"type":"string","enum":["counter"]}]},"counterPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"message":{"maxLength":1000,"type":"string"}}}}}}}},"/v1/ebay/notifications/account-deletion":{"get":{"responses":{"200":{"description":"Challenge response."},"400":{"description":"Missing challenge_code query parameter."},"503":{"description":"Deletion endpoint not configured on this api instance."}},"operationId":"getV1EbayNotificationsAccount-deletion","tags":["Notifications"],"parameters":[],"summary":"eBay Marketplace Account Deletion — challenge handshake","description":"GET handshake eBay performs whenever it (re)validates the registered Marketplace Account Deletion notification URL. Returns SHA-256(challengeCode + verificationToken + endpointUrl) hex-encoded as `{ challengeResponse }`. Verification token + endpoint URL come from env (`EBAY_DELETION_VERIFICATION_TOKEN` + `EBAY_DELETION_ENDPOINT_URL`); both must match exactly what's registered in the eBay developer portal.","security":[]},"post":{"responses":{"200":{"description":"Acknowledged."}},"operationId":"postV1EbayNotificationsAccount-deletion","tags":["Notifications"],"parameters":[],"summary":"eBay Marketplace Account Deletion — receive notification","description":"POST endpoint eBay calls with the canonical `{ metadata, notification: { notificationId, eventDate, publishDate, publishAttemptCount, data: { username, userId, eiasToken } } }` envelope when a buyer/seller closes or requests deletion of their eBay account. Always 200-acks within eBay's ~3s SLA so the application doesn't get marked down. Internal scrub (removing the userId from `ebay_account_links`, etc.) runs out-of-band — receipt logging is enough at the wire boundary.","security":[]}},"/v1/disputes":{"get":{"responses":{"200":{"description":"Disputes.","content":{"application/json":{"schema":{"type":"object","required":["limit","offset","disputes"],"properties":{"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"next":{"anyOf":[{"type":"string","nullable":true}]},"disputes":{"type":"array","items":{"type":"object","required":["id","marketplace","type","status","orderId","createdAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"type":{"anyOf":[{"type":"string","enum":["return"]},{"type":"string","enum":["case"]},{"type":"string","enum":["cancellation"]},{"type":"string","enum":["inquiry"]},{"type":"string","enum":["payment"]}]},"status":{"anyOf":[{"type":"string","enum":["open"]},{"type":"string","enum":["seller_action_required"]},{"type":"string","enum":["buyer_action_required"]},{"type":"string","enum":["escalated"]},{"type":"string","enum":["resolved"]},{"type":"string","enum":["closed"]}]},"orderId":{"type":"string"},"buyer":{"type":"string"},"reason":{"type":"string"},"amount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"respondBy":{"description":"ISO 8601 — seller respond deadline.","type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"closedAt":{"type":"string"}}}}}}}}},"401":{"description":"Auth.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1Disputes","tags":["Disputes"],"parameters":[{"in":"query","name":"limit","required":false,"schema":{}},{"in":"query","name":"offset","required":false,"schema":{}},{"in":"query","name":"type","required":false,"schema":{}},{"in":"query","name":"status","required":false,"schema":{}},{"in":"query","name":"orderId","required":false,"schema":{}},{"in":"query","name":"marketplace","required":false,"schema":{}}],"summary":"List disputes (returns + cases + cancellations + inquiries)"}},"/v1/disputes/{id}":{"get":{"responses":{"200":{"description":"Dispute.","content":{"application/json":{"schema":{"type":"object","required":["id","marketplace","type","status","orderId","createdAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"type":{"anyOf":[{"type":"string","enum":["return"]},{"type":"string","enum":["case"]},{"type":"string","enum":["cancellation"]},{"type":"string","enum":["inquiry"]},{"type":"string","enum":["payment"]}]},"status":{"anyOf":[{"type":"string","enum":["open"]},{"type":"string","enum":["seller_action_required"]},{"type":"string","enum":["buyer_action_required"]},{"type":"string","enum":["escalated"]},{"type":"string","enum":["resolved"]},{"type":"string","enum":["closed"]}]},"orderId":{"type":"string"},"buyer":{"type":"string"},"reason":{"type":"string"},"amount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"respondBy":{"description":"ISO 8601 — seller respond deadline.","type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"closedAt":{"type":"string"}}}}}},"401":{"description":"Auth.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1DisputesById","tags":["Disputes"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Get a dispute (any type — auto-resolves by id)"}},"/v1/disputes/cancellations/check-eligibility":{"post":{"responses":{"200":{"description":"Eligibility result.","content":{"application/json":{"schema":{"type":"object","required":["eligible","reasons"],"properties":{"eligible":{"type":"boolean"},"reasons":{"type":"array","items":{"type":"string"}}}}}}},"401":{"description":"Auth.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1DisputesCancellationsCheck-eligibility","tags":["Disputes"],"parameters":[],"summary":"Check if a seller can cancel an order","description":"Wraps `/post-order/v2/cancellation/check_eligibility`. Use before `flipagent_create_cancellation` to confirm cancellation is permitted (and surface eBay's allowed reason list). Some orders pass the cancellation window or are otherwise locked.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["legacyOrderId","items"],"properties":{"legacyOrderId":{"type":"string"},"items":{"minItems":1,"type":"array","items":{"type":"object","required":["itemId"],"properties":{"itemId":{"type":"string"},"transactionId":{"type":"string"}}}}}}}}}}},"/v1/disputes/cancellations":{"post":{"responses":{"201":{"description":"Cancellation created.","content":{"application/json":{"schema":{"type":"object","required":["cancelId","status"],"properties":{"cancelId":{"anyOf":[{"type":"string","nullable":true}]},"status":{"anyOf":[{"type":"string","nullable":true}]}}}}}},"401":{"description":"Auth.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1DisputesCancellations","tags":["Disputes"],"parameters":[],"summary":"Create a seller-initiated cancellation","description":"Wraps `/post-order/v2/cancellation` (POST). For seller-initiated cancellations (out-of-stock, address issues, buyer asked). Distinct from `respondToDispute(action='accept')` which acknowledges a buyer-initiated cancellation request.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["legacyOrderId","reason","items"],"properties":{"legacyOrderId":{"description":"eBay legacy order id (numeric).","type":"string"},"reason":{"anyOf":[{"type":"string","enum":["BUYER_ASKED_CANCEL"]},{"type":"string","enum":["OUT_OF_STOCK_OR_CANNOT_FULFILL"]},{"type":"string","enum":["ADDRESS_ISSUES"]}]},"items":{"minItems":1,"type":"array","items":{"type":"object","required":["itemId"],"properties":{"itemId":{"type":"string"},"transactionId":{"type":"string"}}}}}}}}}}},"/v1/disputes/{id}/close":{"post":{"responses":{"200":{"description":"Closed."},"401":{"description":"Auth.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Not an inquiry.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1DisputesByIdClose","tags":["Disputes"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Close an open inquiry (no further action)","description":"Wraps `POST /post-order/v2/inquiry/{id}/close`. Inquiry-only; the call 404s for return / case / cancellation / payment dispute ids. Returns the refreshed Dispute (now `closed`)."}},"/v1/disputes/{id}/activity":{"get":{"responses":{"200":{"description":"Activity log.","content":{"application/json":{"schema":{"type":"object","required":["disputeId","activity"],"properties":{"disputeId":{"type":"string"},"activity":{"type":"array","items":{"type":"object","required":["activityType","date"],"properties":{"activityType":{"description":"e.g. OPENED, EVIDENCE_ADDED, CONTESTED, RESOLVED.","type":"string"},"actor":{"description":"BUYER | SELLER | EBAY.","type":"string"},"date":{"description":"ISO 8601 timestamp.","type":"string"},"notes":{"type":"string"}}}}}}}}},"401":{"description":"Auth.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Dispute not found or not a payment dispute.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1DisputesByIdActivity","tags":["Disputes"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Activity history (payment disputes only)","description":"Returns the activity log for a payment dispute (open / contested / evidence-added / resolved). 404 when the id resolves to a return / case / cancellation / inquiry — eBay has no activity endpoint for those."}},"/v1/disputes/{id}/evidence/files":{"post":{"responses":{"200":{"description":"File uploaded.","content":{"application/json":{"schema":{"type":"object","required":["fileId"],"properties":{"fileId":{"type":"string"}}}}}},"400":{"description":"Missing file.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Auth.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1DisputesByIdEvidenceFiles","tags":["Disputes"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Upload one binary evidence file (multipart) to a payment dispute","description":"Wraps `POST /sell/fulfillment/v1/payment_dispute/{id}/upload_evidence_file`. Accepts `multipart/form-data` with a `file` part (JPEG/JPG/PNG only per eBay). Returns the `fileId` you'll reference in `POST /v1/disputes/{id}/evidence` to bundle into an evidence set, then in `respondToDispute(action='decline')` to contest."}},"/v1/disputes/{id}/evidence":{"post":{"responses":{"200":{"description":"Evidence created.","content":{"application/json":{"schema":{"type":"object","required":["evidenceId"],"properties":{"evidenceId":{"type":"string"}}}}}},"401":{"description":"Auth.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1DisputesByIdEvidence","tags":["Disputes"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Bundle uploaded files into an evidence set on a payment dispute","description":"Wraps `POST /sell/fulfillment/v1/payment_dispute/{id}/add_evidence`. Pass `fileIds` from prior uploads + an `evidenceType` (eBay's EvidenceTypeEnum: PROOF_OF_DELIVERY, REPLACEMENT_SHIPPED, etc.). Returns the `evidenceId` for later updateEvidence + contest.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["evidenceType","fileIds"],"properties":{"evidenceType":{"description":"eBay EvidenceTypeEnum value (e.g. PROOF_OF_DELIVERY).","type":"string"},"fileIds":{"minItems":1,"type":"array","items":{"type":"string"}},"lineItems":{"type":"array","items":{"type":"object","required":["itemId","lineItemId"],"properties":{"itemId":{"type":"string"},"lineItemId":{"type":"string"}}}}}}}}}}},"/v1/disputes/{id}/evidence/{evidenceId}":{"put":{"responses":{"204":{"description":"Updated."},"401":{"description":"Auth.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"putV1DisputesByIdEvidenceByEvidenceId","tags":["Disputes"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"evidenceId","required":true}],"summary":"Add more files to an existing evidence set","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["evidenceType","fileIds","evidenceId"],"properties":{"evidenceType":{"description":"eBay EvidenceTypeEnum value (e.g. PROOF_OF_DELIVERY).","type":"string"},"fileIds":{"minItems":1,"type":"array","items":{"type":"string"}},"lineItems":{"type":"array","items":{"type":"object","required":["itemId","lineItemId"],"properties":{"itemId":{"type":"string"},"lineItemId":{"type":"string"}}}},"evidenceId":{"type":"string"}}}}}}}},"/v1/disputes/{id}/evidence/{evidenceId}/files/{fileId}":{"get":{"responses":{"200":{"description":"Binary content."},"401":{"description":"Auth.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1DisputesByIdEvidenceByEvidenceIdFilesByFileId","tags":["Disputes"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true},{"schema":{"type":"string"},"in":"path","name":"evidenceId","required":true},{"schema":{"type":"string"},"in":"path","name":"fileId","required":true}],"summary":"Download one evidence file (binary stream)","description":"Wraps `GET /sell/fulfillment/v1/payment_dispute/{id}/fetch_evidence_content`. Streams the raw file with eBay's Content-Type. Useful for audit / re-uploading to your own archive."}},"/v1/disputes/{id}/respond":{"post":{"responses":{"200":{"description":"Updated dispute.","content":{"application/json":{"schema":{"type":"object","required":["id","marketplace","type","status","orderId","createdAt"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"type":{"anyOf":[{"type":"string","enum":["return"]},{"type":"string","enum":["case"]},{"type":"string","enum":["cancellation"]},{"type":"string","enum":["inquiry"]},{"type":"string","enum":["payment"]}]},"status":{"anyOf":[{"type":"string","enum":["open"]},{"type":"string","enum":["seller_action_required"]},{"type":"string","enum":["buyer_action_required"]},{"type":"string","enum":["escalated"]},{"type":"string","enum":["resolved"]},{"type":"string","enum":["closed"]}]},"orderId":{"type":"string"},"buyer":{"type":"string"},"reason":{"type":"string"},"amount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"respondBy":{"description":"ISO 8601 — seller respond deadline.","type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"closedAt":{"type":"string"}}}}}},"401":{"description":"Auth.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1DisputesByIdRespond","tags":["Disputes"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Respond to a dispute","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["action"],"properties":{"action":{"anyOf":[{"type":"string","enum":["accept"]},{"type":"string","enum":["decline"]},{"type":"string","enum":["counter"]},{"type":"string","enum":["provide_tracking"]},{"type":"string","enum":["offer_refund"]},{"type":"string","enum":["escalate"]}]},"amount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"trackingNumber":{"type":"string"},"carrier":{"type":"string"},"message":{"maxLength":1000,"type":"string"},"returnAddress":{"type":"object","required":["fullName","addressLine1","city","postalCode","country"],"properties":{"fullName":{"type":"string"},"addressLine1":{"type":"string"},"addressLine2":{"type":"string"},"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"description":"ISO 3166-1 alpha-2.","type":"string"},"primaryPhone":{"type":"string"}}}}}}}}}},"/v1/payouts/summary":{"get":{"responses":{"200":{"description":"Summary."},"401":{"description":"API key missing or eBay account not connected.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1PayoutsSummary","tags":["Money"],"parameters":[],"summary":"Payout aggregate over a date range"}},"/v1/payouts":{"get":{"responses":{"200":{"description":"Payouts page.","content":{"application/json":{"schema":{"type":"object","required":["limit","offset","payouts"],"properties":{"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"next":{"anyOf":[{"type":"string","nullable":true}]},"payouts":{"type":"array","items":{"type":"object","required":["id","marketplace","status","amount","initiatedAt"],"properties":{"id":{"description":"eBay `payoutId`.","type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["initiated"]},{"type":"string","enum":["succeeded"]},{"type":"string","enum":["retryable_failed"]},{"type":"string","enum":["terminal_failed"]},{"type":"string","enum":["reversed"]}]},"amount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"fees":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"net":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"bankReference":{"type":"string"},"initiatedAt":{"type":"string"},"completedAt":{"type":"string"}}}}}}}}},"401":{"description":"API key missing or eBay account not connected.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1Payouts","tags":["Money"],"parameters":[{"in":"query","name":"limit","required":false,"schema":{}},{"in":"query","name":"offset","required":false,"schema":{}},{"in":"query","name":"status","required":false,"schema":{}},{"in":"query","name":"marketplace","required":false,"schema":{}}],"summary":"List payouts"}},"/v1/transactions":{"get":{"responses":{"200":{"description":"Transactions page.","content":{"application/json":{"schema":{"type":"object","required":["limit","offset","transactions"],"properties":{"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"next":{"anyOf":[{"type":"string","nullable":true}]},"transactions":{"type":"array","items":{"type":"object","required":["id","marketplace","type","amount","occurredAt"],"properties":{"id":{"description":"eBay `transactionId`.","type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"type":{"anyOf":[{"type":"string","enum":["sale"]},{"type":"string","enum":["refund"]},{"type":"string","enum":["credit"]},{"type":"string","enum":["dispute"]},{"type":"string","enum":["shipping_label"]},{"type":"string","enum":["transfer"]},{"type":"string","enum":["non_sale_charge"]},{"type":"string","enum":["loan_repayment"]},{"type":"string","enum":["other"]}]},"amount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"fees":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"net":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"orderId":{"type":"string"},"payoutId":{"type":"string"},"memo":{"type":"string"},"occurredAt":{"type":"string"}}}}}}}}},"401":{"description":"API key missing or eBay account not connected.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay request failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"This api instance does not have eBay configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1Transactions","tags":["Money"],"parameters":[{"in":"query","name":"limit","required":false,"schema":{}},{"in":"query","name":"offset","required":false,"schema":{}},{"in":"query","name":"type","required":false,"schema":{}},{"in":"query","name":"orderId","required":false,"schema":{}},{"in":"query","name":"marketplace","required":false,"schema":{}}],"summary":"List transactions"}},"/v1/analytics/traffic":{"get":{"responses":{"200":{"description":"Traffic.","content":{"application/json":{"schema":{"type":"object","required":["marketplace","from","to","rows"],"properties":{"marketplace":{"type":"string","enum":["ebay_us"]},"from":{"type":"string"},"to":{"type":"string"},"rows":{"type":"array","items":{"type":"object","required":["date"],"properties":{"date":{"type":"string"},"listingId":{"type":"string"},"listingViews":{"minimum":0,"type":"integer"},"listingImpressions":{"minimum":0,"type":"integer"},"clickThroughRate":{"type":"number"},"transactions":{"minimum":0,"type":"integer"},"salesConversionRate":{"type":"number"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1AnalyticsTraffic","tags":["Analytics"],"parameters":[],"summary":"Traffic report"}},"/v1/analytics/standards":{"get":{"responses":{"200":{"description":"Standards.","content":{"application/json":{"schema":{"type":"object","required":["marketplace","program","cycle","level"],"properties":{"marketplace":{"type":"string","enum":["ebay_us"]},"program":{"description":"PROGRAM_US | PROGRAM_GLOBAL | …","type":"string"},"cycle":{"description":"CURRENT | PROJECTED","type":"string"},"level":{"anyOf":[{"type":"string","enum":["top_rated"]},{"type":"string","enum":["above_standard"]},{"type":"string","enum":["at_risk"]},{"type":"string","enum":["below_standard"]}]},"evaluationCycle":{"type":"string"},"metrics":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string"},"value":{"type":"number"},"level":{"anyOf":[{"type":"string","enum":["top_rated"]},{"type":"string","enum":["above_standard"]},{"type":"string","enum":["at_risk"]},{"type":"string","enum":["below_standard"]}]}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1AnalyticsStandards","tags":["Analytics"],"parameters":[],"summary":"Seller standards profile"}},"/v1/analytics/service-metrics":{"get":{"responses":{"200":{"description":"Metrics.","content":{"application/json":{"schema":{"type":"object","required":["marketplace","metrics"],"properties":{"marketplace":{"type":"string","enum":["ebay_us"]},"metrics":{"type":"array","items":{"type":"object","required":["metric","level","count"],"properties":{"metric":{"description":"ITEM_NOT_AS_DESCRIBED | ITEM_NOT_RECEIVED | LATE_SHIPMENT | …","type":"string"},"level":{"anyOf":[{"type":"string","enum":["top_rated"]},{"type":"string","enum":["above_standard"]},{"type":"string","enum":["at_risk"]},{"type":"string","enum":["below_standard"]}]},"count":{"minimum":0,"type":"integer"},"percentage":{"type":"number"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1AnalyticsService-metrics","tags":["Analytics"],"parameters":[],"summary":"Customer-service metrics"}},"/v1/recommendations":{"get":{"responses":{"200":{"description":"Recommendations.","content":{"application/json":{"schema":{"type":"object","required":["limit","offset","recommendations"],"properties":{"limit":{"minimum":1,"maximum":200,"default":50,"type":"integer"},"offset":{"minimum":0,"default":0,"type":"integer"},"total":{"minimum":0,"type":"integer"},"next":{"anyOf":[{"type":"string","nullable":true}]},"recommendations":{"type":"array","items":{"type":"object","required":["listingId","marketplace","recommendations"],"properties":{"listingId":{"type":"string"},"sku":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"recommendations":{"type":"array","items":{"type":"object","required":["type"],"properties":{"type":{"description":"AD | INTERNATIONAL_SHIPPING | TITLE | …","type":"string"},"message":{"type":"string"},"suggestedBidPercentage":{"type":"string"}}}}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1Recommendations","tags":["Recommendations"],"parameters":[{"in":"query","name":"limit","required":false,"schema":{}},{"in":"query","name":"offset","required":false,"schema":{}},{"in":"query","name":"listingId","required":false,"schema":{}},{"in":"query","name":"marketplace","required":false,"schema":{}}],"summary":"List listing optimization recommendations"}},"/v1/connect/ebay":{"get":{"responses":{"302":{"description":"Redirect to eBay authorize."},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"eBay OAuth env not configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1ConnectEbay","tags":["OAuth"],"parameters":[],"summary":"Start eBay OAuth handshake (API-key flow)","description":"Redirects the caller's browser to eBay's consent page. Caller must include a valid API key."},"delete":{"responses":{"200":{"description":"Local binding removed; eBay-side revocation attempted best-effort."},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1ConnectEbay","tags":["OAuth"],"parameters":[],"summary":"Disconnect eBay account (API-key flow)"}},"/v1/connect/ebay/callback":{"get":{"responses":{"302":{"description":"Redirect to APP_URL/dashboard?ebay=connected|error."},"503":{"description":"eBay OAuth env not configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1ConnectEbayCallback","tags":["OAuth"],"parameters":[],"summary":"eBay OAuth callback","description":"eBay redirects here with `?code=`. Exchanges code, stores tokens, then 302s the browser to the dashboard."}},"/v1/connect/ebay/status":{"get":{"responses":{"200":{"description":"Connection state for the caller's api key."},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1ConnectEbayStatus","tags":["OAuth"],"parameters":[],"summary":"Get current eBay connection status (API-key flow)"}},"/v1/me/seller/privilege":{"get":{"responses":{"200":{"description":"Privilege.","content":{"application/json":{"schema":{"type":"object","required":["sellerRegistrationCompleted"],"properties":{"sellerRegistrationCompleted":{"type":"boolean"},"sellingLimit":{"type":"object","properties":{"amount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"quantity":{"minimum":0,"type":"integer"}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MeSellerPrivilege","tags":["Seller"],"parameters":[],"summary":"Selling privileges + limits"}},"/v1/me/seller/kyc":{"get":{"responses":{"200":{"description":"KYC.","content":{"application/json":{"schema":{"type":"object","required":["responses"],"properties":{"responses":{"type":"array","items":{"type":"object","required":["field","status"],"properties":{"field":{"type":"string"},"status":{"description":"REQUIRED | APPROVED | REJECTED | EXPIRED | …","type":"string"},"dueAt":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MeSellerKyc","tags":["Seller"],"parameters":[],"summary":"KYC status"}},"/v1/me/seller/subscription":{"get":{"responses":{"200":{"description":"Subscriptions.","content":{"application/json":{"schema":{"type":"object","required":["programs"],"properties":{"programs":{"type":"array","items":{"type":"object","required":["programType","status"],"properties":{"programType":{"description":"OUT_OF_STOCK_CONTROL | EBAY_PLUS | SELLING_POLICY_MANAGEMENT | …","type":"string"},"status":{"description":"OPTED_IN | OPTED_OUT","type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MeSellerSubscription","tags":["Seller"],"parameters":[],"summary":"Program opt-ins"}},"/v1/me/seller/payments-program":{"get":{"responses":{"200":{"description":"Status.","content":{"application/json":{"schema":{"type":"object","required":["marketplace","status","programType"],"properties":{"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"description":"OPTED_IN | OPTED_OUT | NOT_OPTED_IN","type":"string"},"programType":{"description":"EBAY_PAYMENTS | …","type":"string"}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MeSellerPayments-program","tags":["Seller"],"parameters":[],"summary":"Managed payments status"}},"/v1/me/seller/advertising-eligibility":{"get":{"responses":{"200":{"description":"Eligibility.","content":{"application/json":{"schema":{"type":"object","required":["marketplace","eligible"],"properties":{"marketplace":{"type":"string","enum":["ebay_us"]},"eligible":{"type":"boolean"},"programs":{"type":"array","items":{"description":"PROMOTED_LISTINGS_LITE | PROMOTED_LISTINGS_GENERAL | …","type":"string"}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MeSellerAdvertising-eligibility","tags":["Seller"],"parameters":[],"summary":"Promoted-listings eligibility"}},"/v1/me/seller/sales-tax/{country}":{"get":{"responses":{"200":{"description":"Sales tax.","content":{"application/json":{"schema":{"type":"object","required":["rows"],"properties":{"rows":{"type":"array","items":{"type":"object","required":["country","jurisdictionId","salesTaxPercentage","shippingAndHandlingTaxed"],"properties":{"country":{"type":"string"},"jurisdictionId":{"type":"string"},"salesTaxPercentage":{"type":"string"},"shippingAndHandlingTaxed":{"type":"boolean"},"salesTaxJurisdictionName":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MeSellerSales-taxByCountry","tags":["Seller"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"country","required":true}],"summary":"Sales-tax table for a country"}},"/v1/me/seller/sales-tax/{country}/{jurisdiction}":{"put":{"responses":{"200":{"description":"Saved."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"putV1MeSellerSales-taxByCountryByJurisdiction","tags":["Seller"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"country","required":true},{"schema":{"type":"string"},"in":"path","name":"jurisdiction","required":true}],"summary":"Set sales-tax rate for one jurisdiction","description":"Wraps `PUT /sell/account/v1/sales_tax/{country}/{jurisdictionId}`. Body: `{ salesTaxPercentage: number, shippingAndHandlingTaxed?: boolean }`. Replaces any existing rate for that jurisdiction."},"delete":{"responses":{"200":{"description":"Deleted."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1MeSellerSales-taxByCountryByJurisdiction","tags":["Seller"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"country","required":true},{"schema":{"type":"string"},"in":"path","name":"jurisdiction","required":true}],"summary":"Delete a sales-tax rate"}},"/v1/me/seller/payout-settings":{"get":{"responses":{"200":{"description":"Payout settings.","content":{"application/json":{"schema":{"type":"object","required":["raw"],"properties":{"raw":{"description":"eBay's full payout-settings shape; flipagent doesn't reshape."}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MeSellerPayout-settings","tags":["Seller"],"parameters":[],"summary":"Read payout settings (v2)","description":"Wraps `GET /sell/account/v2/payout_settings`. Schedule + linked banks + percentage split. Pass-through under `raw` because eBay's shape is rich and rarely-used."}},"/v1/me/seller/payout-settings/update-percentage":{"post":{"responses":{"200":{"description":"Updated.","content":{"application/json":{"schema":{"type":"object","required":["raw"],"properties":{"raw":{"description":"eBay's full payout-settings shape; flipagent doesn't reshape."}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1MeSellerPayout-settingsUpdate-percentage","tags":["Seller"],"parameters":[],"summary":"Update payout-percentage split (v2)","description":"Wraps `POST /sell/account/v2/payout_settings/update_percentage`. Body shape: pass through eBay's request via `{ raw: ... }`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["raw"],"properties":{"raw":{"description":"Pass-through to eBay's update_percentage body shape."}}}}}}}},"/v1/me/seller/rate-tables/{id}":{"get":{"responses":{"200":{"description":"Rate table.","content":{"application/json":{"schema":{"type":"object","required":["id","raw"],"properties":{"id":{"type":"string"},"raw":{"description":"eBay's full RateTable shape; flipagent doesn't reshape."}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MeSellerRate-tablesById","tags":["Seller"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Read a rate-table's full contents (v2)","description":"Wraps `GET /sell/account/v2/rate_table/{id}`. Returns regions + costs verbatim under `raw`."}},"/v1/me/seller/rate-tables/{id}/update-shipping-cost":{"post":{"responses":{"200":{"description":"Updated.","content":{"application/json":{"schema":{"type":"object","required":["id","raw"],"properties":{"id":{"type":"string"},"raw":{"description":"eBay's full RateTable shape; flipagent doesn't reshape."}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream eBay failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1MeSellerRate-tablesByIdUpdate-shipping-cost","tags":["Seller"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Patch a rate-table's shipping cost for one region","description":"Wraps `POST /sell/account/v2/rate_table/{id}/update_shipping_cost`. Body: pass eBay's request through `{ raw: ... }`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["raw"],"properties":{"raw":{"description":"Pass-through to eBay's update_shipping_cost body shape."}}}}}}}},"/v1/me/selling":{"get":{"responses":{"200":{"description":"Selling overview.","content":{"application/json":{"schema":{"type":"object","required":["active","sold","unsold"],"properties":{"active":{"type":"object","required":["items","total"],"properties":{"items":{"type":"array","items":{"type":"object","required":["id","marketplace","status","title","url","images"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["sold"]},{"type":"string","enum":["ended"]}]},"title":{"type":"string"},"url":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"condition":{"description":"Human-readable: 'New', 'Used', etc.","type":"string"},"conditionId":{"description":"eBay-style numeric id, kept for filtering.","type":"string"},"seller":{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"images":{"description":"Image URLs in seller-supplied order. First is primary.","type":"array","items":{"type":"string"}},"category":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"path":{"description":"Slash-joined breadcrumb if known.","type":"string"}}},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Flat key→value map.","type":"object","additionalProperties":true},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["auction"]},{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["best_offer"]}]}},"endsAt":{"description":"ISO 8601 listing end time.","type":"string"},"createdAt":{"description":"ISO 8601 listing creation time.","type":"string"},"watchCount":{"minimum":0,"type":"integer"},"bidding":{"type":"object","required":["count"],"properties":{"count":{"minimum":0,"type":"integer"},"currentBid":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"availableQuantity":{"minimum":0,"description":"Live stock remaining on the listing. Absent when eBay hides the count (e.g. 'More than 10 available') or for auctions.","type":"integer"},"soldQuantity":{"minimum":0,"description":"Rolling units shipped on this listing. Browse REST `estimatedSoldQuantity` for active, `totalSoldQuantity` for sold comps.","type":"integer"},"soldAt":{"description":"ISO 8601 sold/closed time.","type":"string"},"soldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","properties":{"cost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"free":{"type":"boolean"},"estimatedDeliveryFrom":{"type":"string"},"estimatedDeliveryTo":{"type":"string"},"shipsTo":{"type":"array","items":{"description":"Country codes, region names, or eBay region ids.","type":"string"}},"shipsToExcluded":{"type":"array","items":{"type":"string"}}}},"location":{"type":"object","properties":{"city":{"type":"string"},"region":{"type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"}}},"epid":{"description":"eBay catalog product id.","type":"string"},"gtin":{"description":"UPC / EAN / ISBN.","type":"string"},"mpn":{"description":"Manufacturer part number.","type":"string"},"groupId":{"type":"string"},"marketingPrice":{"type":"object","properties":{"originalPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountAmount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountPercentage":{"type":"string"},"priceTreatment":{"description":"STRIKETHROUGH | LIST_PRICE | MINIMUM_ADVERTISED_PRICE | MARKDOWN","type":"string"}}},"returnTerms":{"type":"object","properties":{"accepted":{"type":"boolean"},"periodDays":{"minimum":0,"type":"integer"},"shippingCostPayer":{"anyOf":[{"type":"string","enum":["buyer"]},{"type":"string","enum":["seller"]}]},"refundMethod":{"type":"string"},"returnMethod":{"type":"string"}}},"paymentMethods":{"description":"WALLET | CREDIT_CARD | …","type":"array","items":{"type":"string"}},"conditionDescriptors":{"type":"array","items":{"type":"object","required":["name","values"],"properties":{"name":{"description":"e.g. 'Professional Grader' or 'Grade'.","type":"string"},"values":{"type":"array","items":{"type":"string"}}}}},"topRatedBuyingExperience":{"type":"boolean"},"authenticityGuarantee":{"type":"boolean"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"},"qualifiedPrograms":{"description":"EBAY_REFURBISHED | AUTHENTICITY_GUARANTEE | …","type":"array","items":{"type":"string"}},"lotSize":{"minimum":0,"type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"}}}},"total":{"minimum":0,"type":"integer"}}},"sold":{"type":"object","required":["items","total"],"properties":{"items":{"type":"array","items":{"type":"object","required":["id","marketplace","status","title","url","images"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["sold"]},{"type":"string","enum":["ended"]}]},"title":{"type":"string"},"url":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"condition":{"description":"Human-readable: 'New', 'Used', etc.","type":"string"},"conditionId":{"description":"eBay-style numeric id, kept for filtering.","type":"string"},"seller":{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"images":{"description":"Image URLs in seller-supplied order. First is primary.","type":"array","items":{"type":"string"}},"category":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"path":{"description":"Slash-joined breadcrumb if known.","type":"string"}}},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Flat key→value map.","type":"object","additionalProperties":true},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["auction"]},{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["best_offer"]}]}},"endsAt":{"description":"ISO 8601 listing end time.","type":"string"},"createdAt":{"description":"ISO 8601 listing creation time.","type":"string"},"watchCount":{"minimum":0,"type":"integer"},"bidding":{"type":"object","required":["count"],"properties":{"count":{"minimum":0,"type":"integer"},"currentBid":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"availableQuantity":{"minimum":0,"description":"Live stock remaining on the listing. Absent when eBay hides the count (e.g. 'More than 10 available') or for auctions.","type":"integer"},"soldQuantity":{"minimum":0,"description":"Rolling units shipped on this listing. Browse REST `estimatedSoldQuantity` for active, `totalSoldQuantity` for sold comps.","type":"integer"},"soldAt":{"description":"ISO 8601 sold/closed time.","type":"string"},"soldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","properties":{"cost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"free":{"type":"boolean"},"estimatedDeliveryFrom":{"type":"string"},"estimatedDeliveryTo":{"type":"string"},"shipsTo":{"type":"array","items":{"description":"Country codes, region names, or eBay region ids.","type":"string"}},"shipsToExcluded":{"type":"array","items":{"type":"string"}}}},"location":{"type":"object","properties":{"city":{"type":"string"},"region":{"type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"}}},"epid":{"description":"eBay catalog product id.","type":"string"},"gtin":{"description":"UPC / EAN / ISBN.","type":"string"},"mpn":{"description":"Manufacturer part number.","type":"string"},"groupId":{"type":"string"},"marketingPrice":{"type":"object","properties":{"originalPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountAmount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountPercentage":{"type":"string"},"priceTreatment":{"description":"STRIKETHROUGH | LIST_PRICE | MINIMUM_ADVERTISED_PRICE | MARKDOWN","type":"string"}}},"returnTerms":{"type":"object","properties":{"accepted":{"type":"boolean"},"periodDays":{"minimum":0,"type":"integer"},"shippingCostPayer":{"anyOf":[{"type":"string","enum":["buyer"]},{"type":"string","enum":["seller"]}]},"refundMethod":{"type":"string"},"returnMethod":{"type":"string"}}},"paymentMethods":{"description":"WALLET | CREDIT_CARD | …","type":"array","items":{"type":"string"}},"conditionDescriptors":{"type":"array","items":{"type":"object","required":["name","values"],"properties":{"name":{"description":"e.g. 'Professional Grader' or 'Grade'.","type":"string"},"values":{"type":"array","items":{"type":"string"}}}}},"topRatedBuyingExperience":{"type":"boolean"},"authenticityGuarantee":{"type":"boolean"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"},"qualifiedPrograms":{"description":"EBAY_REFURBISHED | AUTHENTICITY_GUARANTEE | …","type":"array","items":{"type":"string"}},"lotSize":{"minimum":0,"type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"}}}},"total":{"minimum":0,"type":"integer"}}},"unsold":{"type":"object","required":["items","total"],"properties":{"items":{"type":"array","items":{"type":"object","required":["id","marketplace","status","title","url","images"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["sold"]},{"type":"string","enum":["ended"]}]},"title":{"type":"string"},"url":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"condition":{"description":"Human-readable: 'New', 'Used', etc.","type":"string"},"conditionId":{"description":"eBay-style numeric id, kept for filtering.","type":"string"},"seller":{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"images":{"description":"Image URLs in seller-supplied order. First is primary.","type":"array","items":{"type":"string"}},"category":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"path":{"description":"Slash-joined breadcrumb if known.","type":"string"}}},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Flat key→value map.","type":"object","additionalProperties":true},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["auction"]},{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["best_offer"]}]}},"endsAt":{"description":"ISO 8601 listing end time.","type":"string"},"createdAt":{"description":"ISO 8601 listing creation time.","type":"string"},"watchCount":{"minimum":0,"type":"integer"},"bidding":{"type":"object","required":["count"],"properties":{"count":{"minimum":0,"type":"integer"},"currentBid":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"availableQuantity":{"minimum":0,"description":"Live stock remaining on the listing. Absent when eBay hides the count (e.g. 'More than 10 available') or for auctions.","type":"integer"},"soldQuantity":{"minimum":0,"description":"Rolling units shipped on this listing. Browse REST `estimatedSoldQuantity` for active, `totalSoldQuantity` for sold comps.","type":"integer"},"soldAt":{"description":"ISO 8601 sold/closed time.","type":"string"},"soldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","properties":{"cost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"free":{"type":"boolean"},"estimatedDeliveryFrom":{"type":"string"},"estimatedDeliveryTo":{"type":"string"},"shipsTo":{"type":"array","items":{"description":"Country codes, region names, or eBay region ids.","type":"string"}},"shipsToExcluded":{"type":"array","items":{"type":"string"}}}},"location":{"type":"object","properties":{"city":{"type":"string"},"region":{"type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"}}},"epid":{"description":"eBay catalog product id.","type":"string"},"gtin":{"description":"UPC / EAN / ISBN.","type":"string"},"mpn":{"description":"Manufacturer part number.","type":"string"},"groupId":{"type":"string"},"marketingPrice":{"type":"object","properties":{"originalPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountAmount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountPercentage":{"type":"string"},"priceTreatment":{"description":"STRIKETHROUGH | LIST_PRICE | MINIMUM_ADVERTISED_PRICE | MARKDOWN","type":"string"}}},"returnTerms":{"type":"object","properties":{"accepted":{"type":"boolean"},"periodDays":{"minimum":0,"type":"integer"},"shippingCostPayer":{"anyOf":[{"type":"string","enum":["buyer"]},{"type":"string","enum":["seller"]}]},"refundMethod":{"type":"string"},"returnMethod":{"type":"string"}}},"paymentMethods":{"description":"WALLET | CREDIT_CARD | …","type":"array","items":{"type":"string"}},"conditionDescriptors":{"type":"array","items":{"type":"object","required":["name","values"],"properties":{"name":{"description":"e.g. 'Professional Grader' or 'Grade'.","type":"string"},"values":{"type":"array","items":{"type":"string"}}}}},"topRatedBuyingExperience":{"type":"boolean"},"authenticityGuarantee":{"type":"boolean"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"},"qualifiedPrograms":{"description":"EBAY_REFURBISHED | AUTHENTICITY_GUARANTEE | …","type":"array","items":{"type":"string"}},"lotSize":{"minimum":0,"type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"}}}},"total":{"minimum":0,"type":"integer"}}},"scheduled":{"type":"object","required":["items","total"],"properties":{"items":{"type":"array","items":{"type":"object","required":["id","marketplace","status","title","url","images"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["sold"]},{"type":"string","enum":["ended"]}]},"title":{"type":"string"},"url":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"condition":{"description":"Human-readable: 'New', 'Used', etc.","type":"string"},"conditionId":{"description":"eBay-style numeric id, kept for filtering.","type":"string"},"seller":{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"images":{"description":"Image URLs in seller-supplied order. First is primary.","type":"array","items":{"type":"string"}},"category":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"path":{"description":"Slash-joined breadcrumb if known.","type":"string"}}},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Flat key→value map.","type":"object","additionalProperties":true},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["auction"]},{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["best_offer"]}]}},"endsAt":{"description":"ISO 8601 listing end time.","type":"string"},"createdAt":{"description":"ISO 8601 listing creation time.","type":"string"},"watchCount":{"minimum":0,"type":"integer"},"bidding":{"type":"object","required":["count"],"properties":{"count":{"minimum":0,"type":"integer"},"currentBid":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"availableQuantity":{"minimum":0,"description":"Live stock remaining on the listing. Absent when eBay hides the count (e.g. 'More than 10 available') or for auctions.","type":"integer"},"soldQuantity":{"minimum":0,"description":"Rolling units shipped on this listing. Browse REST `estimatedSoldQuantity` for active, `totalSoldQuantity` for sold comps.","type":"integer"},"soldAt":{"description":"ISO 8601 sold/closed time.","type":"string"},"soldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","properties":{"cost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"free":{"type":"boolean"},"estimatedDeliveryFrom":{"type":"string"},"estimatedDeliveryTo":{"type":"string"},"shipsTo":{"type":"array","items":{"description":"Country codes, region names, or eBay region ids.","type":"string"}},"shipsToExcluded":{"type":"array","items":{"type":"string"}}}},"location":{"type":"object","properties":{"city":{"type":"string"},"region":{"type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"}}},"epid":{"description":"eBay catalog product id.","type":"string"},"gtin":{"description":"UPC / EAN / ISBN.","type":"string"},"mpn":{"description":"Manufacturer part number.","type":"string"},"groupId":{"type":"string"},"marketingPrice":{"type":"object","properties":{"originalPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountAmount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountPercentage":{"type":"string"},"priceTreatment":{"description":"STRIKETHROUGH | LIST_PRICE | MINIMUM_ADVERTISED_PRICE | MARKDOWN","type":"string"}}},"returnTerms":{"type":"object","properties":{"accepted":{"type":"boolean"},"periodDays":{"minimum":0,"type":"integer"},"shippingCostPayer":{"anyOf":[{"type":"string","enum":["buyer"]},{"type":"string","enum":["seller"]}]},"refundMethod":{"type":"string"},"returnMethod":{"type":"string"}}},"paymentMethods":{"description":"WALLET | CREDIT_CARD | …","type":"array","items":{"type":"string"}},"conditionDescriptors":{"type":"array","items":{"type":"object","required":["name","values"],"properties":{"name":{"description":"e.g. 'Professional Grader' or 'Grade'.","type":"string"},"values":{"type":"array","items":{"type":"string"}}}}},"topRatedBuyingExperience":{"type":"boolean"},"authenticityGuarantee":{"type":"boolean"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"},"qualifiedPrograms":{"description":"EBAY_REFURBISHED | AUTHENTICITY_GUARANTEE | …","type":"array","items":{"type":"string"}},"lotSize":{"minimum":0,"type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"}}}},"total":{"minimum":0,"type":"integer"}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Trading API failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MeSelling","tags":["Me"],"parameters":[],"summary":"Active + sold + unsold + scheduled listings (Trading GetMyeBaySelling)"}},"/v1/me/buying":{"get":{"responses":{"200":{"description":"Buying overview.","content":{"application/json":{"schema":{"type":"object","required":["bidding","watching","won"],"properties":{"bidding":{"type":"object","required":["items","total"],"properties":{"items":{"type":"array","items":{"type":"object","required":["id","marketplace","status","title","url","images"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["sold"]},{"type":"string","enum":["ended"]}]},"title":{"type":"string"},"url":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"condition":{"description":"Human-readable: 'New', 'Used', etc.","type":"string"},"conditionId":{"description":"eBay-style numeric id, kept for filtering.","type":"string"},"seller":{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"images":{"description":"Image URLs in seller-supplied order. First is primary.","type":"array","items":{"type":"string"}},"category":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"path":{"description":"Slash-joined breadcrumb if known.","type":"string"}}},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Flat key→value map.","type":"object","additionalProperties":true},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["auction"]},{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["best_offer"]}]}},"endsAt":{"description":"ISO 8601 listing end time.","type":"string"},"createdAt":{"description":"ISO 8601 listing creation time.","type":"string"},"watchCount":{"minimum":0,"type":"integer"},"bidding":{"type":"object","required":["count"],"properties":{"count":{"minimum":0,"type":"integer"},"currentBid":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"availableQuantity":{"minimum":0,"description":"Live stock remaining on the listing. Absent when eBay hides the count (e.g. 'More than 10 available') or for auctions.","type":"integer"},"soldQuantity":{"minimum":0,"description":"Rolling units shipped on this listing. Browse REST `estimatedSoldQuantity` for active, `totalSoldQuantity` for sold comps.","type":"integer"},"soldAt":{"description":"ISO 8601 sold/closed time.","type":"string"},"soldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","properties":{"cost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"free":{"type":"boolean"},"estimatedDeliveryFrom":{"type":"string"},"estimatedDeliveryTo":{"type":"string"},"shipsTo":{"type":"array","items":{"description":"Country codes, region names, or eBay region ids.","type":"string"}},"shipsToExcluded":{"type":"array","items":{"type":"string"}}}},"location":{"type":"object","properties":{"city":{"type":"string"},"region":{"type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"}}},"epid":{"description":"eBay catalog product id.","type":"string"},"gtin":{"description":"UPC / EAN / ISBN.","type":"string"},"mpn":{"description":"Manufacturer part number.","type":"string"},"groupId":{"type":"string"},"marketingPrice":{"type":"object","properties":{"originalPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountAmount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountPercentage":{"type":"string"},"priceTreatment":{"description":"STRIKETHROUGH | LIST_PRICE | MINIMUM_ADVERTISED_PRICE | MARKDOWN","type":"string"}}},"returnTerms":{"type":"object","properties":{"accepted":{"type":"boolean"},"periodDays":{"minimum":0,"type":"integer"},"shippingCostPayer":{"anyOf":[{"type":"string","enum":["buyer"]},{"type":"string","enum":["seller"]}]},"refundMethod":{"type":"string"},"returnMethod":{"type":"string"}}},"paymentMethods":{"description":"WALLET | CREDIT_CARD | …","type":"array","items":{"type":"string"}},"conditionDescriptors":{"type":"array","items":{"type":"object","required":["name","values"],"properties":{"name":{"description":"e.g. 'Professional Grader' or 'Grade'.","type":"string"},"values":{"type":"array","items":{"type":"string"}}}}},"topRatedBuyingExperience":{"type":"boolean"},"authenticityGuarantee":{"type":"boolean"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"},"qualifiedPrograms":{"description":"EBAY_REFURBISHED | AUTHENTICITY_GUARANTEE | …","type":"array","items":{"type":"string"}},"lotSize":{"minimum":0,"type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"}}}},"total":{"minimum":0,"type":"integer"}}},"watching":{"type":"object","required":["items","total"],"properties":{"items":{"type":"array","items":{"type":"object","required":["id","marketplace","status","title","url","images"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["sold"]},{"type":"string","enum":["ended"]}]},"title":{"type":"string"},"url":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"condition":{"description":"Human-readable: 'New', 'Used', etc.","type":"string"},"conditionId":{"description":"eBay-style numeric id, kept for filtering.","type":"string"},"seller":{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"images":{"description":"Image URLs in seller-supplied order. First is primary.","type":"array","items":{"type":"string"}},"category":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"path":{"description":"Slash-joined breadcrumb if known.","type":"string"}}},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Flat key→value map.","type":"object","additionalProperties":true},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["auction"]},{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["best_offer"]}]}},"endsAt":{"description":"ISO 8601 listing end time.","type":"string"},"createdAt":{"description":"ISO 8601 listing creation time.","type":"string"},"watchCount":{"minimum":0,"type":"integer"},"bidding":{"type":"object","required":["count"],"properties":{"count":{"minimum":0,"type":"integer"},"currentBid":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"availableQuantity":{"minimum":0,"description":"Live stock remaining on the listing. Absent when eBay hides the count (e.g. 'More than 10 available') or for auctions.","type":"integer"},"soldQuantity":{"minimum":0,"description":"Rolling units shipped on this listing. Browse REST `estimatedSoldQuantity` for active, `totalSoldQuantity` for sold comps.","type":"integer"},"soldAt":{"description":"ISO 8601 sold/closed time.","type":"string"},"soldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","properties":{"cost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"free":{"type":"boolean"},"estimatedDeliveryFrom":{"type":"string"},"estimatedDeliveryTo":{"type":"string"},"shipsTo":{"type":"array","items":{"description":"Country codes, region names, or eBay region ids.","type":"string"}},"shipsToExcluded":{"type":"array","items":{"type":"string"}}}},"location":{"type":"object","properties":{"city":{"type":"string"},"region":{"type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"}}},"epid":{"description":"eBay catalog product id.","type":"string"},"gtin":{"description":"UPC / EAN / ISBN.","type":"string"},"mpn":{"description":"Manufacturer part number.","type":"string"},"groupId":{"type":"string"},"marketingPrice":{"type":"object","properties":{"originalPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountAmount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountPercentage":{"type":"string"},"priceTreatment":{"description":"STRIKETHROUGH | LIST_PRICE | MINIMUM_ADVERTISED_PRICE | MARKDOWN","type":"string"}}},"returnTerms":{"type":"object","properties":{"accepted":{"type":"boolean"},"periodDays":{"minimum":0,"type":"integer"},"shippingCostPayer":{"anyOf":[{"type":"string","enum":["buyer"]},{"type":"string","enum":["seller"]}]},"refundMethod":{"type":"string"},"returnMethod":{"type":"string"}}},"paymentMethods":{"description":"WALLET | CREDIT_CARD | …","type":"array","items":{"type":"string"}},"conditionDescriptors":{"type":"array","items":{"type":"object","required":["name","values"],"properties":{"name":{"description":"e.g. 'Professional Grader' or 'Grade'.","type":"string"},"values":{"type":"array","items":{"type":"string"}}}}},"topRatedBuyingExperience":{"type":"boolean"},"authenticityGuarantee":{"type":"boolean"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"},"qualifiedPrograms":{"description":"EBAY_REFURBISHED | AUTHENTICITY_GUARANTEE | …","type":"array","items":{"type":"string"}},"lotSize":{"minimum":0,"type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"}}}},"total":{"minimum":0,"type":"integer"}}},"won":{"type":"object","required":["items","total"],"properties":{"items":{"type":"array","items":{"type":"object","required":["id","marketplace","status","title","url","images"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["sold"]},{"type":"string","enum":["ended"]}]},"title":{"type":"string"},"url":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"condition":{"description":"Human-readable: 'New', 'Used', etc.","type":"string"},"conditionId":{"description":"eBay-style numeric id, kept for filtering.","type":"string"},"seller":{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"images":{"description":"Image URLs in seller-supplied order. First is primary.","type":"array","items":{"type":"string"}},"category":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"path":{"description":"Slash-joined breadcrumb if known.","type":"string"}}},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Flat key→value map.","type":"object","additionalProperties":true},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["auction"]},{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["best_offer"]}]}},"endsAt":{"description":"ISO 8601 listing end time.","type":"string"},"createdAt":{"description":"ISO 8601 listing creation time.","type":"string"},"watchCount":{"minimum":0,"type":"integer"},"bidding":{"type":"object","required":["count"],"properties":{"count":{"minimum":0,"type":"integer"},"currentBid":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"availableQuantity":{"minimum":0,"description":"Live stock remaining on the listing. Absent when eBay hides the count (e.g. 'More than 10 available') or for auctions.","type":"integer"},"soldQuantity":{"minimum":0,"description":"Rolling units shipped on this listing. Browse REST `estimatedSoldQuantity` for active, `totalSoldQuantity` for sold comps.","type":"integer"},"soldAt":{"description":"ISO 8601 sold/closed time.","type":"string"},"soldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","properties":{"cost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"free":{"type":"boolean"},"estimatedDeliveryFrom":{"type":"string"},"estimatedDeliveryTo":{"type":"string"},"shipsTo":{"type":"array","items":{"description":"Country codes, region names, or eBay region ids.","type":"string"}},"shipsToExcluded":{"type":"array","items":{"type":"string"}}}},"location":{"type":"object","properties":{"city":{"type":"string"},"region":{"type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"}}},"epid":{"description":"eBay catalog product id.","type":"string"},"gtin":{"description":"UPC / EAN / ISBN.","type":"string"},"mpn":{"description":"Manufacturer part number.","type":"string"},"groupId":{"type":"string"},"marketingPrice":{"type":"object","properties":{"originalPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountAmount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountPercentage":{"type":"string"},"priceTreatment":{"description":"STRIKETHROUGH | LIST_PRICE | MINIMUM_ADVERTISED_PRICE | MARKDOWN","type":"string"}}},"returnTerms":{"type":"object","properties":{"accepted":{"type":"boolean"},"periodDays":{"minimum":0,"type":"integer"},"shippingCostPayer":{"anyOf":[{"type":"string","enum":["buyer"]},{"type":"string","enum":["seller"]}]},"refundMethod":{"type":"string"},"returnMethod":{"type":"string"}}},"paymentMethods":{"description":"WALLET | CREDIT_CARD | …","type":"array","items":{"type":"string"}},"conditionDescriptors":{"type":"array","items":{"type":"object","required":["name","values"],"properties":{"name":{"description":"e.g. 'Professional Grader' or 'Grade'.","type":"string"},"values":{"type":"array","items":{"type":"string"}}}}},"topRatedBuyingExperience":{"type":"boolean"},"authenticityGuarantee":{"type":"boolean"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"},"qualifiedPrograms":{"description":"EBAY_REFURBISHED | AUTHENTICITY_GUARANTEE | …","type":"array","items":{"type":"string"}},"lotSize":{"minimum":0,"type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"}}}},"total":{"minimum":0,"type":"integer"}}},"lost":{"type":"object","required":["items","total"],"properties":{"items":{"type":"array","items":{"type":"object","required":["id","marketplace","status","title","url","images"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["sold"]},{"type":"string","enum":["ended"]}]},"title":{"type":"string"},"url":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"condition":{"description":"Human-readable: 'New', 'Used', etc.","type":"string"},"conditionId":{"description":"eBay-style numeric id, kept for filtering.","type":"string"},"seller":{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"images":{"description":"Image URLs in seller-supplied order. First is primary.","type":"array","items":{"type":"string"}},"category":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"path":{"description":"Slash-joined breadcrumb if known.","type":"string"}}},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Flat key→value map.","type":"object","additionalProperties":true},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["auction"]},{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["best_offer"]}]}},"endsAt":{"description":"ISO 8601 listing end time.","type":"string"},"createdAt":{"description":"ISO 8601 listing creation time.","type":"string"},"watchCount":{"minimum":0,"type":"integer"},"bidding":{"type":"object","required":["count"],"properties":{"count":{"minimum":0,"type":"integer"},"currentBid":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"availableQuantity":{"minimum":0,"description":"Live stock remaining on the listing. Absent when eBay hides the count (e.g. 'More than 10 available') or for auctions.","type":"integer"},"soldQuantity":{"minimum":0,"description":"Rolling units shipped on this listing. Browse REST `estimatedSoldQuantity` for active, `totalSoldQuantity` for sold comps.","type":"integer"},"soldAt":{"description":"ISO 8601 sold/closed time.","type":"string"},"soldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","properties":{"cost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"free":{"type":"boolean"},"estimatedDeliveryFrom":{"type":"string"},"estimatedDeliveryTo":{"type":"string"},"shipsTo":{"type":"array","items":{"description":"Country codes, region names, or eBay region ids.","type":"string"}},"shipsToExcluded":{"type":"array","items":{"type":"string"}}}},"location":{"type":"object","properties":{"city":{"type":"string"},"region":{"type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"}}},"epid":{"description":"eBay catalog product id.","type":"string"},"gtin":{"description":"UPC / EAN / ISBN.","type":"string"},"mpn":{"description":"Manufacturer part number.","type":"string"},"groupId":{"type":"string"},"marketingPrice":{"type":"object","properties":{"originalPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountAmount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountPercentage":{"type":"string"},"priceTreatment":{"description":"STRIKETHROUGH | LIST_PRICE | MINIMUM_ADVERTISED_PRICE | MARKDOWN","type":"string"}}},"returnTerms":{"type":"object","properties":{"accepted":{"type":"boolean"},"periodDays":{"minimum":0,"type":"integer"},"shippingCostPayer":{"anyOf":[{"type":"string","enum":["buyer"]},{"type":"string","enum":["seller"]}]},"refundMethod":{"type":"string"},"returnMethod":{"type":"string"}}},"paymentMethods":{"description":"WALLET | CREDIT_CARD | …","type":"array","items":{"type":"string"}},"conditionDescriptors":{"type":"array","items":{"type":"object","required":["name","values"],"properties":{"name":{"description":"e.g. 'Professional Grader' or 'Grade'.","type":"string"},"values":{"type":"array","items":{"type":"string"}}}}},"topRatedBuyingExperience":{"type":"boolean"},"authenticityGuarantee":{"type":"boolean"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"},"qualifiedPrograms":{"description":"EBAY_REFURBISHED | AUTHENTICITY_GUARANTEE | …","type":"array","items":{"type":"string"}},"lotSize":{"minimum":0,"type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"}}}},"total":{"minimum":0,"type":"integer"}}},"bestOffers":{"type":"object","required":["items","total"],"properties":{"items":{"type":"array","items":{"type":"object","required":["id","marketplace","status","title","url","images"],"properties":{"id":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"status":{"anyOf":[{"type":"string","enum":["active"]},{"type":"string","enum":["sold"]},{"type":"string","enum":["ended"]}]},"title":{"type":"string"},"url":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"condition":{"description":"Human-readable: 'New', 'Used', etc.","type":"string"},"conditionId":{"description":"eBay-style numeric id, kept for filtering.","type":"string"},"seller":{"type":"object","required":["username"],"properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"images":{"description":"Image URLs in seller-supplied order. First is primary.","type":"array","items":{"type":"string"}},"category":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"path":{"description":"Slash-joined breadcrumb if known.","type":"string"}}},"aspects":{"description":"Item specifics — Brand/Model/Size/etc. Flat key→value map.","type":"object","additionalProperties":true},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["auction"]},{"type":"string","enum":["fixed_price"]},{"type":"string","enum":["best_offer"]}]}},"endsAt":{"description":"ISO 8601 listing end time.","type":"string"},"createdAt":{"description":"ISO 8601 listing creation time.","type":"string"},"watchCount":{"minimum":0,"type":"integer"},"bidding":{"type":"object","required":["count"],"properties":{"count":{"minimum":0,"type":"integer"},"currentBid":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}}}},"availableQuantity":{"minimum":0,"description":"Live stock remaining on the listing. Absent when eBay hides the count (e.g. 'More than 10 available') or for auctions.","type":"integer"},"soldQuantity":{"minimum":0,"description":"Rolling units shipped on this listing. Browse REST `estimatedSoldQuantity` for active, `totalSoldQuantity` for sold comps.","type":"integer"},"soldAt":{"description":"ISO 8601 sold/closed time.","type":"string"},"soldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"shipping":{"type":"object","properties":{"cost":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"free":{"type":"boolean"},"estimatedDeliveryFrom":{"type":"string"},"estimatedDeliveryTo":{"type":"string"},"shipsTo":{"type":"array","items":{"description":"Country codes, region names, or eBay region ids.","type":"string"}},"shipsToExcluded":{"type":"array","items":{"type":"string"}}}},"location":{"type":"object","properties":{"city":{"type":"string"},"region":{"type":"string"},"postalCode":{"type":"string"},"country":{"minLength":2,"maxLength":2,"type":"string"}}},"epid":{"description":"eBay catalog product id.","type":"string"},"gtin":{"description":"UPC / EAN / ISBN.","type":"string"},"mpn":{"description":"Manufacturer part number.","type":"string"},"groupId":{"type":"string"},"marketingPrice":{"type":"object","properties":{"originalPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountAmount":{"type":"object","required":["value","currency"],"properties":{"value":{"description":"Amount in minor units (cents for USD, etc.)","type":"integer"},"currency":{"description":"ISO 4217 currency code","minLength":3,"maxLength":3,"type":"string"}}},"discountPercentage":{"type":"string"},"priceTreatment":{"description":"STRIKETHROUGH | LIST_PRICE | MINIMUM_ADVERTISED_PRICE | MARKDOWN","type":"string"}}},"returnTerms":{"type":"object","properties":{"accepted":{"type":"boolean"},"periodDays":{"minimum":0,"type":"integer"},"shippingCostPayer":{"anyOf":[{"type":"string","enum":["buyer"]},{"type":"string","enum":["seller"]}]},"refundMethod":{"type":"string"},"returnMethod":{"type":"string"}}},"paymentMethods":{"description":"WALLET | CREDIT_CARD | …","type":"array","items":{"type":"string"}},"conditionDescriptors":{"type":"array","items":{"type":"object","required":["name","values"],"properties":{"name":{"description":"e.g. 'Professional Grader' or 'Grade'.","type":"string"},"values":{"type":"array","items":{"type":"string"}}}}},"topRatedBuyingExperience":{"type":"boolean"},"authenticityGuarantee":{"type":"boolean"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"},"qualifiedPrograms":{"description":"EBAY_REFURBISHED | AUTHENTICITY_GUARANTEE | …","type":"array","items":{"type":"string"}},"lotSize":{"minimum":0,"type":"integer"},"quantityLimitPerBuyer":{"minimum":1,"type":"integer"}}}},"total":{"minimum":0,"type":"integer"}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Trading API failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MeBuying","tags":["Me"],"parameters":[],"summary":"Bidding + watching + won + lost (Trading GetMyeBayBuying)"}},"/v1/me/quota":{"get":{"responses":{"200":{"description":"Quota.","content":{"application/json":{"schema":{"type":"object","required":["apiQuota","userQuota"],"properties":{"apiQuota":{"description":"App-wide rate limits (rate_limit endpoint).","type":"array","items":{"type":"object","required":["apiContext","apiName","apiVersion","resources"],"properties":{"apiContext":{"description":"buy | sell | commerce | developer | tradingapi.","type":"string"},"apiName":{"type":"string"},"apiVersion":{"type":"string"},"resources":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"description":"API method name.","type":"string"},"limit":{"description":"Calls allowed in the current window.","type":"integer"},"remaining":{"description":"Calls left in the current window.","type":"integer"},"reset":{"description":"ISO 8601 — when the window rolls over.","type":"string"},"timeWindow":{"description":"Seconds in the current window.","type":"integer"}}}}}}},"userQuota":{"description":"Per-user rate limits (user_rate_limit endpoint).","type":"array","items":{"type":"object","required":["apiContext","apiName","apiVersion","resources"],"properties":{"apiContext":{"description":"buy | sell | commerce | developer | tradingapi.","type":"string"},"apiName":{"type":"string"},"apiVersion":{"type":"string"},"resources":{"type":"array","items":{"type":"object","required":["name"],"properties":{"name":{"description":"API method name.","type":"string"},"limit":{"description":"Calls allowed in the current window.","type":"integer"},"remaining":{"description":"Calls left in the current window.","type":"integer"},"reset":{"description":"ISO 8601 — when the window rolls over.","type":"string"},"timeWindow":{"description":"Seconds in the current window.","type":"integer"}}}}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MeQuota","tags":["Me"],"parameters":[],"summary":"API rate-limit budget (Developer Analytics)","description":"Combines `/developer/analytics/v1_beta/rate_limit` (app-wide) and `/user_rate_limit` (per-user). Useful for agents to know how much budget they have left in the current window before bursting."}},"/v1/me/programs":{"get":{"responses":{"200":{"description":"Programs.","content":{"application/json":{"schema":{"type":"object","required":["programs"],"properties":{"programs":{"type":"array","items":{"type":"object","required":["programType"],"properties":{"programType":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MePrograms","tags":["Me"],"parameters":[],"summary":"List seller programs the caller is opted in to"}},"/v1/me/programs/opt-in":{"post":{"responses":{"200":{"description":"Acknowledged.","content":{"application/json":{"schema":{"type":"object","required":["programType","ok"],"properties":{"programType":{"type":"string"},"ok":{"type":"boolean"}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1MeProgramsOpt-in","tags":["Me"],"parameters":[],"summary":"Opt in to a seller program (managed payments, etc.)","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["programType"],"properties":{"programType":{"anyOf":[{"type":"string","enum":["SELLING_POLICY_MANAGEMENT"]},{"type":"string","enum":["OUT_OF_STOCK_CONTROL"]},{"type":"string","enum":["PARTNER_MOTORS_DEALER"]},{"type":"string","enum":["EBAY_PLUS_PROGRAM"]}]}}}}}}}},"/v1/me/programs/opt-out":{"post":{"responses":{"200":{"description":"Acknowledged.","content":{"application/json":{"schema":{"type":"object","required":["programType","ok"],"properties":{"programType":{"type":"string"},"ok":{"type":"boolean"}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1MeProgramsOpt-out","tags":["Me"],"parameters":[],"summary":"Opt out of a seller program","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["programType"],"properties":{"programType":{"anyOf":[{"type":"string","enum":["SELLING_POLICY_MANAGEMENT"]},{"type":"string","enum":["OUT_OF_STOCK_CONTROL"]},{"type":"string","enum":["PARTNER_MOTORS_DEALER"]},{"type":"string","enum":["EBAY_PLUS_PROGRAM"]}]}}}}}}}},"/v1/me/ebay/connect":{"get":{"responses":{"302":{"description":"Redirect to eBay authorize."},"400":{"description":"Caller has no active API key — create one first.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"eBay OAuth env not configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MeEbayConnect","tags":["Dashboard"],"parameters":[],"summary":"Start eBay OAuth handshake (dashboard / session flow)","description":"302 to eBay's consent page. Callback returns the browser to APP_URL/dashboard."},"delete":{"responses":{"200":{"description":"Local bindings removed."},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1MeEbayConnect","tags":["Dashboard"],"parameters":[],"summary":"Disconnect eBay for the signed-in user","description":"Drops every userEbayOauth row whose api_key belongs to this user. Tokens are NOT revoked at eBay."}},"/v1/me/ebay/status":{"get":{"responses":{"200":{"description":"Connection state for this user."},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MeEbayStatus","tags":["Dashboard"],"parameters":[],"summary":"eBay connection status for the signed-in user"}},"/v1/me/devices":{"get":{"responses":{"200":{"description":"Devices.","content":{"application/json":{"schema":{"type":"object","required":["devices"],"properties":{"devices":{"type":"array","items":{"type":"object","required":["id","deviceName","tokenPrefix","ebayLoggedIn","ebayUserName","createdAt","lastSeenAt"],"properties":{"id":{"type":"string"},"deviceName":{"anyOf":[{"type":"string","nullable":true}]},"tokenPrefix":{"type":"string"},"ebayLoggedIn":{"type":"boolean"},"ebayUserName":{"anyOf":[{"type":"string","nullable":true}]},"createdAt":{"format":"date-time","type":"string"},"lastSeenAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}}}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MeDevices","tags":["Dashboard"],"parameters":[],"summary":"List active bridge tokens (connected devices) for the caller","description":"One row per device that completed the `/extension/connect` handshake. Drives the dashboard's Connected Devices panel. Plaintext token is never returned here — only metadata (name, prefix, last seen, eBay login state)."},"post":{"responses":{"201":{"description":"Device connected; credentials returned (one-shot).","content":{"application/json":{"schema":{"type":"object","required":["device","apiKey","bridgeToken"],"properties":{"device":{"type":"object","required":["id","deviceName","tokenPrefix","ebayLoggedIn","ebayUserName","createdAt","lastSeenAt"],"properties":{"id":{"type":"string"},"deviceName":{"anyOf":[{"type":"string","nullable":true}]},"tokenPrefix":{"type":"string"},"ebayLoggedIn":{"type":"boolean"},"ebayUserName":{"anyOf":[{"type":"string","nullable":true}]},"createdAt":{"format":"date-time","type":"string"},"lastSeenAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}},"apiKey":{"type":"object","required":["id","plaintext","tier"],"properties":{"id":{"type":"string"},"plaintext":{"type":"string"},"tier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]}}},"bridgeToken":{"type":"object","required":["id","plaintext","prefix"],"properties":{"id":{"type":"string"},"plaintext":{"type":"string"},"prefix":{"type":"string"}}}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1MeDevices","tags":["Dashboard"],"parameters":[],"summary":"Connect a new device — issues bridgeToken (and an api key if absent)","description":"Called from the `/extension/connect` page after the user clicks Connect. Resolves the user's most recent active api key, auto-issuing a default one when the user has none, and mints a fresh bridge token bound to that key. Both plaintext values are returned exactly once; the page hands them off to the Chrome extension via `chrome.runtime.sendMessage` and discards them.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"deviceName":{"minLength":1,"maxLength":80,"type":"string"}}}}}}}},"/v1/me/devices/{id}":{"delete":{"responses":{"200":{"description":"Revoked.","content":{"application/json":{"schema":{"type":"object","required":["id","revoked"],"properties":{"id":{"type":"string"},"revoked":{"type":"boolean"}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Device not found or not owned by caller.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1MeDevicesById","tags":["Dashboard"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Revoke a connected device's bridge token","description":"Idempotent — calling on an already-revoked or missing-for-this-user token returns 404. Does not revoke the parent api key (other devices keep working)."}},"/v1/me":{"get":{"responses":{"200":{"description":"User profile.","content":{"application/json":{"schema":{"type":"object","required":["id","email","emailVerified","name","image","tier","role","usage","currentTermsVersion","termsAcceptedAt","termsAcceptedVersion"],"properties":{"id":{"type":"string"},"email":{"format":"email","type":"string"},"emailVerified":{"type":"boolean"},"name":{"type":"string"},"image":{"anyOf":[{"type":"string","nullable":true}]},"tier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]},"role":{"anyOf":[{"type":"string","enum":["user"]},{"type":"string","enum":["admin"]}]},"usage":{"type":"object","required":["creditsUsed","creditsLimit","creditsRemaining","bonusCredits","resetAt","effectiveTier"],"properties":{"creditsUsed":{"type":"integer"},"creditsLimit":{"type":"integer"},"creditsRemaining":{"type":"integer"},"bonusCredits":{"default":0,"type":"integer"},"resetAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"effectiveTier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]}}},"currentTermsVersion":{"type":"string"},"termsAcceptedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"termsAcceptedVersion":{"anyOf":[{"type":"string","nullable":true}]}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Auth not configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1Me","tags":["Keys"],"parameters":[],"summary":"Current user (session) + monthly usage"}},"/v1/me/terms-acceptance":{"post":{"responses":{"200":{"description":"Acceptance recorded.","content":{"application/json":{"schema":{"type":"object","required":["acceptedAt","version"],"properties":{"acceptedAt":{"format":"date-time","type":"string"},"version":{"type":"string"}}}}}},"400":{"description":"Posted version does not match current Terms version.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1MeTerms-acceptance","tags":["Keys"],"parameters":[],"summary":"Record clickwrap acceptance of the current Terms version","description":"Persists termsAcceptedAt = now, termsVersion = the version posted, termsAcceptedIp from the request. Used by the signup flow (immediately after autoSignIn) and by the dashboard's re-consent gate (for OAuth users + version bumps).","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["version"],"properties":{"version":{"minLength":4,"maxLength":32,"type":"string"}}}}}}}},"/v1/me/account":{"delete":{"responses":{"200":{"description":"Account deleted.","content":{"application/json":{"schema":{"type":"object","required":["deletedAt","userId"],"properties":{"deletedAt":{"format":"date-time","type":"string"},"userId":{"type":"string"}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1MeAccount","tags":["Keys"],"parameters":[],"summary":"Delete the current user account","description":"Permanently deletes the signed-in user. Cascades through user-owned tables (sessions, accounts, API keys, eBay OAuth, bridge tokens, forwarder inventory, expense events, webhook endpoints). Audit-trail rows (usage_events, marketplace_notifications, listing_observations) are preserved per the Privacy Policy with userId/apiKeyId set to null. Stripe customer is closed best-effort if present. Per-item cache removal goes via /v1/takedown."}},"/v1/me/usage":{"get":{"responses":{"200":{"description":"Usage.","content":{"application/json":{"schema":{"type":"object","required":["creditsUsed","creditsLimit","creditsRemaining","bonusCredits","resetAt","effectiveTier"],"properties":{"creditsUsed":{"type":"integer"},"creditsLimit":{"type":"integer"},"creditsRemaining":{"type":"integer"},"bonusCredits":{"default":0,"type":"integer"},"resetAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"effectiveTier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MeUsage","tags":["Keys"],"parameters":[],"summary":"Monthly usage snapshot"}},"/v1/me/usage/breakdown":{"get":{"responses":{"200":{"description":"Breakdown rows ordered by call count (descending)."},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MeUsageBreakdown","tags":["Keys"],"parameters":[],"summary":"Per-endpoint usage breakdown for the current calendar month (UTC)","description":"Aggregates usage_events by endpoint over the user's keys. Drives the dashboard's Usage chart."}},"/v1/me/usage/recent":{"get":{"responses":{"200":{"description":"Recent events."},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MeUsageRecent","tags":["Keys"],"parameters":[],"summary":"Recent metered API events for the signed-in user","description":"Latest usage_events rows tied to keys owned by the user. Drives the dashboard's Activity panel."}},"/v1/me/keys":{"get":{"responses":{"200":{"description":"Keys.","content":{"application/json":{"schema":{"type":"object","required":["keys"],"properties":{"keys":{"type":"array","items":{"type":"object","required":["id","name","prefix","suffix","tier","createdAt","lastUsedAt"],"properties":{"id":{"type":"string"},"name":{"anyOf":[{"type":"string","nullable":true}]},"prefix":{"type":"string"},"suffix":{"anyOf":[{"type":"string","nullable":true}]},"tier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]},"createdAt":{"format":"date-time","type":"string"},"lastUsedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}}}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MeKeys","tags":["Keys"],"parameters":[],"summary":"List the caller's API keys"},"post":{"responses":{"201":{"description":"Key created.","content":{"application/json":{"schema":{"type":"object","required":["id","tier","prefix","suffix","plaintext","notice"],"properties":{"id":{"type":"string"},"tier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]},"prefix":{"type":"string"},"suffix":{"type":"string"},"plaintext":{"type":"string"},"notice":{"type":"string"}}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1MeKeys","tags":["Keys"],"parameters":[],"summary":"Issue a new named key for the caller","description":"The plaintext is returned exactly once. Store it immediately.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"maxLength":80,"type":"string"}}}}}}}},"/v1/me/keys/{id}/reveal":{"post":{"responses":{"200":{"description":"Plaintext.","content":{"application/json":{"schema":{"type":"object","required":["id","plaintext"],"properties":{"id":{"type":"string"},"plaintext":{"type":"string"}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Key not found or not owned by caller.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"410":{"description":"Legacy key without stored plaintext — recreate to reveal.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Plaintext storage not configured on this host.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1MeKeysByIdReveal","tags":["Keys"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Decrypt + return plaintext for one of the caller's keys","description":"Plaintext is decrypted from the at-rest ciphertext stored at issue time. Keys created before plaintext storage was wired return 410 (recreate to make revealable). Returns 503 when KEYS_ENCRYPTION_KEY is unset in production."}},"/v1/me/keys/{id}":{"delete":{"responses":{"200":{"description":"Revoked.","content":{"application/json":{"schema":{"type":"object","required":["id","revoked"],"properties":{"id":{"type":"string"},"revoked":{"type":"boolean"}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Key not found or not owned by caller.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1MeKeysById","tags":["Keys"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Revoke one of the caller's keys"}},"/v1/me/permissions":{"get":{"responses":{"200":{"description":"Permission map.","content":{"application/json":{"schema":{"type":"object","required":["ebayConnected","ebayUserName","ebayUserId","scopes"],"properties":{"ebayConnected":{"type":"boolean"},"ebayUserName":{"anyOf":[{"type":"string","nullable":true}]},"ebayUserId":{"anyOf":[{"type":"string","nullable":true}]},"scopes":{"type":"object","required":["browse","marketplaceInsights","inventory","fulfillment","finance","order","bidding"],"properties":{"browse":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["unavailable"]}]},"marketplaceInsights":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["unavailable"]}]},"inventory":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["unavailable"]}]},"fulfillment":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["unavailable"]}]},"finance":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["unavailable"]}]},"order":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["unavailable"]}]},"bidding":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["unavailable"]}]}}}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1MePermissions","tags":["Dashboard"],"parameters":[],"summary":"Per-scope permission status for the signed-in user","description":"Tells the dashboard (and SDK consumers) what they can call right now: `ok` works, `scrape` is served via the scrape transport (REST not approved/wired or resource is scrape-only), `needs_oauth` means the user must connect eBay, `approval_pending` means eBay program approval pending, `unavailable` means the host has no env wired (self-host case)."}},"/v1/keys/me":{"get":{"responses":{"200":{"description":"Key info.","content":{"application/json":{"schema":{"type":"object","required":["id","tier","prefix","suffix","name","ownerEmail","createdAt","lastUsedAt","usage"],"properties":{"id":{"type":"string"},"tier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]},"prefix":{"type":"string"},"suffix":{"anyOf":[{"type":"string","nullable":true}]},"name":{"anyOf":[{"type":"string","nullable":true}]},"ownerEmail":{"anyOf":[{"format":"email","type":"string","nullable":true}]},"createdAt":{"format":"date-time","type":"string"},"lastUsedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"usage":{"type":"object","required":["creditsUsed","creditsLimit","creditsRemaining","bonusCredits","resetAt","effectiveTier"],"properties":{"creditsUsed":{"type":"integer"},"creditsLimit":{"type":"integer"},"creditsRemaining":{"type":"integer"},"bonusCredits":{"default":0,"type":"integer"},"resetAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"effectiveTier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]}}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1KeysMe","tags":["Keys"],"parameters":[],"summary":"Inspect calling key + usage"}},"/v1/keys/revoke":{"post":{"responses":{"200":{"description":"Revoked.","content":{"application/json":{"schema":{"type":"object","required":["id","revoked"],"properties":{"id":{"type":"string"},"revoked":{"type":"boolean"}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1KeysRevoke","tags":["Keys"],"parameters":[],"summary":"Revoke calling key"}},"/v1/keys/permissions":{"get":{"responses":{"200":{"description":"Permission map.","content":{"application/json":{"schema":{"type":"object","required":["ebayConnected","ebayUserName","ebayUserId","scopes"],"properties":{"ebayConnected":{"type":"boolean"},"ebayUserName":{"anyOf":[{"type":"string","nullable":true}]},"ebayUserId":{"anyOf":[{"type":"string","nullable":true}]},"scopes":{"type":"object","required":["browse","marketplaceInsights","inventory","fulfillment","finance","order","bidding"],"properties":{"browse":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["unavailable"]}]},"marketplaceInsights":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["unavailable"]}]},"inventory":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["unavailable"]}]},"fulfillment":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["unavailable"]}]},"finance":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["unavailable"]}]},"order":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["unavailable"]}]},"bidding":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["unavailable"]}]}}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1KeysPermissions","tags":["Keys"],"parameters":[],"summary":"Per-scope permission status for the calling key","description":"Same response shape as /v1/me/permissions, but auth'd via the API key so SDK / agent code can preflight without going through the dashboard session. Reflects the eBay binding tied to this specific key (not other keys owned by the same user)."}},"/v1/billing/checkout":{"post":{"responses":{"200":{"description":"Stripe-hosted checkout URL.","content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"format":"uri","type":"string"}}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Stripe env not configured on this api instance.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1BillingCheckout","tags":["Billing"],"parameters":[],"summary":"Create a Stripe Checkout Session","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["tier"],"properties":{"tier":{"anyOf":[{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]}}}}}}}},"/v1/billing/portal":{"post":{"responses":{"200":{"description":"Portal URL.","content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"format":"uri","type":"string"}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"User has no Stripe customer (upgrade first).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Stripe env not configured on this api instance.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1BillingPortal","tags":["Billing"],"parameters":[],"summary":"Open the Stripe Customer Portal"}},"/v1/billing/invoices":{"get":{"responses":{"200":{"description":"History.","content":{"application/json":{"schema":{"type":"object","required":["transactions"],"properties":{"transactions":{"type":"array","items":{"type":"object","required":["id","type","number","createdAt","amountCents","amountDisplay","status","downloadUrl"],"properties":{"id":{"type":"string"},"type":{"anyOf":[{"type":"string","enum":["subscription"]},{"type":"string","enum":["top_up"]}]},"number":{"anyOf":[{"type":"string","nullable":true}]},"createdAt":{"format":"date-time","type":"string"},"amountCents":{"type":"integer"},"amountDisplay":{"type":"string"},"status":{"anyOf":[{"type":"string","enum":["paid"]},{"type":"string","enum":["open"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["refunded"]},{"type":"string","enum":["void"]}]},"downloadUrl":{"anyOf":[{"format":"uri","type":"string","nullable":true}]}}}}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Stripe env not configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1BillingInvoices","tags":["Billing"],"parameters":[],"summary":"Billing history — subscription invoices + top-up receipts","description":"Unified, newest-first list of Stripe invoices (recurring subscription bills) and standalone charges (auto-recharge top-ups). Each row carries a download URL — hosted invoice page for subscriptions, receipt URL for top-ups. Returns an empty list (200) for users without a Stripe customer record."}},"/v1/billing/quote":{"get":{"responses":{"200":{"description":"Quotes.","content":{"application/json":{"schema":{"type":"object","required":["tier","quotes"],"properties":{"tier":{"anyOf":[{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]},"quotes":{"type":"array","items":{"type":"object","required":["credits","priceCents","priceDisplay","perCreditUsd"],"properties":{"credits":{"type":"integer"},"priceCents":{"type":"integer"},"priceDisplay":{"type":"string"},"perCreditUsd":{"type":"number"}}}}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Free tier — upgrade first.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Stripe env not configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1BillingQuote","tags":["Billing"],"parameters":[],"summary":"Top-up price catalog for the caller's tier","description":"Lists each catalogued top-up amount (5k/25k/100k credits) with the price in cents at the caller's current tier. Use this to render the dashboard's \"Top up\" dropdown without doing tier math on the frontend."}},"/v1/billing/auto-recharge":{"get":{"responses":{"200":{"description":"Config.","content":{"application/json":{"schema":{"type":"object","required":["enabled","targetCredits","lastRechargedAt"],"properties":{"enabled":{"type":"boolean"},"targetCredits":{"anyOf":[{"minimum":500,"type":"integer","nullable":true}]},"lastRechargedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1BillingAuto-recharge","tags":["Billing"],"parameters":[],"summary":"Current auto-recharge config"},"put":{"responses":{"200":{"description":"Updated.","content":{"application/json":{"schema":{"type":"object","required":["enabled","targetCredits","lastRechargedAt"],"properties":{"enabled":{"type":"boolean"},"targetCredits":{"anyOf":[{"minimum":500,"type":"integer","nullable":true}]},"lastRechargedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}}}}},"400":{"description":"Target out of range for this tier.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Free tier or no card on file — subscribe first.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"putV1BillingAuto-recharge","tags":["Billing"],"parameters":[],"summary":"Enable/disable + configure auto-recharge","description":"Set a target balance — when credits drop below the target, the saved card is charged for the gap (Stripe-min-bounded). Target range is tier-specific: Hobby 500–10k, Standard 500–50k, Growth 500–200k. Free-tier callers and users with no Stripe customer (no card on file) get 403 — auto-recharge requires a saved card from a prior subscription checkout.","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object","required":["enabled"],"properties":{"enabled":{"type":"boolean","enum":[false]}}},{"type":"object","required":["enabled","targetCredits"],"properties":{"enabled":{"type":"boolean","enum":[true]},"targetCredits":{"minimum":500,"type":"integer"}}}]}}}}}},"/v1/billing/webhook":{"post":{"responses":{"200":{"description":"Event accepted.","content":{"application/json":{"schema":{"type":"object","required":["received"],"properties":{"received":{"type":"boolean"}}}}}},"400":{"description":"Missing or invalid signature.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Stripe env not configured on this api instance.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1BillingWebhook","tags":["Billing"],"parameters":[],"summary":"Stripe → flipagent webhook","description":"Stripe-signed; calls from anything else return 400.","security":[]}},"/v1/health":{"get":{"responses":{"200":{"description":"Service healthy.","content":{"application/json":{"schema":{"type":"object","required":["status","db","proxy","latencyMs","version","ts"],"properties":{"status":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["degraded"]}]},"db":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"error":{"type":"string"}}},"proxy":{"anyOf":[{"type":"string","enum":["configured"]},{"type":"string","enum":["missing"]}]},"latencyMs":{"type":"integer"},"version":{"type":"string"},"ts":{"format":"date-time","type":"string"}}}}}},"503":{"description":"Degraded — DB unreachable.","content":{"application/json":{"schema":{"type":"object","required":["status","db","proxy","latencyMs","version","ts"],"properties":{"status":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["degraded"]}]},"db":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"error":{"type":"string"}}},"proxy":{"anyOf":[{"type":"string","enum":["configured"]},{"type":"string","enum":["missing"]}]},"latencyMs":{"type":"integer"},"version":{"type":"string"},"ts":{"format":"date-time","type":"string"}}}}}}},"operationId":"getV1Health","tags":["System"],"parameters":[],"summary":"Liveness + Postgres ping","security":[]}},"/v1/capabilities":{"get":{"responses":{"200":{"description":"Capability map.","content":{"application/json":{"schema":{"type":"object","required":["client","marketplaces","forwarders","setup","checklist","generatedAt"],"properties":{"client":{"type":"object","required":["extensionPaired","deviceName","lastSeenAt"],"properties":{"extensionPaired":{"type":"boolean"},"deviceName":{"anyOf":[{"type":"string","nullable":true}]},"lastSeenAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}},"marketplaces":{"type":"object","required":["ebay_us"],"properties":{"ebay_us":{"type":"object","required":["search","sold","detail","evaluate","buy","sell"],"properties":{"search":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["needs_signin"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["unavailable"]}]},"sold":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["needs_signin"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["unavailable"]}]},"detail":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["needs_signin"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["unavailable"]}]},"evaluate":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["needs_signin"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["unavailable"]}]},"buy":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["needs_signin"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["unavailable"]}]},"sell":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["needs_signin"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["unavailable"]}]}}}}},"forwarders":{"type":"object","required":["planetexpress"],"properties":{"planetexpress":{"type":"object","required":["packages","consolidate","ship"],"properties":{"packages":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["needs_signin"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["unavailable"]}]},"consolidate":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["needs_signin"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["unavailable"]}]},"ship":{"anyOf":[{"type":"string","enum":["ok"]},{"type":"string","enum":["needs_signin"]},{"type":"string","enum":["needs_oauth"]},{"type":"string","enum":["approval_pending"]},{"type":"string","enum":["scrape"]},{"type":"string","enum":["unavailable"]}]}}}}},"setup":{"type":"object","required":["mode","apiBase","extensionInstall","dashboardUrl","forwarderSignup"],"properties":{"mode":{"anyOf":[{"type":"string","enum":["hosted"]},{"type":"string","enum":["self-hosted"]}]},"apiBase":{"type":"string"},"extensionInstall":{"type":"object","required":["from"],"properties":{"from":{"anyOf":[{"type":"string","enum":["chrome-web-store"]},{"type":"string","enum":["unpacked-dev-build"]}]},"url":{"description":"Web Store URL when mode=hosted.","type":"string"},"devBuildSteps":{"type":"array","items":{"description":"Shell commands when mode=self-hosted.","type":"string"}}}},"dashboardUrl":{"description":"Where the user manages keys / OAuth / billing.","type":"string"},"forwarderSignup":{"type":"object","required":["planetexpress"],"properties":{"planetexpress":{"format":"uri","type":"string"}}}}},"checklist":{"type":"object","required":["steps","nextStep","allRequiredDone"],"properties":{"steps":{"type":"array","items":{"type":"object","required":["id","status","required","title","description","unlocks"],"properties":{"id":{"anyOf":[{"type":"string","enum":["pair_extension"]},{"type":"string","enum":["ebay_signin"]},{"type":"string","enum":["seller_oauth"]}],"nullable":true},"status":{"anyOf":[{"type":"string","enum":["done"]},{"type":"string","enum":["active"]},{"type":"string","enum":["locked"]}]},"required":{"type":"boolean"},"title":{"type":"string"},"description":{"type":"string"},"unlocks":{"type":"array","items":{"type":"string"}}}}},"nextStep":{"anyOf":[{"anyOf":[{"type":"string","enum":["pair_extension"]},{"type":"string","enum":["ebay_signin"]},{"type":"string","enum":["seller_oauth"]}],"nullable":true}]},"allRequiredDone":{"type":"boolean"}}},"generatedAt":{"format":"date-time","type":"string"}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1Capabilities","tags":["Capabilities"],"parameters":[],"summary":"Per-marketplace capability map for this api key","description":"Returns which calls work (`ok`), which need user action (`needs_signin`, `needs_oauth`), which are gated by upstream approval (`approval_pending`), which are served by the scrape transport (`scrape`), and which are unconfigured on this host (`unavailable`). The agent's first-call discovery surface."}},"/v1/admin/stats":{"get":{"responses":{"200":{"description":"Counters.","content":{"application/json":{"schema":{"type":"object","required":["users","keys","grants","usage"],"properties":{"users":{"type":"object","required":["total","byTier","admins","signedUpLast30d"],"properties":{"total":{"type":"integer"},"byTier":{"type":"object","required":["free","hobby","standard","growth"],"properties":{"free":{"type":"integer"},"hobby":{"type":"integer"},"standard":{"type":"integer"},"growth":{"type":"integer"}}},"admins":{"type":"integer"},"signedUpLast30d":{"type":"integer"}}},"keys":{"type":"object","required":["active","revoked"],"properties":{"active":{"type":"integer"},"revoked":{"type":"integer"}}},"grants":{"type":"object","required":["active","activeBonusCredits","grantedLast30d"],"properties":{"active":{"type":"integer"},"activeBonusCredits":{"description":"Sum of credits_delta across active grants.","type":"integer"},"grantedLast30d":{"description":"Count of grants created in the last 30 days.","type":"integer"}}},"usage":{"type":"object","required":["creditsThisMonth","callsThisMonth"],"properties":{"creditsThisMonth":{"type":"integer"},"callsThisMonth":{"type":"integer"}}}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Admin role required.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1AdminStats","tags":["Admin"],"parameters":[],"summary":"High-level operator counters"}},"/v1/admin/users":{"get":{"responses":{"200":{"description":"Users.","content":{"application/json":{"schema":{"type":"object","required":["users","total","limit","offset"],"properties":{"users":{"type":"array","items":{"type":"object","required":["id","email","name","image","tier","role","emailVerified","activeKeyCount","bonusCredits","creditsUsed","creditsLimit","createdAt","lastActiveAt"],"properties":{"id":{"type":"string"},"email":{"format":"email","type":"string"},"name":{"type":"string"},"image":{"anyOf":[{"type":"string","nullable":true}]},"tier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]},"effectiveTier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]},"role":{"anyOf":[{"type":"string","enum":["user"]},{"type":"string","enum":["admin"]}]},"emailVerified":{"type":"boolean"},"subscriptionStatus":{"anyOf":[{"type":"string","nullable":true}]},"pastDueSince":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"autoRecharge":{"type":"object","required":["enabled","targetCredits","lastRechargedAt"],"properties":{"enabled":{"type":"boolean"},"targetCredits":{"anyOf":[{"type":"integer","nullable":true}]},"lastRechargedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}},"activeKeyCount":{"type":"integer"},"bonusCredits":{"type":"integer"},"creditsUsed":{"type":"integer"},"creditsLimit":{"type":"integer"},"createdAt":{"format":"date-time","type":"string"},"lastActiveAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}}},"total":{"description":"Total matching users (pre-pagination).","type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Admin role required.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1AdminUsers","tags":["Admin"],"parameters":[],"summary":"Search + paginate users"}},"/v1/admin/users/{id}":{"get":{"responses":{"200":{"description":"Detail.","content":{"application/json":{"schema":{"type":"object","required":["user","keys","grants","usage"],"properties":{"user":{"type":"object","required":["id","email","name","image","tier","role","emailVerified","activeKeyCount","bonusCredits","creditsUsed","creditsLimit","createdAt","lastActiveAt"],"properties":{"id":{"type":"string"},"email":{"format":"email","type":"string"},"name":{"type":"string"},"image":{"anyOf":[{"type":"string","nullable":true}]},"tier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]},"effectiveTier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]},"role":{"anyOf":[{"type":"string","enum":["user"]},{"type":"string","enum":["admin"]}]},"emailVerified":{"type":"boolean"},"subscriptionStatus":{"anyOf":[{"type":"string","nullable":true}]},"pastDueSince":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"autoRecharge":{"type":"object","required":["enabled","targetCredits","lastRechargedAt"],"properties":{"enabled":{"type":"boolean"},"targetCredits":{"anyOf":[{"type":"integer","nullable":true}]},"lastRechargedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}},"activeKeyCount":{"type":"integer"},"bonusCredits":{"type":"integer"},"creditsUsed":{"type":"integer"},"creditsLimit":{"type":"integer"},"createdAt":{"format":"date-time","type":"string"},"lastActiveAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}},"keys":{"type":"array","items":{"type":"object","required":["id","name","prefix","suffix","tier","createdAt","lastUsedAt","revokedAt"],"properties":{"id":{"type":"string"},"name":{"anyOf":[{"type":"string","nullable":true}]},"prefix":{"type":"string"},"suffix":{"anyOf":[{"type":"string","nullable":true}]},"tier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]},"createdAt":{"format":"date-time","type":"string"},"lastUsedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"revokedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}}},"grants":{"type":"array","items":{"type":"object","required":["id","userId","creditsDelta","reason","grantedByUserId","grantedByEmail","expiresAt","revokedAt","revokedByUserId","revokedByEmail","revokeReason","active","createdAt"],"properties":{"id":{"type":"string"},"userId":{"type":"string"},"creditsDelta":{"description":"Positive = bonus, negative = clawback. Stays in effect until revoked or expired.","type":"integer"},"reason":{"type":"string"},"grantedByUserId":{"anyOf":[{"type":"string","nullable":true}]},"grantedByEmail":{"anyOf":[{"format":"email","type":"string","nullable":true}]},"expiresAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"revokedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"revokedByUserId":{"anyOf":[{"type":"string","nullable":true}]},"revokedByEmail":{"anyOf":[{"format":"email","type":"string","nullable":true}]},"revokeReason":{"anyOf":[{"type":"string","nullable":true}]},"active":{"type":"boolean"},"createdAt":{"format":"date-time","type":"string"}}}},"usage":{"type":"object","required":["creditsUsed","creditsLimit","creditsRemaining","bonusCredits","resetAt"],"properties":{"creditsUsed":{"type":"integer"},"creditsLimit":{"type":"integer"},"creditsRemaining":{"type":"integer"},"bonusCredits":{"type":"integer"},"resetAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Admin role required.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"User not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1AdminUsersById","tags":["Admin"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Full user detail (keys + grants + usage)"},"patch":{"responses":{"200":{"description":"Detail.","content":{"application/json":{"schema":{"type":"object","required":["user","keys","grants","usage"],"properties":{"user":{"type":"object","required":["id","email","name","image","tier","role","emailVerified","activeKeyCount","bonusCredits","creditsUsed","creditsLimit","createdAt","lastActiveAt"],"properties":{"id":{"type":"string"},"email":{"format":"email","type":"string"},"name":{"type":"string"},"image":{"anyOf":[{"type":"string","nullable":true}]},"tier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]},"effectiveTier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]},"role":{"anyOf":[{"type":"string","enum":["user"]},{"type":"string","enum":["admin"]}]},"emailVerified":{"type":"boolean"},"subscriptionStatus":{"anyOf":[{"type":"string","nullable":true}]},"pastDueSince":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"autoRecharge":{"type":"object","required":["enabled","targetCredits","lastRechargedAt"],"properties":{"enabled":{"type":"boolean"},"targetCredits":{"anyOf":[{"type":"integer","nullable":true}]},"lastRechargedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}},"activeKeyCount":{"type":"integer"},"bonusCredits":{"type":"integer"},"creditsUsed":{"type":"integer"},"creditsLimit":{"type":"integer"},"createdAt":{"format":"date-time","type":"string"},"lastActiveAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}},"keys":{"type":"array","items":{"type":"object","required":["id","name","prefix","suffix","tier","createdAt","lastUsedAt","revokedAt"],"properties":{"id":{"type":"string"},"name":{"anyOf":[{"type":"string","nullable":true}]},"prefix":{"type":"string"},"suffix":{"anyOf":[{"type":"string","nullable":true}]},"tier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]},"createdAt":{"format":"date-time","type":"string"},"lastUsedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"revokedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}}},"grants":{"type":"array","items":{"type":"object","required":["id","userId","creditsDelta","reason","grantedByUserId","grantedByEmail","expiresAt","revokedAt","revokedByUserId","revokedByEmail","revokeReason","active","createdAt"],"properties":{"id":{"type":"string"},"userId":{"type":"string"},"creditsDelta":{"description":"Positive = bonus, negative = clawback. Stays in effect until revoked or expired.","type":"integer"},"reason":{"type":"string"},"grantedByUserId":{"anyOf":[{"type":"string","nullable":true}]},"grantedByEmail":{"anyOf":[{"format":"email","type":"string","nullable":true}]},"expiresAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"revokedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"revokedByUserId":{"anyOf":[{"type":"string","nullable":true}]},"revokedByEmail":{"anyOf":[{"format":"email","type":"string","nullable":true}]},"revokeReason":{"anyOf":[{"type":"string","nullable":true}]},"active":{"type":"boolean"},"createdAt":{"format":"date-time","type":"string"}}}},"usage":{"type":"object","required":["creditsUsed","creditsLimit","creditsRemaining","bonusCredits","resetAt"],"properties":{"creditsUsed":{"type":"integer"},"creditsLimit":{"type":"integer"},"creditsRemaining":{"type":"integer"},"bonusCredits":{"type":"integer"},"resetAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}}}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Admin role required.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"User not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"patchV1AdminUsersById","tags":["Admin"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Update tier and/or role","description":"Sets `user.tier` and/or `user.role`. No Stripe state is touched — admin tier overrides are independent of subscriptions. To revert, PATCH again.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"tier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]},"role":{"anyOf":[{"type":"string","enum":["user"]},{"type":"string","enum":["admin"]}]}}}}}}}},"/v1/admin/users/{id}/credits":{"post":{"responses":{"201":{"description":"Detail with new grant included.","content":{"application/json":{"schema":{"type":"object","required":["user","keys","grants","usage"],"properties":{"user":{"type":"object","required":["id","email","name","image","tier","role","emailVerified","activeKeyCount","bonusCredits","creditsUsed","creditsLimit","createdAt","lastActiveAt"],"properties":{"id":{"type":"string"},"email":{"format":"email","type":"string"},"name":{"type":"string"},"image":{"anyOf":[{"type":"string","nullable":true}]},"tier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]},"effectiveTier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]},"role":{"anyOf":[{"type":"string","enum":["user"]},{"type":"string","enum":["admin"]}]},"emailVerified":{"type":"boolean"},"subscriptionStatus":{"anyOf":[{"type":"string","nullable":true}]},"pastDueSince":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"autoRecharge":{"type":"object","required":["enabled","targetCredits","lastRechargedAt"],"properties":{"enabled":{"type":"boolean"},"targetCredits":{"anyOf":[{"type":"integer","nullable":true}]},"lastRechargedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}},"activeKeyCount":{"type":"integer"},"bonusCredits":{"type":"integer"},"creditsUsed":{"type":"integer"},"creditsLimit":{"type":"integer"},"createdAt":{"format":"date-time","type":"string"},"lastActiveAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}},"keys":{"type":"array","items":{"type":"object","required":["id","name","prefix","suffix","tier","createdAt","lastUsedAt","revokedAt"],"properties":{"id":{"type":"string"},"name":{"anyOf":[{"type":"string","nullable":true}]},"prefix":{"type":"string"},"suffix":{"anyOf":[{"type":"string","nullable":true}]},"tier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]},"createdAt":{"format":"date-time","type":"string"},"lastUsedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"revokedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}}},"grants":{"type":"array","items":{"type":"object","required":["id","userId","creditsDelta","reason","grantedByUserId","grantedByEmail","expiresAt","revokedAt","revokedByUserId","revokedByEmail","revokeReason","active","createdAt"],"properties":{"id":{"type":"string"},"userId":{"type":"string"},"creditsDelta":{"description":"Positive = bonus, negative = clawback. Stays in effect until revoked or expired.","type":"integer"},"reason":{"type":"string"},"grantedByUserId":{"anyOf":[{"type":"string","nullable":true}]},"grantedByEmail":{"anyOf":[{"format":"email","type":"string","nullable":true}]},"expiresAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"revokedAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"revokedByUserId":{"anyOf":[{"type":"string","nullable":true}]},"revokedByEmail":{"anyOf":[{"format":"email","type":"string","nullable":true}]},"revokeReason":{"anyOf":[{"type":"string","nullable":true}]},"active":{"type":"boolean"},"createdAt":{"format":"date-time","type":"string"}}}},"usage":{"type":"object","required":["creditsUsed","creditsLimit","creditsRemaining","bonusCredits","resetAt"],"properties":{"creditsUsed":{"type":"integer"},"creditsLimit":{"type":"integer"},"creditsRemaining":{"type":"integer"},"bonusCredits":{"type":"integer"},"resetAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}}}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Admin role required.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"User not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1AdminUsersByIdCredits","tags":["Admin"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Grant (or claw back) credits","description":"Inserts a row into `credit_grants`. Positive `creditsDelta` adds to the user's monthly limit; negative subtracts. With no `expiresAt`, the grant is permanent until revoked. To grant 'this month only', set `expiresAt` to the first of next month UTC.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["creditsDelta","reason"],"properties":{"creditsDelta":{"minimum":-10000000,"maximum":10000000,"type":"integer"},"reason":{"minLength":1,"maxLength":280,"type":"string"},"expiresAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]}}}}}}}},"/v1/admin/grants/{id}":{"delete":{"responses":{"200":{"description":"Revoked."},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Admin role required.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Grant not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1AdminGrantsById","tags":["Admin"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Revoke a credit grant","description":"Marks the grant as revoked (append-only — the row stays for audit). The next `snapshotUsage` call no longer counts it toward `bonusCredits`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"maxLength":280,"type":"string"}}}}}}}},"/v1/admin/users/{id}/keys":{"post":{"responses":{"201":{"description":"Key created.","content":{"application/json":{"schema":{"type":"object","required":["id","tier","prefix","suffix","plaintext","notice"],"properties":{"id":{"type":"string"},"tier":{"anyOf":[{"type":"string","enum":["free"]},{"type":"string","enum":["hobby"]},{"type":"string","enum":["standard"]},{"type":"string","enum":["growth"]}]},"prefix":{"type":"string"},"suffix":{"type":"string"},"plaintext":{"type":"string"},"notice":{"type":"string"}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Admin role required.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"User not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1AdminUsersByIdKeys","tags":["Admin"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Issue a key on behalf of a user","description":"Creates a key inheriting the user's current tier. Plaintext is returned exactly once.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"maxLength":80,"type":"string"}}}}}}}},"/v1/admin/keys/{id}":{"delete":{"responses":{"200":{"description":"Revoked.","content":{"application/json":{"schema":{"type":"object","required":["id","revoked"],"properties":{"id":{"type":"string"},"revoked":{"type":"boolean"}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Admin role required.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Key not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1AdminKeysById","tags":["Admin"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Force-revoke any API key"}},"/v1/admin/takedowns/{id}/approve-counter":{"post":{"responses":{"200":{"description":"Counter-notice approved + listing restored."},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Admin role required.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Counter-notice not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1AdminTakedownsByIdApprove-counter","tags":["Admin"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Approve a §512(g) counter-notice + restore the listing","description":"Operator approval of a counter-notice. Clears `takedownAt` on every listing_observations row matching the affected itemId, marks the counter-notice request as `approved`, and emails the original takedown submitter per 17 U.S.C. §512(g)(2)(B). Resend wiring is best-effort; the restore happens regardless."}},"/v1/admin/evaluations":{"get":{"responses":{"200":{"description":"Evaluations.","content":{"application/json":{"schema":{"type":"object","required":["rows","total","limit","offset"],"properties":{"rows":{"type":"array","items":{"type":"object","required":["jobId","marketplace","itemId","title","itemWebUrl","condition","categoryName","askingPriceCents","rating","expectedNetCents","successNetCents","maxLossCents","medianSoldCents","nSold","salesPerDay","nActive","expectedDaysToSell","recommendedListPriceCents","pFraud","sellerFeedbackScore","sellerFeedbackPercent","lookbackDays","completedAt"],"properties":{"jobId":{"type":"string"},"marketplace":{"type":"string","enum":["ebay_us"]},"itemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"format":"uri","type":"string"},"image":{"format":"uri","type":"string"},"condition":{"anyOf":[{"type":"string","nullable":true}]},"categoryName":{"anyOf":[{"type":"string","nullable":true}]},"askingPriceCents":{"anyOf":[{"type":"integer","nullable":true}]},"rating":{"anyOf":[{"type":"string","enum":["buy"]},{"type":"string","enum":["skip"]}]},"expectedNetCents":{"type":"integer"},"successNetCents":{"anyOf":[{"type":"integer","nullable":true}]},"maxLossCents":{"anyOf":[{"type":"integer","nullable":true}]},"medianSoldCents":{"type":"integer"},"nSold":{"type":"integer"},"salesPerDay":{"type":"number"},"nActive":{"type":"integer"},"expectedDaysToSell":{"anyOf":[{"type":"number","nullable":true}]},"recommendedListPriceCents":{"anyOf":[{"type":"integer","nullable":true}]},"pFraud":{"anyOf":[{"type":"number","nullable":true}]},"sellerFeedbackScore":{"anyOf":[{"type":"integer","nullable":true}]},"sellerFeedbackPercent":{"anyOf":[{"type":"number","nullable":true}]},"lookbackDays":{"type":"integer"},"completedAt":{"format":"date-time","type":"string"}}}},"total":{"description":"Total rows after dedup + filters, pre-pagination.","type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Admin role required.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1AdminEvaluations","tags":["Admin"],"parameters":[],"summary":"Browse all completed evaluations across users"}},"/v1/admin/evaluations/{jobId}":{"get":{"responses":{"200":{"description":"Full EvaluateResponse.","content":{"application/json":{"schema":{"type":"object","required":["item","evaluation","market","sold","active","filter","returns","meta","soldPool","activePool","rejectedSoldPool","rejectedActivePool","rejectionReasons"],"properties":{"item":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"listingMarketplaceId":{"type":"string"},"sellerItemRevision":{"type":"string"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"description":{"type":"string"},"shortDescription":{"type":"string"},"categoryPath":{"type":"string"},"categoryId":{"type":"string"},"categoryIdPath":{"type":"string"},"localizedAspects":{"type":"array","items":{"type":"object","required":["name","value"],"properties":{"name":{"type":"string"},"value":{"type":"string"},"type":{"type":"string"}}}},"brand":{"type":"string"},"color":{"type":"string"},"size":{"type":"string"},"pattern":{"type":"string"},"material":{"type":"string"},"sizeType":{"type":"string"},"mpn":{"type":"string"},"gtin":{"type":"string"},"epid":{"type":"string"},"lotSize":{"type":"integer"},"quantityLimitPerBuyer":{"type":"integer"},"conditionDescription":{"type":"string"},"conditionDescriptors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"values":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"}}}}}}},"marketingPrice":{"type":"object","properties":{"originalPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"discountAmount":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"discountPercentage":{"type":"string"},"priceTreatment":{"type":"string"}}},"primaryProductReviewRating":{"type":"object","properties":{"reviewCount":{"type":"integer"},"averageRating":{"type":"string"},"ratingHistograms":{"type":"array","items":{"type":"object","required":["rating","count"],"properties":{"rating":{"type":"string"},"count":{"type":"integer"}}}}}},"warnings":{"type":"array","items":{"type":"object","properties":{"errorId":{"type":"integer"},"domain":{"type":"string"},"category":{"type":"string"},"message":{"type":"string"},"parameters":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"type":"string"}}}}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"priorityListing":{"type":"boolean"},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"estimatedAvailabilities":{"type":"array","items":{"type":"object","properties":{"estimatedAvailabilityStatus":{"type":"string"},"estimatedAvailableQuantity":{"type":"integer"},"estimatedSoldQuantity":{"type":"integer"},"estimatedRemainingQuantity":{"type":"integer"},"availabilityThreshold":{"type":"integer"},"availabilityThresholdType":{"type":"string"},"deliveryOptions":{"type":"array","items":{"type":"string"}}}}},"shipToLocations":{"type":"object","properties":{"regionIncluded":{"type":"array","items":{"type":"object","properties":{"regionName":{"type":"string"},"regionType":{"type":"string"},"regionId":{"type":"string"}}}},"regionExcluded":{"type":"array","items":{"type":"object","properties":{"regionName":{"type":"string"},"regionType":{"type":"string"},"regionId":{"type":"string"}}}}}},"returnTerms":{"type":"object","properties":{"returnsAccepted":{"type":"boolean"},"returnPeriod":{"type":"object","required":["value","unit"],"properties":{"value":{"type":"integer"},"unit":{"type":"string"}}},"returnShippingCostPayer":{"type":"string"},"refundMethod":{"type":"string"},"returnMethod":{"type":"string"}}},"taxes":{"type":"array","items":{"type":"object","properties":{"taxJurisdiction":{"type":"object","properties":{"region":{"type":"object","properties":{"regionName":{"type":"string"},"regionType":{"type":"string"}}},"taxJurisdictionId":{"type":"string"}}},"taxType":{"type":"string"},"shippingAndHandlingTaxed":{"type":"boolean"},"includedInPrice":{"type":"boolean"},"ebayCollectAndRemitTax":{"type":"boolean"},"taxPercentage":{"type":"string"}}}},"paymentMethods":{"type":"array","items":{"type":"object","properties":{"paymentMethodType":{"type":"string"},"paymentMethodBrands":{"type":"array","items":{"type":"object","properties":{"paymentMethodBrandType":{"type":"string"},"logoImage":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}}}}}}},"immediatePay":{"type":"boolean"},"enabledForGuestCheckout":{"type":"boolean"},"eligibleForInlineCheckout":{"type":"boolean"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"},"primaryItemGroup":{"type":"object","properties":{"itemGroupId":{"type":"string"},"itemGroupType":{"type":"string"},"itemGroupHref":{"type":"string"},"itemGroupTitle":{"type":"string"},"itemGroupImage":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"itemGroupAdditionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}}}},"unitPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"unitPricingMeasure":{"type":"string"}}},"evaluation":{"type":"object","required":["successNetCents","expectedNetCents","maxLossCents","landedCostCents","rating","reasonCode","reason","bidCeilingCents","safeBidBreakdown","netRangeCents","recommendedExit","risk"],"properties":{"successNetCents":{"anyOf":[{"type":"integer","nullable":true}]},"expectedNetCents":{"type":"integer"},"maxLossCents":{"anyOf":[{"type":"integer","nullable":true}]},"landedCostCents":{"anyOf":[{"type":"integer","nullable":true}]},"rating":{"anyOf":[{"type":"string","enum":["buy"]},{"type":"string","enum":["skip"]}]},"reasonCode":{"anyOf":[{"type":"string","enum":["cleared"]},{"type":"string","enum":["vetoed"]},{"type":"string","enum":["no_market"]},{"type":"string","enum":["insufficient_data"]},{"type":"string","enum":["below_min_net"]}]},"reason":{"type":"string"},"bidCeilingCents":{"anyOf":[{"type":"integer","nullable":true}]},"safeBidBreakdown":{"anyOf":[{"type":"object","required":["estimatedSaleCents","feesCents","shippingCents","targetNetCents"],"properties":{"estimatedSaleCents":{"type":"integer"},"feesCents":{"type":"integer"},"shippingCents":{"type":"integer"},"targetNetCents":{"type":"integer"}},"nullable":true}]},"netRangeCents":{"anyOf":[{"type":"object","required":["p10Cents","p90Cents"],"properties":{"p10Cents":{"type":"integer"},"p90Cents":{"type":"integer"}},"nullable":true}]},"recommendedExit":{"anyOf":[{"type":"object","required":["listPriceCents","expectedDaysToSell","daysLow","daysHigh","netCents","dollarsPerDay","queueAhead","asksAbove"],"properties":{"listPriceCents":{"type":"integer"},"expectedDaysToSell":{"type":"number"},"daysLow":{"type":"number"},"daysHigh":{"type":"number"},"netCents":{"type":"integer"},"dollarsPerDay":{"type":"integer"},"queueAhead":{"type":"integer"},"asksAbove":{"type":"integer"}},"nullable":true}]},"risk":{"anyOf":[{"type":"object","required":["P_fraud","withinReturnWindow","cycleDays","reason"],"properties":{"P_fraud":{"type":"number"},"withinReturnWindow":{"type":"boolean"},"cycleDays":{"type":"integer"},"reason":{"type":"string"}},"nullable":true}]}}},"evaluationAll":{"type":"object","required":["successNetCents","expectedNetCents","maxLossCents","landedCostCents","rating","reasonCode","reason","bidCeilingCents","safeBidBreakdown","netRangeCents","recommendedExit","risk"],"properties":{"successNetCents":{"anyOf":[{"type":"integer","nullable":true}]},"expectedNetCents":{"type":"integer"},"maxLossCents":{"anyOf":[{"type":"integer","nullable":true}]},"landedCostCents":{"anyOf":[{"type":"integer","nullable":true}]},"rating":{"anyOf":[{"type":"string","enum":["buy"]},{"type":"string","enum":["skip"]}]},"reasonCode":{"anyOf":[{"type":"string","enum":["cleared"]},{"type":"string","enum":["vetoed"]},{"type":"string","enum":["no_market"]},{"type":"string","enum":["insufficient_data"]},{"type":"string","enum":["below_min_net"]}]},"reason":{"type":"string"},"bidCeilingCents":{"anyOf":[{"type":"integer","nullable":true}]},"safeBidBreakdown":{"anyOf":[{"type":"object","required":["estimatedSaleCents","feesCents","shippingCents","targetNetCents"],"properties":{"estimatedSaleCents":{"type":"integer"},"feesCents":{"type":"integer"},"shippingCents":{"type":"integer"},"targetNetCents":{"type":"integer"}},"nullable":true}]},"netRangeCents":{"anyOf":[{"type":"object","required":["p10Cents","p90Cents"],"properties":{"p10Cents":{"type":"integer"},"p90Cents":{"type":"integer"}},"nullable":true}]},"recommendedExit":{"anyOf":[{"type":"object","required":["listPriceCents","expectedDaysToSell","daysLow","daysHigh","netCents","dollarsPerDay","queueAhead","asksAbove"],"properties":{"listPriceCents":{"type":"integer"},"expectedDaysToSell":{"type":"number"},"daysLow":{"type":"number"},"daysHigh":{"type":"number"},"netCents":{"type":"integer"},"dollarsPerDay":{"type":"integer"},"queueAhead":{"type":"integer"},"asksAbove":{"type":"integer"}},"nullable":true}]},"risk":{"anyOf":[{"type":"object","required":["P_fraud","withinReturnWindow","cycleDays","reason"],"properties":{"P_fraud":{"type":"number"},"withinReturnWindow":{"type":"boolean"},"cycleDays":{"type":"integer"},"reason":{"type":"string"}},"nullable":true}]}}},"market":{"type":"object","required":["keyword","marketplace","windowDays","meanCents","stdDevCents","medianCents","p25Cents","p75Cents","nObservations","salesPerDay","asOf"],"properties":{"keyword":{"type":"string"},"marketplace":{"type":"string"},"windowDays":{"type":"integer"},"meanCents":{"type":"integer"},"stdDevCents":{"type":"integer"},"medianCents":{"type":"integer"},"medianCiLowCents":{"type":"integer"},"medianCiHighCents":{"type":"integer"},"p25Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"nObservations":{"type":"integer"},"salesPerDay":{"type":"number"},"salesPerDayBaseline":{"type":"number"},"salesPerDaySeed":{"type":"number"},"meanDaysToSell":{"type":"number"},"daysStdDev":{"type":"number"},"daysP50":{"type":"number"},"daysP70":{"type":"number"},"daysP90":{"type":"number"},"nDurations":{"type":"integer"},"asks":{"type":"object","required":["meanCents","stdDevCents","medianCents","p25Cents","p75Cents","nActive"],"properties":{"meanCents":{"type":"integer"},"stdDevCents":{"type":"integer"},"medianCents":{"type":"integer"},"p25Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"nActive":{"type":"integer"}}},"asOf":{"type":"string"}}},"sold":{"type":"object","required":["count","windowDays","salesPerDay","meanDaysToSell","priceCents","priceHistogram","conditionMix","recentTrend","lastSaleAt","lastSalePriceCents"],"properties":{"count":{"type":"integer"},"windowDays":{"type":"integer"},"salesPerDay":{"type":"number"},"meanDaysToSell":{"anyOf":[{"type":"number","nullable":true}]},"priceCents":{"type":"object","required":["minCents","p10Cents","p25Cents","p50Cents","p75Cents","p90Cents","maxCents"],"properties":{"minCents":{"type":"integer"},"p10Cents":{"type":"integer"},"p25Cents":{"type":"integer"},"p50Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"p90Cents":{"type":"integer"},"maxCents":{"type":"integer"}}},"priceHistogram":{"type":"array","items":{"type":"object","required":["minCents","maxCents","count"],"properties":{"minCents":{"type":"integer"},"maxCents":{"type":"integer"},"count":{"type":"integer"}}}},"conditionMix":{"type":"object","additionalProperties":true},"recentTrend":{"anyOf":[{"type":"object","required":["direction","change14dPct"],"properties":{"direction":{"anyOf":[{"type":"string","enum":["up"]},{"type":"string","enum":["flat"]},{"type":"string","enum":["down"]}]},"change14dPct":{"type":"number"}},"nullable":true}]},"lastSaleAt":{"anyOf":[{"type":"string","nullable":true}]},"lastSalePriceCents":{"anyOf":[{"type":"integer","nullable":true}]}}},"active":{"type":"object","required":["count","priceCents","priceHistogram","conditionMix","bestPriceCents","sellerConcentration"],"properties":{"count":{"type":"integer"},"priceCents":{"type":"object","required":["minCents","p10Cents","p25Cents","p50Cents","p75Cents","p90Cents","maxCents"],"properties":{"minCents":{"type":"integer"},"p10Cents":{"type":"integer"},"p25Cents":{"type":"integer"},"p50Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"p90Cents":{"type":"integer"},"maxCents":{"type":"integer"}}},"priceHistogram":{"type":"array","items":{"type":"object","required":["minCents","maxCents","count"],"properties":{"minCents":{"type":"integer"},"maxCents":{"type":"integer"},"count":{"type":"integer"}}}},"conditionMix":{"type":"object","additionalProperties":true},"bestPriceCents":{"anyOf":[{"type":"integer","nullable":true}]},"sellerConcentration":{"anyOf":[{"type":"string","enum":["diverse"]},{"type":"string","enum":["few_sellers"]}]}}},"marketAll":{"type":"object","required":["keyword","marketplace","windowDays","meanCents","stdDevCents","medianCents","p25Cents","p75Cents","nObservations","salesPerDay","asOf"],"properties":{"keyword":{"type":"string"},"marketplace":{"type":"string"},"windowDays":{"type":"integer"},"meanCents":{"type":"integer"},"stdDevCents":{"type":"integer"},"medianCents":{"type":"integer"},"medianCiLowCents":{"type":"integer"},"medianCiHighCents":{"type":"integer"},"p25Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"nObservations":{"type":"integer"},"salesPerDay":{"type":"number"},"salesPerDayBaseline":{"type":"number"},"salesPerDaySeed":{"type":"number"},"meanDaysToSell":{"type":"number"},"daysStdDev":{"type":"number"},"daysP50":{"type":"number"},"daysP70":{"type":"number"},"daysP90":{"type":"number"},"nDurations":{"type":"integer"},"asks":{"type":"object","required":["meanCents","stdDevCents","medianCents","p25Cents","p75Cents","nActive"],"properties":{"meanCents":{"type":"integer"},"stdDevCents":{"type":"integer"},"medianCents":{"type":"integer"},"p25Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"nActive":{"type":"integer"}}},"asOf":{"type":"string"}}},"soldAll":{"type":"object","required":["count","windowDays","salesPerDay","meanDaysToSell","priceCents","priceHistogram","conditionMix","recentTrend","lastSaleAt","lastSalePriceCents"],"properties":{"count":{"type":"integer"},"windowDays":{"type":"integer"},"salesPerDay":{"type":"number"},"meanDaysToSell":{"anyOf":[{"type":"number","nullable":true}]},"priceCents":{"type":"object","required":["minCents","p10Cents","p25Cents","p50Cents","p75Cents","p90Cents","maxCents"],"properties":{"minCents":{"type":"integer"},"p10Cents":{"type":"integer"},"p25Cents":{"type":"integer"},"p50Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"p90Cents":{"type":"integer"},"maxCents":{"type":"integer"}}},"priceHistogram":{"type":"array","items":{"type":"object","required":["minCents","maxCents","count"],"properties":{"minCents":{"type":"integer"},"maxCents":{"type":"integer"},"count":{"type":"integer"}}}},"conditionMix":{"type":"object","additionalProperties":true},"recentTrend":{"anyOf":[{"type":"object","required":["direction","change14dPct"],"properties":{"direction":{"anyOf":[{"type":"string","enum":["up"]},{"type":"string","enum":["flat"]},{"type":"string","enum":["down"]}]},"change14dPct":{"type":"number"}},"nullable":true}]},"lastSaleAt":{"anyOf":[{"type":"string","nullable":true}]},"lastSalePriceCents":{"anyOf":[{"type":"integer","nullable":true}]}}},"activeAll":{"type":"object","required":["count","priceCents","priceHistogram","conditionMix","bestPriceCents","sellerConcentration"],"properties":{"count":{"type":"integer"},"priceCents":{"type":"object","required":["minCents","p10Cents","p25Cents","p50Cents","p75Cents","p90Cents","maxCents"],"properties":{"minCents":{"type":"integer"},"p10Cents":{"type":"integer"},"p25Cents":{"type":"integer"},"p50Cents":{"type":"integer"},"p75Cents":{"type":"integer"},"p90Cents":{"type":"integer"},"maxCents":{"type":"integer"}}},"priceHistogram":{"type":"array","items":{"type":"object","required":["minCents","maxCents","count"],"properties":{"minCents":{"type":"integer"},"maxCents":{"type":"integer"},"count":{"type":"integer"}}}},"conditionMix":{"type":"object","additionalProperties":true},"bestPriceCents":{"anyOf":[{"type":"integer","nullable":true}]},"sellerConcentration":{"anyOf":[{"type":"string","enum":["diverse"]},{"type":"string","enum":["few_sellers"]}]}}},"filter":{"type":"object","required":["soldKept","soldRejected","activeKept","activeRejected","rejectionsByCategory"],"properties":{"soldKept":{"type":"integer"},"soldRejected":{"type":"integer"},"activeKept":{"type":"integer"},"activeRejected":{"type":"integer"},"rejectionsByCategory":{"type":"object","additionalProperties":true}}},"returns":{"anyOf":[{"type":"object","required":["accepted"],"properties":{"accepted":{"type":"boolean"},"periodDays":{"minimum":0,"type":"integer"},"shippingCostPaidBy":{"anyOf":[{"type":"string","enum":["BUYER"]},{"type":"string","enum":["SELLER"]}]}},"nullable":true}]},"meta":{"type":"object","required":["soldCount","activeCount","soldKept","soldRejected","activeKept","activeRejected"],"properties":{"soldCount":{"type":"integer"},"activeCount":{"type":"integer"},"soldKept":{"type":"integer"},"soldRejected":{"type":"integer"},"activeKept":{"type":"integer"},"activeRejected":{"type":"integer"}}},"soldPool":{"type":"array","items":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"itemAffiliateWebUrl":{"type":"string"},"itemHref":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"lastSoldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"lastSoldDate":{"type":"string"},"totalSoldQuantity":{"type":"integer"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"thumbnailImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"epid":{"type":"string"},"gtin":{"type":"string"},"categoryId":{"type":"string"},"leafCategoryIds":{"type":"array","items":{"type":"string"}},"itemGroupHref":{"type":"string"},"itemGroupType":{"type":"string"},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"listingMarketplaceId":{"type":"string"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"}}}},"activePool":{"type":"array","items":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"itemAffiliateWebUrl":{"type":"string"},"itemHref":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"lastSoldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"lastSoldDate":{"type":"string"},"totalSoldQuantity":{"type":"integer"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"thumbnailImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"epid":{"type":"string"},"gtin":{"type":"string"},"categoryId":{"type":"string"},"leafCategoryIds":{"type":"array","items":{"type":"string"}},"itemGroupHref":{"type":"string"},"itemGroupType":{"type":"string"},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"listingMarketplaceId":{"type":"string"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"}}}},"rejectedSoldPool":{"type":"array","items":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"itemAffiliateWebUrl":{"type":"string"},"itemHref":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"lastSoldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"lastSoldDate":{"type":"string"},"totalSoldQuantity":{"type":"integer"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"thumbnailImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"epid":{"type":"string"},"gtin":{"type":"string"},"categoryId":{"type":"string"},"leafCategoryIds":{"type":"array","items":{"type":"string"}},"itemGroupHref":{"type":"string"},"itemGroupType":{"type":"string"},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"listingMarketplaceId":{"type":"string"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"}}}},"rejectedActivePool":{"type":"array","items":{"type":"object","required":["itemId","title","itemWebUrl"],"properties":{"itemId":{"type":"string"},"legacyItemId":{"type":"string"},"title":{"type":"string"},"itemWebUrl":{"type":"string"},"itemAffiliateWebUrl":{"type":"string"},"itemHref":{"type":"string"},"condition":{"type":"string"},"conditionId":{"type":"string"},"price":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"lastSoldPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingOptions":{"type":"array","items":{"type":"object","properties":{"shippingCost":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"shippingCostType":{"type":"string"},"shippingServiceCode":{"type":"string"},"shippingCarrierCode":{"type":"string"},"type":{"type":"string"},"quantityUsedForEstimate":{"type":"integer"},"minEstimatedDeliveryDate":{"type":"string"},"maxEstimatedDeliveryDate":{"type":"string"}}}},"buyingOptions":{"type":"array","items":{"anyOf":[{"type":"string","enum":["AUCTION"]},{"type":"string","enum":["FIXED_PRICE"]},{"type":"string","enum":["BEST_OFFER"]}]}},"bidCount":{"type":"integer"},"currentBidPrice":{"type":"object","required":["value","currency"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"watchCount":{"type":"integer"},"itemEndDate":{"type":"string"},"itemCreationDate":{"type":"string"},"lastSoldDate":{"type":"string"},"totalSoldQuantity":{"type":"integer"},"seller":{"type":"object","properties":{"username":{"type":"string"},"feedbackScore":{"type":"integer"},"feedbackPercentage":{"type":"string"}}},"image":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}},"thumbnailImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"additionalImages":{"type":"array","items":{"type":"object","required":["imageUrl"],"properties":{"imageUrl":{"type":"string"},"width":{"type":"integer"},"height":{"type":"integer"}}}},"topRatedBuyingExperience":{"type":"boolean"},"qualifiedPrograms":{"type":"array","items":{"type":"string"}},"authenticityGuarantee":{"type":"object","properties":{"termsWebUrl":{"type":"string"},"description":{"type":"string"}}},"epid":{"type":"string"},"gtin":{"type":"string"},"categoryId":{"type":"string"},"leafCategoryIds":{"type":"array","items":{"type":"string"}},"itemGroupHref":{"type":"string"},"itemGroupType":{"type":"string"},"itemLocation":{"type":"object","properties":{"city":{"type":"string"},"stateOrProvince":{"type":"string"},"postalCode":{"type":"string"},"country":{"type":"string"}}},"listingMarketplaceId":{"type":"string"},"adultOnly":{"type":"boolean"},"availableCoupons":{"type":"boolean"}}}},"rejectionReasons":{"type":"object","additionalProperties":true},"rejectionCategories":{"type":"object","additionalProperties":true},"suspiciousIds":{"type":"object","additionalProperties":true}}}}}},"401":{"description":"Not signed in.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Admin role required.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Job not found or not a completed evaluate.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1AdminEvaluationsByJobId","tags":["Admin"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"jobId","required":true}],"summary":"Full cached evaluation result for one job"}},"/v1/takedown":{"post":{"responses":{"201":{"description":"Takedown request recorded.","content":{"application/json":{"schema":{"type":"object","required":["id","status","slaHours"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["pending"]},"slaHours":{"description":"Maximum business hours until triage. Approved takedowns flush the cache and blocklist the itemId.","type":"integer"}}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1Takedown","tags":["Compliance"],"parameters":[],"summary":"Takedown / DMCA / GDPR-erasure / CCPA-deletion request","description":"Single endpoint covering DMCA §512(c)(3) infringement notices, GDPR Art. 17 erasure, CCPA §1798.105 deletion, and voluntary seller opt-out. Triage SLA is 48 business hours. See /legal/compliance for the DMCA designated agent contact.","security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["itemId","contactEmail"],"properties":{"itemId":{"description":"eBay itemId to remove from cache and blocklist.","type":"string"},"kind":{"anyOf":[{"type":"string","enum":["dmca_copyright"]},{"type":"string","enum":["gdpr_erasure"]},{"type":"string","enum":["ccpa_deletion"]},{"type":"string","enum":["seller_optout"]},{"type":"string","enum":["other"]}]},"reason":{"description":"Free-form context for the request.","type":"string"},"contactEmail":{"format":"email","type":"string"},"dmca":{"type":"object","required":["copyrightedWork","goodFaithStatement","accuracyStatement","signature"],"properties":{"copyrightedWork":{"description":"Identification of the copyrighted work claimed to have been infringed.","type":"string"},"goodFaithStatement":{"description":"Statement of good faith belief that the use is not authorized by the copyright owner, its agent, or the law (§512(c)(3)(A)(v)).","type":"boolean"},"accuracyStatement":{"description":"Statement under penalty of perjury that the information is accurate and the requester is authorized to act on behalf of the rights holder (§512(c)(3)(A)(vi)).","type":"boolean"},"signature":{"description":"Physical or electronic signature of the authorized person.","type":"string"}}}}}}}}}},"/v1/takedown/counter-notice":{"post":{"responses":{"201":{"description":"Counter-notice recorded.","content":{"application/json":{"schema":{"type":"object","required":["id","status","message"],"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["received"]},"message":{"type":"string"}}}}}},"400":{"description":"Validation failed (missing attestation or contact field).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1TakedownCounter-notice","tags":["Compliance"],"parameters":[],"summary":"DMCA §512(g) counter-notice","description":"Submit a counter-notice to restore content that was removed in response to a takedown you believe was mistaken or misidentified. Requires the four §512(g) attestations + a typed signature + contact info. Triage is operator-driven and follows the same 48-business-hour SLA. Approved counter-notices clear `takedownAt` on the affected listing-observations rows; the original requester is notified per §512(g)(2)(B).","security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["itemId","contactName","contactEmail","contactAddress","contactPhone","signature","agreePenaltyOfPerjury","agreeJurisdiction","agreeServiceOfProcess"],"properties":{"itemId":{"minLength":1,"type":"string"},"contactName":{"minLength":1,"maxLength":200,"type":"string"},"contactEmail":{"format":"email","type":"string"},"contactAddress":{"minLength":1,"maxLength":500,"type":"string"},"contactPhone":{"minLength":1,"maxLength":60,"type":"string"},"signature":{"minLength":1,"maxLength":200,"description":"Typed legal name.","type":"string"},"agreePenaltyOfPerjury":{"description":"I swear under penalty of perjury that I have a good-faith belief the material was removed as a result of mistake or misidentification.","type":"boolean"},"agreeJurisdiction":{"description":"I consent to the jurisdiction of the U.S. District Court for the District of Delaware (Wilmington), or, if I am outside the U.S., to any judicial district where flipagent may be found.","type":"boolean"},"agreeServiceOfProcess":{"description":"I will accept service of process from the person who submitted the original takedown notice (or their agent).","type":"boolean"},"notes":{"maxLength":2000,"type":"string"}}}}}}}},"/v1/agent/chat":{"post":{"responses":{"200":{"description":"Reply.","content":{"application/json":{"schema":{"type":"object","required":["sessionId","runId","reply","model","tokensIn","tokensOut","costCents"],"properties":{"sessionId":{"type":"string"},"runId":{"type":"string"},"reply":{"type":"string"},"model":{"type":"string"},"tokensIn":{"type":"integer"},"tokensOut":{"type":"integer"},"costCents":{"type":"integer"},"ui":{"type":"object","required":["resourceUri"],"properties":{"resourceUri":{"type":"string"},"props":{"type":"object","additionalProperties":true},"mimeType":{"type":"string"}}}}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"403":{"description":"Model not available on this tier (e.g. Free + gpt-5.5).","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Session not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"502":{"description":"Upstream OpenAI error.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Agent not configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1AgentChat","tags":["Agent (preview)"],"parameters":[],"summary":"Send one chat turn","description":"Kicks off a new thread (omit `sessionId`) or continues an existing one. State lives on OpenAI's side via the Responses API; flipagent stores only the most recent `response.id` per session.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"maxLength":8000,"type":"string"},"sessionId":{"type":"string"},"attachments":{"maxItems":8,"type":"array","items":{"type":"object","required":["kind","dataUrl"],"properties":{"kind":{"anyOf":[{"type":"string","enum":["image"]},{"type":"string","enum":["file"]}]},"dataUrl":{"minLength":1,"type":"string"},"mimeType":{"type":"string"},"name":{"type":"string"}}}},"userAction":{"anyOf":[{"type":"object","required":["type","name"],"properties":{"type":{"type":"string","enum":["tool"]},"name":{"minLength":1,"maxLength":200,"type":"string"},"args":{"type":"object","additionalProperties":true}}},{"type":"object","required":["type","text"],"properties":{"type":{"type":"string","enum":["prompt"]},"text":{"minLength":1,"maxLength":8000,"type":"string"}}}]},"model":{"anyOf":[{"type":"string","enum":["gpt-5.4-mini"]},{"type":"string","enum":["gpt-5.5"]},{"type":"string","enum":["claude-sonnet-4-7"]},{"type":"string","enum":["gemini-2.5-flash"]}]}}}}}}}},"/v1/agent/sessions/{id}":{"patch":{"responses":{"200":{"description":"Updated session.","content":{"application/json":{"schema":{"type":"object","required":["id","createdAt","lastActiveAt"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"pinnedAt":{"type":"string"},"createdAt":{"type":"string"},"lastActiveAt":{"type":"string"}}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Session not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Agent not configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"patchV1AgentSessionsById","tags":["Agent (preview)"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Update an agent session (rename, pin/unpin)","description":"Patch the session's `title` (rename) and/or `pinned` (favorite). Pinned threads sort to the top of the list.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"minLength":1,"maxLength":200,"type":"string"},"pinned":{"type":"boolean"}}}}}}},"delete":{"responses":{"200":{"description":"Deleted."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Session not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Agent not configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1AgentSessionsById","tags":["Agent (preview)"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Delete an agent session","description":"Removes the session and its runs (cascade). The OpenAI thread itself is left as-is on OpenAI's side."}},"/v1/agent/sessions":{"get":{"responses":{"200":{"description":"Sessions.","content":{"application/json":{"schema":{"type":"object","required":["sessions"],"properties":{"sessions":{"type":"array","items":{"type":"object","required":["id","createdAt","lastActiveAt"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"pinnedAt":{"type":"string"},"createdAt":{"type":"string"},"lastActiveAt":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Agent not configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1AgentSessions","tags":["Agent (preview)"],"parameters":[],"summary":"List recent agent sessions"}},"/v1/agent/rules":{"get":{"responses":{"200":{"description":"Rules.","content":{"application/json":{"schema":{"type":"object","required":["rules"],"properties":{"rules":{"type":"array","items":{"type":"object","required":["id","kind","content","createdAt"],"properties":{"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["rule"]},{"type":"string","enum":["preference"]},{"type":"string","enum":["note"]}]},"content":{"type":"string"},"createdAt":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Agent not configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1AgentRules","tags":["Agent (preview)"],"parameters":[],"summary":"List agent rules and preferences"},"post":{"responses":{"200":{"description":"Created.","content":{"application/json":{"schema":{"type":"object","required":["id","kind","content","createdAt"],"properties":{"id":{"type":"string"},"kind":{"anyOf":[{"type":"string","enum":["rule"]},{"type":"string","enum":["preference"]},{"type":"string","enum":["note"]}]},"content":{"type":"string"},"createdAt":{"type":"string"}}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Agent not configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1AgentRules","tags":["Agent (preview)"],"parameters":[],"summary":"Add an agent rule, preference, or note","description":"Saved guidance is stuffed into the system instructions on every chat turn. Updates take effect on the next message — no thread reset.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["kind","content"],"properties":{"kind":{"anyOf":[{"type":"string","enum":["rule"]},{"type":"string","enum":["preference"]},{"type":"string","enum":["note"]}]},"content":{"minLength":1,"maxLength":2000,"type":"string"}}}}}}}},"/v1/agent/rules/{id}":{"delete":{"responses":{"200":{"description":"Deleted."},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Rule not found.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Agent not configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"deleteV1AgentRulesById","tags":["Agent (preview)"],"parameters":[{"schema":{"type":"string"},"in":"path","name":"id","required":true}],"summary":"Delete an agent rule"}},"/v1/agent/runs":{"get":{"responses":{"200":{"description":"Runs.","content":{"application/json":{"schema":{"type":"object","required":["runs"],"properties":{"runs":{"type":"array","items":{"type":"object","required":["id","triggerKind","tokensIn","tokensOut","costCents","startedAt"],"properties":{"id":{"type":"string"},"sessionId":{"type":"string"},"triggerKind":{"anyOf":[{"type":"string","enum":["chat"]},{"type":"string","enum":["cron"]},{"type":"string","enum":["webhook"]}]},"model":{"type":"string"},"userMessage":{"type":"string"},"reply":{"type":"string"},"tokensIn":{"type":"integer"},"tokensOut":{"type":"integer"},"costCents":{"type":"integer"},"errorMessage":{"type":"string"},"ui":{"type":"object","required":["resourceUri"],"properties":{"resourceUri":{"type":"string"},"props":{"type":"object","additionalProperties":true},"mimeType":{"type":"string"}}},"startedAt":{"type":"string"},"finishedAt":{"type":"string"}}}}}}}}},"401":{"description":"Auth missing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"503":{"description":"Agent not configured.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1AgentRuns","tags":["Agent (preview)"],"parameters":[{"in":"query","name":"limit","required":false,"schema":{}},{"in":"query","name":"sessionId","required":false,"schema":{}}],"summary":"Activity feed — recent agent runs"}},"/v1/bridge/tokens":{"post":{"responses":{"201":{"description":"Token issued.","content":{"application/json":{"schema":{"type":"object","required":["id","token","prefix","createdAt"],"properties":{"id":{"format":"uuid","type":"string"},"token":{"description":"Plaintext `fbt_…`. Shown once. Store it inside the bridge client (e.g. Chrome extension storage).","type":"string"},"prefix":{"type":"string"},"createdAt":{"format":"date-time","type":"string"}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1BridgeTokens","tags":["Bridge"],"parameters":[],"summary":"Issue a bridge token for an extension/bridge client","description":"Auth: api key. Returns a `fbt_…` plaintext shown once — the flipagent Chrome extension (or any other bridge client) stores it locally and uses it to claim jobs. The bridge token cascades when the parent api key is revoked.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"deviceName":{"maxLength":200,"description":"Friendly label, e.g. \"jinho-macbook\".","type":"string"}}}}}}}},"/v1/bridge/poll":{"get":{"responses":{"200":{"description":"Job claimed.","content":{"application/json":{"schema":{"type":"object","required":["jobId","task","args","issuedAt","expiresAt"],"properties":{"jobId":{"format":"uuid","description":"Correlates result POST.","type":"string"},"task":{"anyOf":[{"type":"string","enum":["ebay_buy_item"]},{"type":"string","enum":["ebay_place_bid"]},{"type":"string","enum":["pull_packages"]},{"type":"string","enum":["planetexpress_package_photos"]},{"type":"string","enum":["planetexpress_package_dispatch"]},{"type":"string","enum":["planetexpress_get_address"]},{"type":"string","enum":["reload_extension"]},{"type":"string","enum":["browser_op"]},{"type":"string","enum":["ebay_query"]}]},"args":{"additionalProperties":false,"type":"object","required":["source"],"properties":{"source":{"anyOf":[{"type":"string","enum":["ebay"]},{"type":"string","enum":["planetexpress"]},{"type":"string","enum":["control"]},{"type":"string","enum":["browser"]},{"type":"string","enum":["ebay_data"]}]},"itemId":{"type":"string"},"quantity":{"minimum":1,"type":"integer"},"maxPriceCents":{"anyOf":[{"type":"integer","nullable":true}]},"metadata":{"anyOf":[{"type":"object","nullable":true,"additionalProperties":true}]}}},"issuedAt":{"format":"date-time","type":"string"},"expiresAt":{"format":"date-time","type":"string"}}}}}},"204":{"description":"No job within the longpoll window. Reissue."},"401":{"description":"Missing or invalid bridge token.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"getV1BridgePoll","tags":["Bridge"],"parameters":[],"summary":"Bridge client longpoll — claim next job (or 204 after window)","description":"Auth: bridge token. Polls every second within the longpoll window for queued jobs belonging to the bridge token's api key. The first match is atomically claimed (FOR UPDATE SKIP LOCKED) and returned. 204 indicates an idle window — the client should reissue immediately. The flipagent Chrome extension's service worker drives this loop on a `chrome.alarms` tick."}},"/v1/bridge/result":{"post":{"responses":{"200":{"description":"Acknowledged.","content":{"application/json":{"schema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean","enum":[true]}}}}}},"401":{"description":"Missing or invalid bridge token.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"404":{"description":"Job not found or not owned by this token.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"409":{"description":"Job already in a terminal state.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1BridgeResult","tags":["Bridge"],"parameters":[],"summary":"Bridge client reports outcome / progress for a claimed job","description":"Auth: bridge token. The same token that claimed must report. Intermediate transitions (`claimed`, `awaiting_user_confirm`, `placing`) are accepted; terminal outcomes (`completed`, `failed`) are sticky — re-reporting is a no-op rather than an error.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["jobId","outcome"],"properties":{"jobId":{"format":"uuid","type":"string"},"outcome":{"anyOf":[{"type":"string","enum":["queued"]},{"type":"string","enum":["claimed"]},{"type":"string","enum":["awaiting_user_confirm"]},{"type":"string","enum":["placing"]},{"type":"string","enum":["completed"]},{"type":"string","enum":["failed"]},{"type":"string","enum":["cancelled"]},{"type":"string","enum":["expired"]}]},"ebayOrderId":{"type":"string"},"totalCents":{"minimum":0,"type":"integer"},"receiptUrl":{"type":"string"},"failureReason":{"maxLength":2000,"type":"string"},"result":{"type":"object","additionalProperties":true}}}}}}}},"/v1/bridge/login-status":{"post":{"responses":{"200":{"description":"Acknowledged.","content":{"application/json":{"schema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean","enum":[true]}}}}}},"401":{"description":"Missing or invalid bridge token.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1BridgeLogin-status","tags":["Bridge"],"parameters":[],"summary":"Bridge client reports browser eBay-login state","description":"Auth: bridge token. Sent by the flipagent Chrome extension after probing eBay cookies (via `chrome.cookies`) to verify the user is signed into ebay.com. Surfaced back via `GET /v1/connect/ebay/status` and `GET /v1/me/ebay/status` under `bridge.ebayLoggedIn`. Distinct from the server-side seller OAuth (`oauth.*`) — different access mechanism: browser automation vs API token.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["loggedIn"],"properties":{"loggedIn":{"type":"boolean"},"ebayUserName":{"maxLength":200,"type":"string"}}}}}}}},"/v1/bridge/pe-login-status":{"post":{"responses":{"200":{"description":"Acknowledged.","content":{"application/json":{"schema":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean","enum":[true]}}}}}},"401":{"description":"Missing or invalid bridge token.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1BridgePe-login-status","tags":["Bridge"],"parameters":[],"summary":"Bridge client reports Planet Express login state","description":"Auth: bridge token. Sent by the extension's content script after URL-probing app.planetexpress.com. Surfaced back via `/v1/capabilities.checklist` (planetexpress step status) so dashboard + MCP see the same 'done' state the popup does. Mirrors `/v1/bridge/login-status` but for the forwarder — distinct upstream + cookies, no overlap.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["loggedIn"],"properties":{"loggedIn":{"type":"boolean"}}}}}}}},"/v1/bridge/capture":{"post":{"responses":{"200":{"description":"Capture processed (stored or rejected with reason).","content":{"application/json":{"schema":{"type":"object","required":["stored"],"properties":{"stored":{"type":"boolean"},"itemId":{"type":"string"},"reason":{"type":"string"},"cachedFor":{"description":"TTL seconds the cached entry remains valid.","type":"integer"}}}}}},"401":{"description":"Missing or invalid bridge token.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"429":{"description":"Rate limit exceeded — 60 captures per 60 seconds per api key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1BridgeCapture","tags":["Bridge"],"parameters":[],"summary":"Push a parsed eBay PDP into the response cache","description":"Auth: bridge token. Validates the source URL, normalises the parsed `EbayItemDetail` payload through the same `ebayDetailToBrowse()` the scrape transport uses, and writes the resulting `ItemDetail` to the response cache. Subsequent `/v1/items/{itemId}` lookups hit the cached copy without scraping. Personal-page URLs and rate-limited callers receive a 200 with `stored: false`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["url","rawDetail"],"properties":{"url":{"description":"The eBay URL the page was captured from. Must be /itm/, /p/, or /sch/.","type":"string"},"rawDetail":{"description":"`EbayItemDetail` shape returned by `parseEbayDetailHtml` from `@flipagent/ebay-scraper`. Loose-typed here because the schema is owned by the scraper package."}}}}}}}},"/v1/browser/query":{"post":{"responses":{"200":{"description":"Query result.","content":{"application/json":{"schema":{"type":"object","required":["url","matchCount","matches","title"],"properties":{"url":{"type":"string"},"matchCount":{"type":"integer"},"matches":{"type":"array","items":{"type":"object","required":["tag","id","classes","text","html"],"properties":{"tag":{"type":"string"},"id":{"anyOf":[{"type":"string","nullable":true}]},"classes":{"type":"array","items":{"type":"string"}},"text":{"anyOf":[{"type":"string","nullable":true}]},"html":{"anyOf":[{"type":"string","nullable":true}]}}}},"title":{"type":"string"}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"504":{"description":"Bridge client did not respond in time.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1BrowserQuery","tags":["Browser"],"parameters":[],"summary":"DOM querySelectorAll on the active tab via the bridge client","description":"Synchronous: queues a `browser_op` job, waits up to 25 s for the extension to execute the query in the active tab, returns matched elements (text + outerHTML, capped). Returns 504 if the extension didn't respond in time. 1st-class surface for direct DOM access — useful when the high-level tools don't cover the read (custom marketplace, new field) or for interactive selector tuning during dev.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["selector"],"properties":{"selector":{"minLength":1,"maxLength":1000,"type":"string"},"limit":{"minimum":1,"maximum":200,"default":10,"type":"integer"},"includeHtml":{"default":true,"type":"boolean"},"includeText":{"default":true,"type":"boolean"},"truncateAt":{"minimum":100,"maximum":20000,"default":2000,"type":"integer"},"tabUrlPattern":{"type":"string"}}}}}}}},"/v1/browser/cookies":{"post":{"responses":{"200":{"description":"Cookies inventoried.","content":{"application/json":{"schema":{"type":"object","required":["domain","count","earliestExpiresAt","cookies"],"properties":{"domain":{"type":"string"},"count":{"type":"integer"},"earliestExpiresAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"cookies":{"type":"array","items":{"type":"object","required":["name","domain","path","expiresAt","httpOnly","secure","sameSite"],"properties":{"name":{"type":"string"},"domain":{"type":"string"},"path":{"type":"string"},"expiresAt":{"anyOf":[{"format":"date-time","type":"string","nullable":true}]},"httpOnly":{"type":"boolean"},"secure":{"type":"boolean"},"sameSite":{"anyOf":[{"type":"string","enum":["strict"]},{"type":"string","enum":["lax"]},{"type":"string","enum":["no_restriction"]},{"type":"string","enum":["unspecified"]}]}}}}}}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"504":{"description":"Bridge client did not respond in time.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"anyOf":[{"type":"string","enum":["validation_failed"]},{"type":"string","enum":["invalid_key"]},{"type":"string","enum":["unauthorized"]},{"type":"string","enum":["unauthenticated"]},{"type":"string","enum":["forbidden"]},{"type":"string","enum":["credits_exceeded"]},{"type":"string","enum":["burst_rate_limited"]},{"type":"string","enum":["not_found"]},{"type":"string","enum":["upstream_failed"]},{"type":"string","enum":["billing_not_configured"]},{"type":"string","enum":["checkout_failed"]},{"type":"string","enum":["missing_signature"]},{"type":"string","enum":["invalid_signature"]},{"type":"string","enum":["handler_failed"]},{"type":"string","enum":["internal_error"]},{"type":"string","enum":["auth_not_configured"]},{"type":"string","enum":["ebay_not_configured"]},{"type":"string","enum":["not_connected"]}]},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","required":["path","message"],"properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}}},"operationId":"postV1BrowserCookies","tags":["Browser"],"parameters":[],"summary":"Inventory cookies for a domain via the bridge client","description":"Synchronous: queues a `browser_op` with op=cookies, waits for the extension's background to call `chrome.cookies.getAll({ domain })`, returns metadata only (name, expiry, httpOnly, secure, sameSite). Cookie *values* are never returned. Use this to measure real session expiry — HttpOnly auth cookies (eBay's `ds2`/`npii`, PE's session) aren't visible to `document.cookie`, so DOM probing can't see when the session actually breaks. Caller can compute time-to-expiry from `earliestExpiresAt`.","requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"minLength":3,"maxLength":200,"type":"string"}}}}}}}}}}