FinanceGenius.AI

FinanceGenius.AI Chat API

The Chat API from FinanceGenius.AI — 20 operation(s) for chat.

GitHub OpenAPI

Operations 24

GET /api/v1/chat/sessions List Sessions #
POST /api/v1/chat/sessions Create Session #
GET /api/v1/chat/sessions/{session_id} Get Session #
DELETE /api/v1/chat/sessions/{session_id} Delete Session #
POST /api/v1/chat/sessions/{session_id}/messages Send Message #
GET /api/v1/chat/suggested-prompts Get Suggested Prompts #
POST /api/v1/chat/tts Text To Speech #
POST /api/v1/chat/tts-deepgram Text To Speech Deepgram #
POST /api/v1/chat/tts-indian Text To Speech Indian #
GET /api/v1/chat/voices List Available Voices #
GET /api/v1/chat/deepgram-token Get Deepgram Token #
POST /api/v1/chat/sessions/{session_id}/upload Upload Document #
GET /chat/sessions List Sessions #
POST /chat/sessions Create Session #
GET /chat/sessions/{session_id} Get Session #
DELETE /chat/sessions/{session_id} Delete Session #
POST /chat/sessions/{session_id}/messages Send Message #
GET /chat/suggested-prompts Get Suggested Prompts #
POST /chat/tts Text To Speech #
POST /chat/tts-deepgram Text To Speech Deepgram #
POST /chat/tts-indian Text To Speech Indian #
GET /chat/voices List Available Voices #
GET /chat/deepgram-token Get Deepgram Token #
POST /chat/sessions/{session_id}/upload Upload Document #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/financegenius-ai/openapi/financegenius-ai-chat-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/financegenius-ai/json-schema/financegenius-ai-chat-message-create-schema.json
📊
JSONSchema
https://artifacts.apis.io/financegenius-ai/json-schema/financegenius-ai-ttsrequest-schema.json
📊
JSONSchema
https://artifacts.apis.io/financegenius-ai/json-schema/financegenius-ai-body-upload-document-api-v1-chat-sessions-session-id-upload-post-schema.json
📊
JSONSchema
https://artifacts.apis.io/financegenius-ai/json-schema/financegenius-ai-body-upload-document-chat-sessions-session-id-upload-post-schema.json
📊
JSONSchema
https://artifacts.apis.io/financegenius-ai/json-schema/financegenius-ai-chat-session-create-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/financegenius-ai:financegenius-ai-chat-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

financegenius-ai-chat-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Financegenius Ai Chat API
  version: 1.0.0
  description: 'Operations tagged Chat across 2 of this provider''s published API definitions: finmall-openapi.json, financegenius-ai-openapi.json. Each path carries the servers of the definition it was published in.'
tags:
- name: Chat
paths:
  /api/v1/chat/sessions:
    get:
      tags:
      - Chat
      summary: List Sessions
      operationId: list_sessions_api_v1_chat_sessions_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
    post:
      tags:
      - Chat
      summary: Create Session
      operationId: create_session_api_v1_chat_sessions_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChatSessionCreate'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/chat/sessions/{session_id}:
    get:
      tags:
      - Chat
      summary: Get Session
      operationId: get_session_api_v1_chat_sessions__session_id__get
      parameters:
      - name: session_id
        in: path
        required: true
        schema:
          type: string
          title: Session Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - Chat
      summary: Delete Session
      operationId: delete_session_api_v1_chat_sessions__session_id__delete
      parameters:
      - name: session_id
        in: path
        required: true
        schema:
          type: string
          title: Session Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/chat/sessions/{session_id}/messages:
    post:
      tags:
      - Chat
      summary: Send Message
      operationId: send_message_api_v1_chat_sessions__session_id__messages_post
      parameters:
      - name: session_id
        in: path
        required: true
        schema:
          type: string
          title: Session Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChatMessageCreate'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/chat/suggested-prompts:
    get:
      tags:
      - Chat
      summary: Get Suggested Prompts
      operationId: get_suggested_prompts_api_v1_chat_suggested_prompts_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /api/v1/chat/tts:
    post:
      tags:
      - Chat
      summary: Text To Speech
      description: Convert text to speech using Microsoft Edge TTS (free neural voices).
      operationId: text_to_speech_api_v1_chat_tts_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TTSRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/chat/tts-deepgram:
    post:
      tags:
      - Chat
      summary: Text To Speech Deepgram
      description: 'TTS endpoint — always uses Edge TTS with Indian neural voices.


        Deepgram Aura doesn''t support Indian English voices yet (only US/UK/AU).

        Edge TTS en-IN-NeerjaNeural (female) and en-IN-PrabhatNeural (male)

        provide the best Indian voice quality available.


        Deepgram is used only for STT (speech-to-text) where Nova-2 excels

        at Indian English/Hindi accent recognition.'
      operationId: text_to_speech_deepgram_api_v1_chat_tts_deepgram_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TTSRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/chat/tts-indian:
    post:
      tags:
      - Chat
      summary: Text To Speech Indian
      description: 'Indian-optimized TTS — uses Edge TTS Indian neural voices.


        Available voices:

        - en-IN-NeerjaNeural (female, default) — warm, natural Indian English

        - en-IN-PrabhatNeural (male) — authoritative Indian English

        - hi-IN-SwaraNeural (Hindi female)

        - hi-IN-MadhurNeural (Hindi male)'
      operationId: text_to_speech_indian_api_v1_chat_tts_indian_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TTSRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/chat/voices:
    get:
      tags:
      - Chat
      summary: List Available Voices
      description: List available TTS voices for the frontend voice selector.
      operationId: list_available_voices_api_v1_chat_voices_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /api/v1/chat/deepgram-token:
    get:
      tags:
      - Chat
      summary: Get Deepgram Token
      description: 'Retired: never mints a credential. Answers {"available": false, "reason": "retired"}.'
      operationId: get_deepgram_token_api_v1_chat_deepgram_token_get
      parameters:
      - name: probe
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Probe
      - name: session_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/chat/sessions/{session_id}/upload:
    post:
      tags:
      - Chat
      summary: Upload Document
      description: Upload a document for AI analysis within a chat session.
      operationId: upload_document_api_v1_chat_sessions__session_id__upload_post
      parameters:
      - name: session_id
        in: path
        required: true
        schema:
          type: string
          title: Session Id
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_upload_document_api_v1_chat_sessions__session_id__upload_post'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /chat/sessions:
    get:
      tags:
      - Chat
      summary: List Sessions
      operationId: list_sessions_chat_sessions_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
    post:
      tags:
      - Chat
      summary: Create Session
      operationId: create_session_chat_sessions_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChatSessionCreate'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /chat/sessions/{session_id}:
    get:
      tags:
      - Chat
      summary: Get Session
      operationId: get_session_chat_sessions__session_id__get
      parameters:
      - name: session_id
        in: path
        required: true
        schema:
          type: string
          title: Session Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - Chat
      summary: Delete Session
      operationId: delete_session_chat_sessions__session_id__delete
      parameters:
      - name: session_id
        in: path
        required: true
        schema:
          type: string
          title: Session Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /chat/sessions/{session_id}/messages:
    post:
      tags:
      - Chat
      summary: Send Message
      operationId: send_message_chat_sessions__session_id__messages_post
      parameters:
      - name: session_id
        in: path
        required: true
        schema:
          type: string
          title: Session Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChatMessageCreate'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /chat/suggested-prompts:
    get:
      tags:
      - Chat
      summary: Get Suggested Prompts
      operationId: get_suggested_prompts_chat_suggested_prompts_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /chat/tts:
    post:
      tags:
      - Chat
      summary: Text To Speech
      description: Convert text to speech using Microsoft Edge TTS (free neural voices).
      operationId: text_to_speech_chat_tts_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TTSRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /chat/tts-deepgram:
    post:
      tags:
      - Chat
      summary: Text To Speech Deepgram
      description: 'TTS endpoint — always uses Edge TTS with Indian neural voices.


        Deepgram Aura doesn''t support Indian English voices yet (only US/UK/AU).

        Edge TTS en-IN-NeerjaNeural (female) and en-IN-PrabhatNeural (male)

        provide the best Indian voice quality available.


        Deepgram is used only for STT (speech-to-text) where Nova-2 excels

        at Indian English/Hindi accent recognition.'
      operationId: text_to_speech_deepgram_chat_tts_deepgram_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TTSRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /chat/tts-indian:
    post:
      tags:
      - Chat
      summary: Text To Speech Indian
      description: 'Indian-optimized TTS — uses Edge TTS Indian neural voices.


        Available voices:

        - en-IN-NeerjaNeural (female, default) — warm, natural Indian English

        - en-IN-PrabhatNeural (male) — authoritative Indian English

        - hi-IN-SwaraNeural (Hindi female)

        - hi-IN-MadhurNeural (Hindi male)'
      operationId: text_to_speech_indian_chat_tts_indian_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TTSRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /chat/voices:
    get:
      tags:
      - Chat
      summary: List Available Voices
      description: List available TTS voices for the frontend voice selector.
      operationId: list_available_voices_chat_voices_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /chat/deepgram-token:
    get:
      tags:
      - Chat
      summary: Get Deepgram Token
      description: 'Retired: never mints a credential. Answers {"available": false, "reason": "retired"}.'
      operationId: get_deepgram_token_chat_deepgram_token_get
      parameters:
      - name: probe
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Probe
      - name: session_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Session Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /chat/sessions/{session_id}/upload:
    post:
      tags:
      - Chat
      summary: Upload Document
      description: Upload a document for AI analysis within a chat session.
      operationId: upload_document_chat_sessions__session_id__upload_post
      parameters:
      - name: session_id
        in: path
        required: true
        schema:
          type: string
          title: Session Id
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_upload_document_chat_sessions__session_id__upload_post'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ChatMessageCreate:
      properties:
        content:
          type: string
          title: Content
        max_tokens:
          anyOf:
          - type: integer
          - type: 'null'
          title: Max Tokens
        voice_mode:
          type: boolean
          title: Voice Mode
          default: false
        document_text:
          anyOf:
          - type: string
          - type: 'null'
          title: Document Text
        document_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Document Name
        image_base64:
          anyOf:
          - type: string
          - type: 'null'
          title: Image Base64
        image_media_type:
          anyOf:
          - type: string
          - type: 'null'
          title: Image Media Type
      type: object
      required:
      - content
      title: ChatMessageCreate
    TTSRequest:
      properties:
        text:
          type: string
          title: Text
        voice:
          type: string
          title: Voice
          default: en-IN-NeerjaNeural
        rate:
          type: string
          title: Rate
          default: +5%
      type: object
      required:
      - text
      title: TTSRequest
    Body_upload_document_api_v1_chat_sessions__session_id__upload_post:
      properties:
        file:
          type: string
          contentMediaType: application/octet-stream
          title: File
      type: object
      required:
      - file
      title: Body_upload_document_api_v1_chat_sessions__session_id__upload_post
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    Body_upload_document_chat_sessions__session_id__upload_post:
      properties:
        file:
          type: string
          contentMediaType: application/octet-stream
          title: File
      type: object
      required:
      - file
      title: Body_upload_document_chat_sessions__session_id__upload_post
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    ChatSessionCreate:
      properties:
        title:
          anyOf:
          - type: string
          - type: 'null'
          title: Title
      type: object
      title: ChatSessionCreate
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
x-refined-from:
- finmall-openapi.json
- financegenius-ai-openapi.json
x-provenance:
  method: harvested
  publisher: FinanceGenius.AI
  source: https://api.finmall.ai/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)