{"openapi":"3.0.2","paths":{"/v1/search":{"post":{"tags":[],"parameters":[],"operationId":"search","requestBody":{"description":"Body","content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":256},"page":{"type":"integer","minimum":1},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100}},"required":["q"]}}}},"responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"listing_id":{"type":"string","format":"uuid"},"vendor_display_name":{"type":"string"},"vendor_slug":{"type":"string"},"vendor_site_url":{"type":"string","nullable":true},"listing_slug":{"type":"string"},"kind":{"type":"string","enum":["service"]},"fulfillment_kind":{"type":"string","enum":["proxy_http","external"]},"category_name":{"type":"string"},"category_slug":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","minLength":1,"maxLength":1000},"body":{"type":"string","minLength":1,"maxLength":4000},"pricing_model":{"type":"string","enum":["per_call_fixed","subscription","quote"]},"price_micros":{"type":"integer","minimum":0,"nullable":true},"period":{"default":null,"type":"string","enum":["month"],"nullable":true},"media":{"type":"array","items":{"type":"object","properties":{"media_kind":{"type":"string","enum":["image"]},"asset_ref":{"type":"string","minLength":1},"alt_text":{"type":"string"},"sort_order":{"type":"integer","minimum":0}},"required":["media_kind","asset_ref","alt_text","sort_order"]}},"published_at":{"type":"string","format":"date-time"},"star_count":{"type":"integer","minimum":0}},"required":["listing_id","vendor_display_name","vendor_slug","vendor_site_url","listing_slug","kind","fulfillment_kind","category_name","category_slug","title","summary","description","body","pricing_model","price_micros","media","published_at","star_count"]}},"total_count":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}},"required":["data","total_count","has_more"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"402":{"description":"402","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["payment_required"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["forbidden"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"429":{"description":"429","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["rate_limited"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"503":{"description":"503","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}}}}},"/v1/details/{vendor_slug}/{listing_slug}":{"get":{"tags":[],"parameters":[{"name":"vendor_slug","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[a-z0-9-]+$"}},{"name":"listing_slug","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[a-z0-9-]+$"}}],"operationId":"details","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"discriminator":{"propertyName":"kind"},"oneOf":[{"type":"object","properties":{"listing_id":{"type":"string","format":"uuid"},"vendor_display_name":{"type":"string"},"vendor_slug":{"type":"string"},"vendor_site_url":{"type":"string","nullable":true},"listing_slug":{"type":"string"},"kind":{"type":"string","enum":["service"]},"fulfillment_kind":{"type":"string","enum":["proxy_http","external"]},"category_name":{"type":"string"},"category_slug":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","minLength":1,"maxLength":1000},"body":{"type":"string","minLength":1,"maxLength":4000},"pricing_model":{"type":"string","enum":["per_call_fixed","subscription","quote"]},"period":{"default":null,"type":"string","enum":["month"],"nullable":true},"media":{"type":"array","items":{"type":"object","properties":{"media_kind":{"type":"string","enum":["image"]},"asset_ref":{"type":"string","minLength":1},"alt_text":{"type":"string"},"sort_order":{"type":"integer","minimum":0}},"required":["media_kind","asset_ref","alt_text","sort_order"]}},"published_at":{"type":"string","format":"date-time"},"star_count":{"type":"integer","minimum":0},"endpoints":{"type":"object","properties":{"spec_url":{"type":"string","format":"uri"},"operations":{"type":"array","items":{"type":"object","properties":{"operation_id":{"type":"string"},"price_label":{"type":"string"}},"required":["operation_id","price_label"]}}},"required":["spec_url","operations"],"nullable":true},"listing_url":{"type":"string","format":"uri"},"price_label":{"type":"string"},"next_step":{"type":"string"}},"required":["listing_id","vendor_display_name","vendor_slug","vendor_site_url","listing_slug","kind","fulfillment_kind","category_name","category_slug","title","summary","description","body","pricing_model","media","published_at","star_count","endpoints","listing_url","price_label","next_step"]}]}},"required":["data"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"402":{"description":"402","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["payment_required"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["forbidden"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"429":{"description":"429","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["rate_limited"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"503":{"description":"503","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}}}}},"/v1/entitlements":{"get":{"tags":[],"parameters":[{"name":"kind","in":"query","schema":{"type":"string","enum":["subscription"]}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"limit","in":"query","schema":{"default":20,"type":"integer","minimum":1,"maximum":100}}],"operationId":"entitlements","responses":{"200":{"description":"200","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"entitlement_id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["subscription"]},"status":{"type":"string","enum":["active","past_due","cancelled","expired"]},"listing_id":{"type":"string","format":"uuid"},"listing_version_id":{"type":"string","format":"uuid"},"vendor_slug":{"type":"string"},"listing_slug":{"type":"string"},"version_number":{"type":"integer","nullable":true},"title":{"type":"string"},"access_until":{"type":"string","nullable":true},"created_at":{"type":"string"}},"required":["entitlement_id","kind","status","listing_id","listing_version_id","vendor_slug","listing_slug","version_number","title","access_until","created_at"]}},"total_count":{"type":"integer","minimum":0},"has_more":{"type":"boolean"}},"required":["data","total_count","has_more"]}}}},"400":{"description":"400","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"401":{"description":"401","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthorized"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"402":{"description":"402","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["payment_required"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"403":{"description":"403","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["forbidden"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"404":{"description":"404","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["not_found"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"429":{"description":"429","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["rate_limited"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"500":{"description":"500","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["internal_error"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}},"503":{"description":"503","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["service_unavailable"]},"message":{"type":"string","minLength":1}},"required":["code","message"]}},"required":["error"]}}}}}}}},"info":{"title":"OneStop REST API","version":"1.0.0"}}