{"openapi":"3.1.0","info":{"title":"Vruum public buyer sales","version":"1.1.0"},"paths":{"/api/public/sellers/{seller_id}/offers":{"get":{"tags":["buyer-sales"],"summary":"Buyer List Offers","operationId":"buyer_list_offers","parameters":[{"name":"seller_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Seller Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PublicOffer"},"title":"Response Buyer List Offers"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/sellers/{seller_id}/offers/{offer_id}":{"get":{"tags":["buyer-sales"],"summary":"Buyer Get Offer","operationId":"buyer_get_offer","parameters":[{"name":"seller_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Seller Id"}},{"name":"offer_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Offer Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicOffer"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/sellers/{seller_id}/sessions":{"post":{"tags":["buyer-sales"],"summary":"Buyer Start Evaluation","operationId":"buyer_start_evaluation","parameters":[{"name":"seller_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Seller Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartEvaluation"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionCredential"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/sellers/{seller_id}/evaluation":{"get":{"tags":["buyer-sales"],"summary":"Buyer Get Evaluation","operationId":"buyer_get_evaluation","security":[{"HTTPBearer":[]}],"parameters":[{"name":"seller_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Seller Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Evaluation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/sellers/{seller_id}/questions":{"post":{"tags":["buyer-sales"],"summary":"Buyer Ask Seller","operationId":"buyer_ask_seller","security":[{"HTTPBearer":[]}],"parameters":[{"name":"seller_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Seller Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/sellers/{seller_id}/inquiries":{"post":{"tags":["buyer-sales"],"summary":"Buyer Request Next Step","operationId":"buyer_request_next_step","security":[{"HTTPBearer":[]}],"parameters":[{"name":"seller_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Seller Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InquiryRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InquiryReceipt"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/offers":{"get":{"tags":["buyer-sales"],"summary":"Buyer Search Offers","operationId":"buyer_search_offers","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":300,"default":"","title":"Q"}},{"name":"pricing_type","in":"query","required":false,"schema":{"anyOf":[{"enum":["fixed","commission","hybrid","custom"],"type":"string"},{"type":"null"}],"title":"Pricing Type"}},{"name":"currency","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^[A-Z]{3}$"},{"type":"null"}],"title":"Currency"}},{"name":"billing_period","in":"query","required":false,"schema":{"anyOf":[{"enum":["one_time","monthly","quarterly","annual"],"type":"string"},{"type":"null"}],"title":"Billing Period"}},{"name":"max_price_minor","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":1000000000000,"minimum":0},{"type":"null"}],"title":"Max Price Minor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferSearchResults"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/offers/sitemap":{"get":{"tags":["buyer-sales"],"summary":"Buyer Offer Sitemap","operationId":"buyer_offer_sitemap","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","maximum":49999,"minimum":0,"default":0,"title":"Page"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferSitemap"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Answer":{"properties":{"request_id":{"type":"string","format":"uuid","title":"Request Id"},"version":{"type":"integer","title":"Version"},"question":{"type":"string","title":"Question"},"topic":{"type":"string","title":"Topic"},"status":{"type":"string","enum":["answered","unknown","needs_review"],"title":"Status"},"text":{"type":"string","title":"Text"},"facts":{"anyOf":[{"$ref":"#/components/schemas/PublicFacts"},{"type":"null"}]},"source_fields":{"items":{"type":"string"},"type":"array","title":"Source Fields"},"source_basis":{"type":"string","const":"seller_reported","title":"Source Basis","default":"seller_reported"}},"additionalProperties":false,"type":"object","required":["request_id","version","question","topic","status","text","source_fields"],"title":"Answer"},"Evaluation":{"properties":{"session_id":{"type":"string","format":"uuid","title":"Session Id"},"offer":{"$ref":"#/components/schemas/PublicOffer"},"answers":{"items":{"$ref":"#/components/schemas/Answer"},"type":"array","title":"Answers"},"inquiry":{"anyOf":[{"$ref":"#/components/schemas/InquiryReceipt"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["session_id","offer","answers"],"title":"Evaluation"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"InquiryReceipt":{"properties":{"inquiry_id":{"type":"string","format":"uuid","title":"Inquiry Id"},"version":{"type":"integer","title":"Version"},"status":{"type":"string","enum":["received","replied","declined"],"title":"Status"},"reply":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reply"},"identity_verified":{"type":"boolean","const":false,"title":"Identity Verified","default":false}},"additionalProperties":false,"type":"object","required":["inquiry_id","version","status"],"title":"InquiryReceipt"},"InquiryRequest":{"properties":{"request_id":{"type":"string","format":"uuid","title":"Request Id"},"version":{"type":"integer","minimum":1.0,"title":"Version"},"next_step":{"type":"string","enum":["demo","trial","proposal","other"],"title":"Next Step"},"requirements":{"type":"string","maxLength":4000,"minLength":1,"title":"Requirements"},"contact":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Contact"},"share_with_seller":{"type":"boolean","const":true,"title":"Share With Seller"}},"additionalProperties":false,"type":"object","required":["request_id","version","next_step","requirements","share_with_seller"],"title":"InquiryRequest"},"OfferSearchHit":{"properties":{"offer":{"$ref":"#/components/schemas/PublicOffer"},"page_url":{"type":"string","title":"Page Url"},"match_basis":{"type":"string","enum":["published_keywords","public_listing"],"title":"Match Basis"}},"additionalProperties":false,"type":"object","required":["offer","page_url","match_basis"],"title":"OfferSearchHit"},"OfferSearchResults":{"properties":{"items":{"items":{"$ref":"#/components/schemas/OfferSearchHit"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"scope":{"type":"string","const":"current_public_offers","title":"Scope","default":"current_public_offers"},"assessment":{"type":"string","title":"Assessment","default":"Matches published keywords and explicit pricing filters only. Suitability, security and final terms are not assessed. Seller claims are unverified."}},"additionalProperties":false,"type":"object","required":["items"],"title":"OfferSearchResults"},"OfferSitemap":{"properties":{"entries":{"items":{"$ref":"#/components/schemas/OfferSitemapEntry"},"type":"array","title":"Entries"},"total":{"type":"integer","title":"Total"},"page_size":{"type":"integer","const":1000,"title":"Page Size"}},"additionalProperties":false,"type":"object","required":["entries","total","page_size"],"title":"OfferSitemap"},"OfferSitemapEntry":{"properties":{"seller_id":{"type":"string","format":"uuid","title":"Seller Id"},"offer_id":{"type":"string","format":"uuid","title":"Offer Id"},"published_at":{"type":"string","format":"date-time","title":"Published At"}},"additionalProperties":false,"type":"object","required":["seller_id","offer_id","published_at"],"title":"OfferSitemapEntry"},"PublicFacts":{"properties":{"pricing_type":{"type":"string","enum":["fixed","commission","hybrid","custom"],"title":"Pricing Type","default":"fixed"},"list_price_minor":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"List Price Minor"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","title":"Currency","default":"USD"},"billing_period":{"anyOf":[{"type":"string","enum":["one_time","monthly","quarterly","annual"]},{"type":"null"}],"title":"Billing Period"},"commission_rate_bps":{"anyOf":[{"type":"integer","maximum":10000.0,"minimum":1.0},{"type":"null"}],"title":"Commission Rate Bps"},"commission_basis":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Commission Basis"},"pricing_notes":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Pricing Notes"},"seller_name":{"type":"string","title":"Seller Name"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"monetization_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Monetization Model"}},"additionalProperties":false,"type":"object","required":["seller_name","name"],"title":"PublicFacts"},"PublicOffer":{"properties":{"seller_id":{"type":"string","format":"uuid","title":"Seller Id"},"offer_id":{"type":"string","format":"uuid","title":"Offer Id"},"version":{"type":"integer","title":"Version"},"published_at":{"type":"string","format":"date-time","title":"Published At"},"facts":{"$ref":"#/components/schemas/PublicFacts"},"source_basis":{"type":"string","const":"seller_reported","title":"Source Basis","default":"seller_reported"},"policy":{"type":"string","const":"public_facts_v1","title":"Policy","default":"public_facts_v1"}},"additionalProperties":false,"type":"object","required":["seller_id","offer_id","version","published_at","facts"],"title":"PublicOffer"},"QuestionRequest":{"properties":{"request_id":{"type":"string","format":"uuid","title":"Request Id"},"version":{"type":"integer","minimum":1.0,"title":"Version"},"topic":{"type":"string","enum":["overview","pricing","fit","security","terms","other"],"title":"Topic"},"question":{"type":"string","maxLength":2000,"minLength":1,"title":"Question"}},"additionalProperties":false,"type":"object","required":["request_id","version","topic","question"],"title":"QuestionRequest"},"SessionCredential":{"properties":{"session_id":{"type":"string","format":"uuid","title":"Session Id"},"token":{"type":"string","title":"Token"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"additionalProperties":false,"type":"object","required":["session_id","token","expires_at"],"title":"SessionCredential"},"StartEvaluation":{"properties":{"offer_id":{"type":"string","format":"uuid","title":"Offer Id"},"version":{"type":"integer","minimum":1.0,"title":"Version"}},"additionalProperties":false,"type":"object","required":["offer_id","version"],"title":"StartEvaluation"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}}}