{"openapi":"3.1.0","info":{"title":"Vanta Public Knowledge API","version":"1.0.0","description":"Approved public facts, no authentication or per-request AI. Read-only; 60 requests/minute/IP/server instance. Cite canonicalUrl and reviewedAt; contact Vanta for unconfirmed facts."},"servers":[{"url":"https://vantasystems.ai/api"}],"security":[],"paths":{"/v1/knowledge":{"get":{"operationId":"listPublicKnowledge","tags":["knowledge"],"summary":"Search approved public knowledge","security":[],"description":"Read-only public facts. No API key. Maximum 60 requests per minute per IP per server instance. Cite canonicalUrl; do not infer guarantees.","parameters":[{"name":"locale","in":"query","schema":{"type":"string","enum":["en","hu"],"default":"en"}},{"name":"q","in":"query","schema":{"type":"string","maxLength":200}},{"name":"industry","in":"query","schema":{"type":"string","enum":["healthcare","legal","financial-services","logistics-distribution"]}},{"name":"service","in":"query","schema":{"type":"string","enum":["customer-experience","knowledge-and-automation","private-ai"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}}],"responses":{"200":{"description":"Published knowledge and current offers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeSearchResult"}}}},"400":{"$ref":"#/components/responses/KnowledgeBadRequest"},"405":{"$ref":"#/components/responses/KnowledgeReadOnly"},"429":{"$ref":"#/components/responses/KnowledgeRateLimited"}}}},"/v1/knowledge/openapi.json":{"get":{"operationId":"getPublicKnowledgeContract","tags":["knowledge"],"summary":"Public read-only knowledge API contract","security":[],"responses":{"200":{"description":"OpenAPI document containing public knowledge operations only","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"429":{"$ref":"#/components/responses/KnowledgeRateLimited"}}}},"/v1/knowledge/{id}":{"get":{"operationId":"getPublicKnowledge","tags":["knowledge"],"summary":"Read a published knowledge entry","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]+$","maxLength":80}},{"name":"locale","in":"query","schema":{"type":"string","enum":["en","hu"],"default":"en"}}],"responses":{"200":{"description":"Approved localized entry with canonical citations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeEntry"}}}},"400":{"$ref":"#/components/responses/KnowledgeBadRequest"},"404":{"description":"Entry not found or not published","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeError"}}}},"405":{"$ref":"#/components/responses/KnowledgeReadOnly"},"429":{"$ref":"#/components/responses/KnowledgeRateLimited"}}}}},"components":{"schemas":{"KnowledgeSearchResult":{"type":"object","required":["items","total","limit","offset","locale","offers"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeEntry"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"locale":{"type":"string","enum":["en","hu"]},"offers":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeOffer"}}}},"KnowledgeEntry":{"type":"object","required":["id","locale","title","summary","sections","limitations","services","industries","sources","canonicalUrl","reviewedAt","nextStep"],"properties":{"id":{"type":"string"},"locale":{"type":"string","enum":["en","hu"]},"title":{"type":"string"},"summary":{"type":"string"},"sections":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeSection"}},"limitations":{"type":"array","items":{"type":"string"}},"services":{"type":"array","items":{"type":"string"}},"industries":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"string","format":"uri"}},"canonicalUrl":{"type":"string","format":"uri"},"reviewedAt":{"type":"string"},"nextStep":{"type":"string"}}},"KnowledgeSection":{"type":"object","required":["heading","body"],"properties":{"heading":{"type":"string"},"body":{"type":"string"}}},"KnowledgeOffer":{"type":"object","required":["id","title","priceLabel","summary","deliverables","cta","price","currency","href","limitation"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"priceLabel":{"type":"string"},"summary":{"type":"string"},"deliverables":{"type":"array","items":{"type":"string"}},"cta":{"type":"string"},"price":{"type":"number"},"currency":{"type":"string","enum":["USD"]},"href":{"type":"string"},"limitation":{"type":"string"}}},"KnowledgeError":{"type":"object","required":["error"],"properties":{"error":{"type":"string"}}}},"responses":{"KnowledgeBadRequest":{"description":"Invalid or unsupported query parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeError"}}}},"KnowledgeReadOnly":{"description":"Only GET and HEAD are supported","headers":{"Allow":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeError"}}}},"KnowledgeRateLimited":{"description":"Rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeError"}}}}}}}