FinanceGenius.AI

FinanceGenius.AI Admin API

The Admin API from FinanceGenius.AI — 22 operation(s) for admin.

GitHub OpenAPI

Operations 22

GET /api/v1/admin/dashboard Admin Dashboard #
POST /api/v1/admin/institutions Create Institution #
PUT /api/v1/admin/institutions/{institution_id} Update Institution #
POST /api/v1/admin/products Create Product #
PUT /api/v1/admin/products/{product_id} Update Product #
GET /api/v1/admin/users List Users #
POST /api/v1/admin/knowledge/upload-pdf Upload Knowledge Pdf #
GET /api/v1/admin/knowledge/stats Knowledge Base Stats #
DELETE /api/v1/admin/knowledge/source/{source_file} Delete Knowledge Source #
GET /api/v1/admin/knowledge/search-test Test Knowledge Search #
GET /api/v1/admin/token-usage Get Token Usage #
GET /admin/dashboard Admin Dashboard #
POST /admin/institutions Create Institution #
PUT /admin/institutions/{institution_id} Update Institution #
POST /admin/products Create Product #
PUT /admin/products/{product_id} Update Product #
GET /admin/users List Users #
POST /admin/knowledge/upload-pdf Upload Knowledge Pdf #
GET /admin/knowledge/stats Knowledge Base Stats #
DELETE /admin/knowledge/source/{source_file} Delete Knowledge Source #
GET /admin/knowledge/search-test Test Knowledge Search #
GET /admin/token-usage Get Token Usage #

Specifications

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

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/financegenius-ai/json-schema/financegenius-ai-institution-create-schema.json
📊
JSONSchema
https://artifacts.apis.io/financegenius-ai/json-schema/financegenius-ai-product-create-schema.json
📊
JSONSchema
https://artifacts.apis.io/financegenius-ai/json-schema/financegenius-ai-institution-update-schema.json
📊
JSONSchema
https://artifacts.apis.io/financegenius-ai/json-schema/financegenius-ai-product-update-schema.json
📊
JSONSchema
https://artifacts.apis.io/financegenius-ai/json-schema/financegenius-ai-body-upload-knowledge-pdf-api-v1-admin-knowledge-upload-pdf-post-schema.json
📊
JSONSchema
https://artifacts.apis.io/financegenius-ai/json-schema/financegenius-ai-body-upload-knowledge-pdf-admin-knowledge-upload-pdf-post-schema.json

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/financegenius-ai/apis.yml

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-admin-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-admin-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Financegenius Ai Admin API
  version: 1.0.0
  description: 'Operations tagged Admin 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: Admin
paths:
  /api/v1/admin/dashboard:
    get:
      tags:
      - Admin
      summary: Admin Dashboard
      operationId: admin_dashboard_api_v1_admin_dashboard_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
  /api/v1/admin/institutions:
    post:
      tags:
      - Admin
      summary: Create Institution
      operationId: create_institution_api_v1_admin_institutions_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InstitutionCreate'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/v1/admin/institutions/{institution_id}:
    put:
      tags:
      - Admin
      summary: Update Institution
      operationId: update_institution_api_v1_admin_institutions__institution_id__put
      security:
      - HTTPBearer: []
      parameters:
      - name: institution_id
        in: path
        required: true
        schema:
          type: string
          title: Institution Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InstitutionUpdate'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/products:
    post:
      tags:
      - Admin
      summary: Create Product
      operationId: create_product_api_v1_admin_products_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductCreate'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/v1/admin/products/{product_id}:
    put:
      tags:
      - Admin
      summary: Update Product
      operationId: update_product_api_v1_admin_products__product_id__put
      security:
      - HTTPBearer: []
      parameters:
      - name: product_id
        in: path
        required: true
        schema:
          type: string
          title: Product Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductUpdate'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/users:
    get:
      tags:
      - Admin
      summary: List Users
      operationId: list_users_api_v1_admin_users_get
      security:
      - HTTPBearer: []
      parameters:
      - name: page
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          description: Page number
          default: 1
          title: Page
        description: Page number
      - name: page_size
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Items per page
          default: 20
          title: Page Size
        description: Items per page
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/knowledge/upload-pdf:
    post:
      tags:
      - Admin
      summary: Upload Knowledge Pdf
      description: Upload a PDF to ingest into the RAG knowledge base.
      operationId: upload_knowledge_pdf_api_v1_admin_knowledge_upload_pdf_post
      requestBody:
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_upload_knowledge_pdf_api_v1_admin_knowledge_upload_pdf_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /api/v1/admin/knowledge/stats:
    get:
      tags:
      - Admin
      summary: Knowledge Base Stats
      description: Get knowledge base statistics.
      operationId: knowledge_base_stats_api_v1_admin_knowledge_stats_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
  /api/v1/admin/knowledge/source/{source_file}:
    delete:
      tags:
      - Admin
      summary: Delete Knowledge Source
      description: Delete all chunks from a specific source file.
      operationId: delete_knowledge_source_api_v1_admin_knowledge_source__source_file__delete
      security:
      - HTTPBearer: []
      parameters:
      - name: source_file
        in: path
        required: true
        schema:
          type: string
          title: Source File
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/knowledge/search-test:
    get:
      tags:
      - Admin
      summary: Test Knowledge Search
      description: Test the hybrid search and see what results come back.
      operationId: test_knowledge_search_api_v1_admin_knowledge_search_test_get
      security:
      - HTTPBearer: []
      parameters:
      - name: query
        in: query
        required: true
        schema:
          type: string
          title: Query
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/admin/token-usage:
    get:
      tags:
      - Admin
      summary: Get Token Usage
      description: Get token usage analytics.
      operationId: get_token_usage_api_v1_admin_token_usage_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
  /admin/dashboard:
    get:
      tags:
      - Admin
      summary: Admin Dashboard
      operationId: admin_dashboard_admin_dashboard_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
  /admin/institutions:
    post:
      tags:
      - Admin
      summary: Create Institution
      operationId: create_institution_admin_institutions_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InstitutionCreate'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /admin/institutions/{institution_id}:
    put:
      tags:
      - Admin
      summary: Update Institution
      operationId: update_institution_admin_institutions__institution_id__put
      security:
      - HTTPBearer: []
      parameters:
      - name: institution_id
        in: path
        required: true
        schema:
          type: string
          title: Institution Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InstitutionUpdate'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /admin/products:
    post:
      tags:
      - Admin
      summary: Create Product
      operationId: create_product_admin_products_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductCreate'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /admin/products/{product_id}:
    put:
      tags:
      - Admin
      summary: Update Product
      operationId: update_product_admin_products__product_id__put
      security:
      - HTTPBearer: []
      parameters:
      - name: product_id
        in: path
        required: true
        schema:
          type: string
          title: Product Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProductUpdate'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /admin/users:
    get:
      tags:
      - Admin
      summary: List Users
      operationId: list_users_admin_users_get
      security:
      - HTTPBearer: []
      parameters:
      - name: page
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          description: Page number
          default: 1
          title: Page
        description: Page number
      - name: page_size
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Items per page
          default: 20
          title: Page Size
        description: Items per page
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /admin/knowledge/upload-pdf:
    post:
      tags:
      - Admin
      summary: Upload Knowledge Pdf
      description: Upload a PDF to ingest into the RAG knowledge base.
      operationId: upload_knowledge_pdf_admin_knowledge_upload_pdf_post
      requestBody:
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_upload_knowledge_pdf_admin_knowledge_upload_pdf_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
  /admin/knowledge/stats:
    get:
      tags:
      - Admin
      summary: Knowledge Base Stats
      description: Get knowledge base statistics.
      operationId: knowledge_base_stats_admin_knowledge_stats_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
  /admin/knowledge/source/{source_file}:
    delete:
      tags:
      - Admin
      summary: Delete Knowledge Source
      description: Delete all chunks from a specific source file.
      operationId: delete_knowledge_source_admin_knowledge_source__source_file__delete
      security:
      - HTTPBearer: []
      parameters:
      - name: source_file
        in: path
        required: true
        schema:
          type: string
          title: Source File
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /admin/knowledge/search-test:
    get:
      tags:
      - Admin
      summary: Test Knowledge Search
      description: Test the hybrid search and see what results come back.
      operationId: test_knowledge_search_admin_knowledge_search_test_get
      security:
      - HTTPBearer: []
      parameters:
      - name: query
        in: query
        required: true
        schema:
          type: string
          title: Query
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /admin/token-usage:
    get:
      tags:
      - Admin
      summary: Get Token Usage
      description: Get token usage analytics.
      operationId: get_token_usage_admin_token_usage_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
components:
  schemas:
    ProductCreate:
      properties:
        name:
          type: string
          title: Name
        slug:
          type: string
          title: Slug
        product_type:
          type: string
          title: Product Type
        short_description:
          anyOf:
          - type: string
          - type: 'null'
          title: Short Description
        detailed_description:
          anyOf:
          - type: string
          - type: 'null'
          title: Detailed Description
        apply_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Apply Url
        institution_id:
          type: string
          format: uuid
          title: Institution Id
        detail:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Detail
      type: object
      required:
      - name
      - slug
      - product_type
      - institution_id
      title: ProductCreate
    Body_upload_knowledge_pdf_api_v1_admin_knowledge_upload_pdf_post:
      properties:
        file:
          type: string
          contentMediaType: application/octet-stream
          title: File
      type: object
      required:
      - file
      title: Body_upload_knowledge_pdf_api_v1_admin_knowledge_upload_pdf_post
    InstitutionCreate:
      properties:
        name:
          type: string
          title: Name
        slug:
          type: string
          title: Slug
        type:
          type: string
          title: Type
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        logo_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Logo Url
        website:
          anyOf:
          - type: string
          - type: 'null'
          title: Website
        headquarters:
          anyOf:
          - type: string
          - type: 'null'
          title: Headquarters
        founded_year:
          anyOf:
          - type: integer
          - type: 'null'
          title: Founded Year
        valuation_usd_mn:
          anyOf:
          - type: number
          - type: 'null'
          title: Valuation Usd Mn
        market_cap_usd_mn:
          anyOf:
          - type: number
          - type: 'null'
          title: Market Cap Usd Mn
        customer_count:
          anyOf:
          - type: integer
          - type: 'null'
          title: Customer Count
        is_listed:
          type: boolean
          title: Is Listed
          default: false
        stock_symbol:
          anyOf:
          - type: string
          - type: 'null'
          title: Stock Symbol
        regulatory_body:
          anyOf:
          - type: string
          - type: 'null'
          title: Regulatory Body
        license_number:
          anyOf:
          - type: string
          - type: 'null'
          title: License Number
      type: object
      required:
      - name
      - slug
      - type
      title: InstitutionCreate
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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
    ProductUpdate:
      properties:
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
        short_description:
          anyOf:
          - type: string
          - type: 'null'
          title: Short Description
        detailed_description:
          anyOf:
          - type: string
          - type: 'null'
          title: Detailed Description
        is_active:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Is Active
        apply_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Apply Url
        detail:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Detail
      type: object
      title: ProductUpdate
    Body_upload_knowledge_pdf_admin_knowledge_upload_pdf_post:
      properties:
        file:
          type: string
          contentMediaType: application/octet-stream
          title: File
      type: object
      required:
      - file
      title: Body_upload_knowledge_pdf_admin_knowledge_upload_pdf_post
    InstitutionUpdate:
      properties:
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        logo_url:
          anyOf:
          - type: string
          - type: 'null'
          title: Logo Url
        website:
          anyOf:
          - type: string
          - type: 'null'
          title: Website
        valuation_usd_mn:
          anyOf:
          - type: number
          - type: 'null'
          title: Valuation Usd Mn
        market_cap_usd_mn:
          anyOf:
          - type: number
          - type: 'null'
          title: Market Cap Usd Mn
        customer_count:
          anyOf:
          - type: integer
          - type: 'null'
          title: Customer Count
      type: object
      title: InstitutionUpdate
  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)