Investors API

Access VC firm data, investment portfolios, and investor relationships.

List Investors

GET/api/v1/investors

Retrieve a paginated list of VC firms with advanced filtering and search capabilities.

Query Parameters

Parameter	Type	Description	Example
search	string	Search across name, overview, slug	?search=andreessen
location	string	Filter by location (city, country, address)	?location=san francisco
founded_after	integer	Founded after year	?founded_after=2000
min_investments	integer	Minimum number of investments	?min_investments=50
min_investment_amount	number	Minimum total investment amount	?min_investment_amount=100000000
tags	string	Filter by tags (comma-separated)	?tags=ai,fintech
include_investors	boolean	Include investor/partner profiles	?include_investors=true
sort	string	Sort by: name, founded, investments, investment_amount	?sort=investments

Example Request

cURL

curl -X GET "https://mentibus.xyz/api/v1/investors?location=san%20francisco&min_investments=10&sort=investment_amount&order=desc" \
  -H "Authorization: Bearer mk_your_api_key_here"

Example Response

200 OK

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Andreessen Horowitz",
      "slug": "andreessen-horowitz",
      "logo": "https://example.com/a16z-logo.png",
      "overview": "Leading venture capital firm investing in bold entrepreneurs...",
      "year_founded": 2009,
      "investment_amount_total": "15000000000.00",
      "num_of_investments": 847,
      "website": "https://a16z.com",
      "linkedin": "https://linkedin.com/company/andreessen-horowitz",
      "location_json": {
        "formatted_address": "Menlo Park, CA, USA",
        "city": "Menlo Park",
        "state": "California",
        "country": "United States"
      },
      "tags": ["ai", "crypto", "fintech", "enterprise"],
      "status": "active"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  },
  "message": "Retrieved 1 VC firms",
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2024-01-15T10:30:00Z",
    "version": "v1"
  }
}

Get Individual Investor

GET/api/v1/investors/{slug}

Retrieve detailed information about a specific VC firm including portfolio, team, and investment statistics.

Path Parameters

Parameter	Type	Description
slug	string	Unique identifier for the VC firm

Query Parameters

Parameter	Default	Description
include_investors	true	Include investor/partner profiles
include_investments	true	Include investment portfolio
include_stats	true	Include investment statistics

Example Request

cURL

curl -X GET "https://mentibus.xyz/api/v1/investors/andreessen-horowitz" \
  -H "Authorization: Bearer mk_your_api_key_here"

Example Response

200 OK

{
  "success": true,
  "data": {
    "id": 1,
    "name": "Andreessen Horowitz",
    "slug": "andreessen-horowitz",
    "overview": "Leading venture capital firm...",
    "investors": [
      {
        "id": 1,
        "person": {
          "id": 1,
          "name": "Marc Andreessen",
          "slug": "marc-andreessen",
          "picture": "https://example.com/marc.jpg",
          "linkedin": "https://linkedin.com/in/pmarca"
        },
        "title": "Co-Founder & General Partner",
        "is_current": true,
        "founder": true
      }
    ],
    "investments": [
      {
        "investment_round": {
          "id": 1,
          "round_date": "2024-01-15",
          "round": "Series A",
          "amount": 25000000,
          "company": {
            "id": 1,
            "name": "Example Startup",
            "slug": "example-startup",
            "logo": "https://example.com/logo.png"
          }
        }
      }
    ],
    "statistics": {
      "total_investments": 847,
      "total_companies": 623,
      "total_amount_invested": "15000000000.00",
      "avg_investment_size": "17730000.00",
      "rounds_breakdown": [
        {
          "round_type": "Series A",
          "count": 234,
          "total_amount": "3500000000.00"
        }
      ],
      "yearly_activity": [
        {
          "year": 2024,
          "count": 45,
          "total_amount": "850000000.00"
        }
      ]
    }
  },
  "message": "Retrieved VC firm: Andreessen Horowitz"
}

Create Investor

POST/api/v1/investors

Create a new VC firm record. Requires write permissions.

Request Body

JSON

{
  "name": "New Venture Capital",
  "slug": "new-venture-capital", // Optional, auto-generated if not provided
  "overview": "Early-stage venture capital firm focused on AI and fintech startups",
  "year_founded": 2024,
  "website": "https://newvc.com",
  "linkedin": "https://linkedin.com/company/new-vc",
  "location_json": {
    "formatted_address": "New York, NY, USA",
    "city": "New York",
    "state": "New York",
    "country": "United States"
  },
  "tags": ["ai", "fintech", "early-stage"]
}

Error Responses

401 Unauthorized

{
  "success": false,
  "error": "Invalid API key",
  "meta": {
    "requestId": "req_def456",
    "timestamp": "2024-01-15T10:30:00Z",
    "version": "v1"
  }
}

404 Not Found

{
  "success": false,
  "error": "VC firm not found",
  "meta": {
    "requestId": "req_ghi789",
    "timestamp": "2024-01-15T10:30:00Z",
    "version": "v1"
  }
}