{"uid":"cap_aIINkwxen0DLNmyjjquET","slug":"beliefstate-list-research-visuals-3e6c86a6","name":"BeliefState List Research Visuals","description":"The first AI-powered platform for top analyst research. Get theses from top analysts, dated evidence, and available outcomes for your AI.","url":"https://beliefstate.ai/v1/research/list_research_visuals?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{"as_of":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"belief_id":{"type":"string","maxLength":128,"minLength":1},"visual_offset":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"Continue saved visual descriptors using next_visual_offset."},"context_assessment_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Open a neutral engine context assessment returned by a brief or ordered change. It is not an author Belief."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"type":"string","const":"POST"},"bodyType":{"type":"string","const":"json"}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","$comment":"Envelope excerpt only. Complete response schema: https://beliefstate.ai/v1/research/list_research_visuals?schema=output","required":["schema_version","generated_at","as_of"],"properties":{"as_of":{"type":"string","format":"date-time"},"generated_at":{"type":"string","format":"date-time"},"schema_version":{"type":"string","const":"1"}}}}}}},"responseSchema":{"type":"json","example":{"as_of":"2026-10-24T00:00:00.000Z","generated_at":"2026-10-24T00:00:00.000Z","schema_version":"1"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ksz2C-mJfqiqUtlfSYi6e","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a paginated list of visual descriptors (charts, diagrams, exhibits) associated with analyst research beliefs on the BeliefState platform.","exampleAgentPrompt":"Pull up all the research visuals and charts associated with belief ID 'AAPL-bull-2024' on BeliefState as of October 1st, 2024, starting from the beginning.","exampleUseCases":[{"title":"Reviewing analyst charts for an investment thesis","prompt":"Show me all the charts and visual exhibits attached to belief ID 'TSLA-longterm-growth' on BeliefState as of January 1st, 2025."},{"title":"Paginating through large visual research sets","prompt":"I already fetched the first batch of visuals for belief 'NVDA-semiconductor-q3' — now get me the next page starting at offset 20 as of today."},{"title":"Retrieving visuals for a context assessment","prompt":"Fetch all the research visuals linked to context assessment ID '550e8400-e29b-41d4-a716-446655440000' on BeliefState, dated as of March 15th, 2025."}],"resultDescription":"Returns a JSON envelope containing a list of visual descriptors (charts, diagrams, research exhibits) associated with the requested belief or context assessment, along with pagination metadata (next_visual_offset), a generated_at timestamp, an as_of timestamp, and a schema_version field. Full response schema is available at the BeliefState schema endpoint.","failureModes":["Invalid belief_id (not found or wrong format) returns an empty list or error","Malformed as_of datetime that doesn't match the strict ISO 8601 UTC pattern returns a validation error","Invalid context_assessment_id UUID format returns a schema validation error","visual_offset out of range returns empty results or an error","Missing required body fields returns a 400 bad request","Payment not included or insufficient USDC returns a 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to enumerate or paginate through visual artifacts (charts, graphs, exhibits) attached to a specific analyst belief or context assessment on BeliefState. Prefer this over general research endpoints when you specifically need visual/chart metadata rather than textual thesis content or cited overviews.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:38:58.415Z","isFirstParty":false,"canonicalSlug":"beliefstate-list-research-visuals-3e6c86a6"}