> ## 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 research sources by name, domain, or source ID > Search with q, filter by domain or ticker, or select one source_id. Every result uses the same source record array and pagination envelope. An unknown source ID returns an empty array. Indexed sources are not automatically authorized corpus material. ## OpenAPI ````yaml https://beliefstate.ai/openapi.json get /v1/sources 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/sources: get: tags: - Sources summary: Find research sources by name, domain, or source ID description: >- Search with q, filter by domain or ticker, or select one source_id. Every result uses the same source record array and pagination envelope. An unknown source ID returns an empty array. Indexed sources are not automatically authorized corpus material. operationId: listSources parameters: - in: header name: X-Request-ID required: false description: >- Stable 1–128 character ID for an idempotent retry. Reuse the same value only for the same logical request. schema: type: string maxLength: 128 pattern: ^[A-Za-z0-9._~:+/=-]+$ - in: query name: q required: false schema: type: string minLength: 1 maxLength: 200 - in: query name: source_id required: false schema: 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)$ - in: query name: ticker required: false schema: type: string minLength: 1 maxLength: 32 pattern: ^[A-Za-z0-9.^-]+$ - in: query name: domain required: false schema: type: string enum: - semiconductors_hardware - software_ai - biotechnology_pharma - healthcare - energy - financials - industrials - consumer - materials_mining - communication_media - real_estate - utilities - in: query name: strategy required: false schema: type: string enum: - special_situations - event_driven - turnaround - microcap - small_cap - compounder - deep_value - growth - activist - short_research - international - distressed - in: query name: accessType required: false schema: type: string enum: - free_public - free_registration - freemium - paid_subscription - paid_enterprise - licensed_commercial - private_permissioned - unknown - blocked - in: query name: acquisitionTier required: false schema: type: string enum: - P0_FREE - P1_FREE - P0_PAID_WATCH - P1_PAID_WATCH - LICENSE_REQUIRED - PRIVATE_PERMISSIONED - HOLD - BLOCKED - in: query name: researchDensity required: false schema: type: string enum: - very_high - high - medium - low - unknown - in: query name: professional required: false schema: type: boolean - in: query name: corpusEligible required: false schema: type: boolean - in: query name: freeOnly required: false schema: type: boolean - in: query name: limit required: false schema: default: 25 type: integer minimum: 1 maximum: 100 - in: query name: cursor required: false schema: 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)$ responses: '200': description: Successful read only response content: application/json: schema: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: schema_version: type: string const: '1' generated_at: type: string data: type: array items: type: object propertyNames: type: string additionalProperties: {} page: type: object properties: limit: type: integer minimum: -9007199254740991 maximum: 9007199254740991 nextCursor: anyOf: - 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)$ - type: 'null' total: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - limit - nextCursor - total additionalProperties: false required: - schema_version - generated_at - data - page 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 '401': description: Authentication failed 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 '402': description: Paid access required 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 '404': description: Security 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 '409': description: Duplicate request ID 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: - ApiKeyBearer: [] components: securitySchemes: ApiKeyBearer: type: http scheme: bearer bearerFormat: BeliefState API key description: >- Developer API key created through /auth.md. Never paste it into a retail chat. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.