{"openapi":"3.1.0","x-agent-instructions":{"readOnly":true,"whenToUse":["Retrieve the source-linked review corpus and separate rating snapshots for involve.me.","Retrieve documented implementation stories and reported outcomes for involve.me."],"notFor":["Accessing involve.me customer accounts, contacts, submissions or funnels.","Creating, editing or deleting product data."]},"info":{"title":"involve.me Reviews Evidence API","version":"1.0.0","description":"Public, read-only API for the review evidence and documented implementations published on involve.me Reviews. This is not the involve.me product API and does not expose customer accounts, funnels, contacts or submissions.","contact":{"name":"involve.me Reviews","url":"https://involvemereviews.com/contact","email":"office@involve.me"}},"externalDocs":{"description":"Developer documentation for involve.me Reviews","url":"https://involvemereviews.com/developers"},"servers":[{"url":"https://involvemereviews.com","description":"Production"}],"security":[],"paths":{"/api/v1/reviews":{"get":{"operationId":"listReviewEvidence","x-agent-tool-name":"list_review_evidence","summary":"List published involve.me review evidence","description":"Returns the current source-linked review corpus, separate platform rating snapshots, sentiment methodology and product-fit summary.","tags":["Evidence"],"security":[],"responses":{"200":{"description":"The published review evidence snapshot.","headers":{"Cache-Control":{"description":"Public cache policy for this published snapshot.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewEvidenceResponse"}}}},"404":{"description":"The requested API resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"405":{"description":"The endpoint does not support the requested HTTP method.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/api/v1/customer-stories":{"get":{"operationId":"listCustomerStories","x-agent-tool-name":"list_customer_stories","summary":"List documented involve.me implementations","description":"Returns source-linked customer and internal implementation stories, including use cases, outcomes and reported metrics when available.","tags":["Evidence"],"security":[],"responses":{"200":{"description":"The published implementation evidence snapshot.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerStoriesResponse"}}}},"404":{"description":"The requested API resource does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"405":{"description":"The endpoint does not support the requested HTTP method.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}}},"components":{"schemas":{"ApiError":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","status","resolution","docs_url"],"properties":{"code":{"type":"string","example":"RESOURCE_NOT_FOUND"},"message":{"type":"string","example":"No API resource exists at this path."},"status":{"type":"integer","example":404},"resolution":{"type":"string","example":"Use an endpoint listed in the OpenAPI specification."},"docs_url":{"type":"string","format":"uri","example":"https://involvemereviews.com/developers"}}}}},"RatingSnapshot":{"type":"object","additionalProperties":false,"required":["source","rating","best_rating","review_count","verified_on","url"],"properties":{"source":{"type":"string"},"rating":{"type":"number","minimum":0,"maximum":5},"best_rating":{"type":"number","const":5},"review_count":{"type":"integer","minimum":0},"verified_on":{"type":"string","format":"date"},"url":{"type":"string","format":"uri"}}},"ReviewRecord":{"type":"object","description":"A source-linked, paraphrased editorial record of a public review.","additionalProperties":true,"required":["id","source","sourceUrl","reviewer","date","useCase","sentiment","summary"],"properties":{"id":{"type":"string"},"source":{"type":"string","enum":["G2","Capterra","Trustpilot"]},"sourceUrl":{"type":"string","format":"uri"},"reviewer":{"type":"string"},"role":{"type":"string"},"segment":{"type":"string"},"date":{"type":"string","format":"date"},"rating":{"type":["number","null"],"minimum":0,"maximum":5},"useCase":{"type":"string"},"sentiment":{"type":"string","enum":["positive","mixed","critical"]},"summary":{"type":"string"},"caution":{"type":["string","null"]}}},"ReviewEvidenceResponse":{"type":"object","additionalProperties":true,"required":["canonical_url","entity","snapshot_date","rating_snapshots","review_record_count","review_records"],"properties":{"canonical_url":{"type":"string","format":"uri"},"human_readable_url":{"type":"string","format":"uri"},"entity":{"type":"object","additionalProperties":true},"snapshot_date":{"type":"string","format":"date"},"ratings_are_not_combined":{"type":"boolean","const":true},"rating_snapshots":{"type":"array","items":{"$ref":"#/components/schemas/RatingSnapshot"}},"review_record_count":{"type":"integer","minimum":0},"review_records":{"type":"array","items":{"$ref":"#/components/schemas/ReviewRecord"}}}},"CustomerStory":{"type":"object","description":"A source-linked vendor-published implementation record.","additionalProperties":true,"required":["customer","category","date","useCase","evidence","outcome","sourceUrl"],"properties":{"customer":{"type":"string"},"category":{"type":"string"},"date":{"type":"string","format":"date"},"useCase":{"type":"string"},"evidence":{"type":"string"},"outcome":{"type":"string"},"metric":{"type":["string","null"]},"sourceUrl":{"type":"string","format":"uri"}}},"CustomerStoriesResponse":{"type":"object","additionalProperties":true,"required":["canonical_url","entity","snapshot_date","story_count","stories"],"properties":{"canonical_url":{"type":"string","format":"uri"},"human_readable_url":{"type":"string","format":"uri"},"entity":{"type":"string","const":"involve.me"},"snapshot_date":{"type":"string","format":"date"},"story_count":{"type":"integer","minimum":0},"stories":{"type":"array","items":{"$ref":"#/components/schemas/CustomerStory"}}}}}},"tags":[{"name":"Evidence","description":"Published, read-only evidence about involve.me."}]}