> ## Documentation Index > Fetch the complete documentation index at: https://docs.passu.ai/llms.txt > Use this file to discover all available pages before exploring further. # List analyses > List analyses. At least one of `event_id`, `company_id`, or `sector_id` is required — the endpoint returns 422 if none are supplied. ## OpenAPI ````yaml /openapi.json get /v1/analyses openapi: 3.1.0 info: title: Passu Public API summary: >- External read-only API for sectors, companies, events, metrics, and analyses. description: >- The Passu Public API is a read-only external API intended for server-to-server integrations. version: v1 servers: - url: https://api.passu.ai description: Production security: [] tags: - name: auth - name: sectors - name: companies - name: events - name: metrics - name: analyses paths: /v1/analyses: get: tags: - analyses summary: List analyses description: >- List analyses. At least one of `event_id`, `company_id`, or `sector_id` is required — the endpoint returns 422 if none are supplied. operationId: listAnalyses parameters: - name: event_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' description: Filter analyses by event id. title: Event Id description: Filter analyses by event id. - name: company_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' description: Filter analyses by company id. title: Company Id description: Filter analyses by company id. - name: sector_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' description: Filter analyses by sector id. title: Sector Id description: Filter analyses by sector id. - name: analysis_type in: query required: false schema: anyOf: - $ref: '#/components/schemas/AnalysisType' - type: 'null' description: Filter analyses by type. title: Analysis Type description: Filter analyses by type. - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' description: Opaque cursor for pagination. title: Cursor description: Opaque cursor for pagination. - name: limit in: query required: false schema: type: integer maximum: 200 minimum: 1 description: Maximum number of records to return. default: 50 title: Limit description: Maximum number of records to return. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/AnalysisListResponse' '401': description: Authentication failed. content: application/json: schema: $ref: '#/components/schemas/Problem' '403': description: Authenticated but not permitted to access this resource. content: application/json: schema: $ref: '#/components/schemas/Problem' '422': description: Request is missing a required filter. content: application/json: schema: $ref: '#/components/schemas/Problem' security: - HTTPBearer: [] components: schemas: AnalysisType: type: string enum: - EVENT - COMPANY_QUARTERLY - SECTOR_QUARTERLY title: AnalysisType description: |- Public analysis-type enum mirroring the hierarchy level. Event sub-kind (earnings / conference / news) is derivable from the linked corporate event and deliberately not reflected here. AnalysisListResponse: properties: data: items: $ref: '#/components/schemas/Analysis' type: array title: Data next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor has_more: type: boolean title: Has More type: object required: - data - has_more title: AnalysisListResponse Problem: properties: type: type: string title: Type title: type: string title: Title status: type: integer title: Status detail: type: string title: Detail request_id: type: string title: Request Id instance: anyOf: - type: string - type: 'null' title: Instance errors: anyOf: - items: $ref: '#/components/schemas/ValidationErrorItem' type: array - type: 'null' title: Errors type: object required: - type - title - status - detail - request_id title: Problem Analysis: properties: id: type: string format: uuid title: Id analysis_type: $ref: '#/components/schemas/AnalysisType' scope: oneOf: - $ref: '#/components/schemas/EventAnalysisScope' - $ref: '#/components/schemas/CompanyQuarterAnalysisScope' - $ref: '#/components/schemas/SectorQuarterAnalysisScope' title: Scope discriminator: propertyName: scope_type mapping: COMPANY_QUARTER: $ref: '#/components/schemas/CompanyQuarterAnalysisScope' EVENT: $ref: '#/components/schemas/EventAnalysisScope' SECTOR_QUARTER: $ref: '#/components/schemas/SectorQuarterAnalysisScope' sections: items: $ref: '#/components/schemas/AnalysisSection' type: array title: Sections updated_at: type: string format: date-time title: Updated At type: object required: - id - analysis_type - scope - updated_at title: Analysis ValidationErrorItem: properties: field: type: string title: Field message: type: string title: Message type: object required: - field - message title: ValidationErrorItem EventAnalysisScope: properties: scope_type: type: string const: EVENT title: Scope Type default: EVENT event_id: type: string format: uuid title: Event Id type: object required: - event_id title: EventAnalysisScope CompanyQuarterAnalysisScope: properties: scope_type: type: string const: COMPANY_QUARTER title: Scope Type default: COMPANY_QUARTER company_id: type: string format: uuid title: Company Id fiscal_year: type: integer title: Fiscal Year fiscal_quarter: type: integer title: Fiscal Quarter type: object required: - company_id - fiscal_year - fiscal_quarter title: CompanyQuarterAnalysisScope SectorQuarterAnalysisScope: properties: scope_type: type: string const: SECTOR_QUARTER title: Scope Type default: SECTOR_QUARTER sector_id: type: string format: uuid title: Sector Id fiscal_year: type: integer title: Fiscal Year fiscal_quarter: type: integer title: Fiscal Quarter type: object required: - sector_id - fiscal_year - fiscal_quarter title: SectorQuarterAnalysisScope AnalysisSection: properties: section_type: $ref: '#/components/schemas/AnalysisSectionType' sentences: items: $ref: '#/components/schemas/Sentence' type: array title: Sentences type: object required: - section_type title: AnalysisSection AnalysisSectionType: type: string enum: - OPERATIONAL_SUMMARY - CREDIT_SUMMARY - IMPORTANT_CHANGES - TAKEAWAYS title: AnalysisSectionType description: Public analysis-section-type enum. Decoupled from the ORM enum. Sentence: properties: text: type: string title: Text quotes: items: $ref: '#/components/schemas/Quote' type: array title: Quotes type: object required: - text title: Sentence Quote: properties: quote_type: $ref: '#/components/schemas/QuoteType' fact_id: anyOf: - type: string format: uuid - type: 'null' title: Fact Id text: anyOf: - type: string - type: 'null' title: Text author: anyOf: - type: string - type: 'null' title: Author title: anyOf: - type: string - type: 'null' title: Title table_name: anyOf: - type: string - type: 'null' title: Table Name row_names: items: type: string type: array title: Row Names type: object required: - quote_type title: Quote QuoteType: type: string enum: - TEXT - TABLE - XBRL_FACT title: QuoteType description: >- Public quote-type enum. Owned by the public contract, decoupled from the ORM enum. securitySchemes: HTTPBearer: type: http scheme: bearer bearerFormat: JWT ````