openapi: 3.1.0
info:
  title: SS&C Geneva Fund Accounting Investors API
  description: SS&C Geneva provides fund accounting and portfolio management APIs for asset managers, hedge funds, and fund administrators. APIs enable NAV calculation, trade processing, investor accounting, position management, and regulatory reporting across multi-asset portfolios. Geneva is an enterprise system with REST APIs for integration with external systems.
  version: '1.0'
  contact:
    name: SS&C Technologies Support
    url: https://www.ssctech.com/about/support-client-portals
  license:
    name: SS&C Geneva License Agreement
    url: https://www.ssctech.com/about/privacy
servers:
- url: https://api.ssctech.example.com/geneva/v1
  description: SS&C Geneva API (tenant-specific URL)
security:
- BearerAuth: []
- BasicAuth: []
tags:
- name: Investors
  description: Investor accounts and capital activity
paths:
  /portfolios/{portfolioId}/investors:
    get:
      operationId: listInvestors
      summary: List investors in a portfolio
      description: Returns investor accounts with capital allocations for a fund.
      tags:
      - Investors
      parameters:
      - $ref: '#/components/parameters/PortfolioId'
      - name: status
        in: query
        schema:
          type: string
          enum:
          - ACTIVE
          - REDEEMED
          - PENDING
      responses:
        '200':
          description: Investor list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvestorListResponse'
components:
  parameters:
    PortfolioId:
      name: portfolioId
      in: path
      required: true
      description: Geneva portfolio identifier
      schema:
        type: string
      example: FUND-001
  schemas:
    Investor:
      type: object
      properties:
        investorId:
          type: string
        name:
          type: string
        entityType:
          type: string
          enum:
          - INDIVIDUAL
          - INSTITUTION
          - FUND_OF_FUNDS
        capitalBalance:
          type: number
        unitsHeld:
          type: number
        percentageOwnership:
          type: number
        inceptionDate:
          type: string
          format: date
        status:
          type: string
          enum:
          - ACTIVE
          - REDEEMED
          - PENDING
        jurisdiction:
          type: string
    InvestorListResponse:
      type: object
      properties:
        investors:
          type: array
          items:
            $ref: '#/components/schemas/Investor'
        totalCount:
          type: integer
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
    BasicAuth:
      type: http
      scheme: basic