{"openapi":"3.1.0","info":{"title":"Wrivid Research Catalog API","version":"1.0.0","description":"Metadata-only access to Wrivid's public investment-research catalog. Access does not grant rights to reproduce source documents, report text, or commercially redistribute publisher material."},"servers":[{"url":"https://wrivid.com/"}],"paths":{"/api/reports":{"get":{"operationId":"listReports","summary":"List public research catalog metadata","description":"Returns public metadata and provenance links only. Full text, raw documents, storage keys, ingestion data, internal statuses, and raw metadata are excluded.","parameters":[{"name":"source","in":"query","description":"Lowercase publisher slug.","schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"example":"goldman-sachs-research"},{"name":"timeframe","in":"query","description":"All history or a trailing whole-month window.","schema":{"type":"string","pattern":"^(all|[1-9][0-9]{0,2}m)$","default":"24m"},"examples":{"all":{"value":"all"},"twoYears":{"value":"24m"}}},{"name":"includeHistory","in":"query","description":"When true and timeframe is omitted, do not apply the default 24-month window.","schema":{"type":"boolean","default":false}},{"name":"limit","in":"query","description":"Page size, clamped to 200.","schema":{"type":"integer","minimum":1,"maximum":200,"default":25}},{"name":"offset","in":"query","description":"Zero-based offset into the stable filtered catalog.","schema":{"type":"integer","minimum":0,"default":0}},{"name":"sort","in":"query","schema":{"type":"string","enum":["newest","oldest","alpha"],"default":"newest"}},{"name":"type","in":"query","description":"Exact report-type filter retained for compatibility.","schema":{"type":"string"}},{"name":"from","in":"query","description":"Optional inclusive publication-date lower bound.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","description":"Optional inclusive publication-date upper bound.","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"A page of catalog metadata.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogResponse"}}}},"400":{"description":"Invalid query parameter or unknown source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request rate exceeded.","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Catalog service failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Source":{"type":"object","additionalProperties":false,"required":["name","slug"],"properties":{"name":{"type":"string"},"slug":{"type":"string"}}},"Report":{"type":"object","additionalProperties":false,"required":["id","slug","title","source","type","publishedAt","url","sourceUrl","summary"],"properties":{"id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"title":{"type":"string"},"source":{"$ref":"#/components/schemas/Source"},"type":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"url":{"type":"string","format":"uri"},"sourceUrl":{"type":"string","format":"uri"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"Pagination":{"type":"object","additionalProperties":false,"required":["total","limit","offset","nextOffset","hasMore"],"properties":{"total":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":200},"offset":{"type":"integer","minimum":0},"nextOffset":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]},"hasMore":{"type":"boolean"}}},"CatalogResponse":{"type":"object","additionalProperties":false,"required":["reports","pagination"],"properties":{"reports":{"type":"array","items":{"$ref":"#/components/schemas/Report"}},"pagination":{"$ref":"#/components/schemas/Pagination"}}},"Error":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"string"}}}}}}