> ## Documentation Index > Fetch the complete documentation index at: https://docs.beliefstate.ai/llms.txt > Use this file to discover all available pages before exploring further. # Find tickers with available research > Without q, returns released direct ticker coverage, belief and investor counts, and observation dates. With q, searches the current SEC registered US company directory by ticker or company name and labels direct research availability. Directory coverage is not global. Public discovery is free; omit as_of when searching. Set tracked_only=true with a customer Bearer credential to read the account's active watchlist; omit as_of in that mode. ## OpenAPI ````yaml https://beliefstate.ai/openapi.json get /v1/tickers openapi: 3.1.0 info: title: BeliefState Intelligence API version: '2026-10-05' description: >- Four read only research resources: Brief for ticker research, Beliefs for records and evidence, Sources for the research directory, and Tickers for coverage. REST research uses API keys; AI clients use OAuth through /mcp. servers: - url: https://beliefstate.ai security: [] tags: - name: Brief - name: Beliefs - name: Sources - name: Tickers externalDocs: description: Connect an AI url: https://beliefstate.ai/agents paths: /v1/tickers: get: tags: - Tickers summary: Find tickers with available research description: >- Without q, returns released direct ticker coverage, belief and investor counts, and observation dates. With q, searches the current SEC registered US company directory by ticker or company name and labels direct research availability. Directory coverage is not global. Public discovery is free; omit as_of when searching. Set tracked_only=true with a customer Bearer credential to read the account's active watchlist; omit as_of in that mode. operationId: getTickers parameters: - in: query name: q required: false schema: description: >- Search the current SEC company directory by ticker or name, independently of direct research coverage. Omit as_of. type: string minLength: 1 maxLength: 80 - in: query name: as_of required: false schema: 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))$ - in: query name: tracked_only required: false schema: description: >- Return only your account's actively tracked tickers. Requires customer authentication; omit as_of. type: boolean responses: '200': description: Successful public discovery response content: application/json: schema: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: discovery: type: object properties: query: type: string scope: type: string const: sec_registered_us_listings source_url: type: string format: uri results: type: array items: type: object properties: ticker: type: string name: type: string exchange: type: - string - 'null' cik: type: number direct_research: type: boolean required: - ticker - name - exchange - cik - direct_research additionalProperties: false required: - query - scope - source_url - results additionalProperties: false tracking: type: object properties: limit: type: integer minimum: 0 maximum: 9007199254740991 active: type: integer minimum: 0 maximum: 9007199254740991 paused: type: array items: type: string unavailable: type: array items: type: string related_or_pending: type: array items: type: string manage_url: type: string required: - limit - active - paused - unavailable - manage_url additionalProperties: false schema_version: type: string const: '1' generated_at: 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))$ 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))$ resource: type: string const: beliefs tickers: type: array items: type: string minLength: 1 totals: type: object properties: ticker_count: type: integer minimum: 0 maximum: 9007199254740991 belief_count: type: integer minimum: 0 maximum: 9007199254740991 required: - ticker_count - belief_count additionalProperties: false coverage: type: array items: type: object properties: ticker: type: string minLength: 1 security_id: type: string minLength: 1 security_name: type: string minLength: 1 release_state: type: string const: released release_effective_at: 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_count: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 investor_count: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 first_belief_observed_at: 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))$ latest_belief_observed_at: 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))$ required: - ticker - security_id - security_name - release_state - release_effective_at - belief_count - investor_count - first_belief_observed_at - latest_belief_observed_at additionalProperties: false required: - schema_version - generated_at - as_of - resource - tickers - totals - coverage additionalProperties: false '400': description: Invalid input content: application/json: schema: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: error: type: object properties: code: type: string message: type: string recovery: type: - string - 'null' retryable: type: boolean required: - code - message - recovery - retryable additionalProperties: false required: - error additionalProperties: false '503': description: Stored intelligence temporarily unavailable content: application/json: schema: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: error: type: object properties: code: type: string message: type: string recovery: type: - string - 'null' retryable: type: boolean required: - code - message - recovery - retryable additionalProperties: false required: - error additionalProperties: false security: [] ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.