People API

Access professional profiles, career histories, and network connections across the startup ecosystem.

List People

GET/api/v1/people

Retrieve a paginated list of people with advanced filtering, search, and relationship data.

Query Parameters

Parameter	Type	Description	Example
search	string	Search across name, slug, about, emails	?search=sam altman
location	string	Filter by location (city, country)	?location=san francisco
company	string	Filter by company name or slug	?company=openai
title	string	Filter by job title or function	?title=ceo
type	string	Filter by person type	?type=founder
status	string	Filter by status	?status=active
has_linkedin	boolean	Filter by LinkedIn presence	?has_linkedin=true
has_github	boolean	Filter by GitHub presence	?has_github=true
has_email	boolean	Filter by email presence	?has_email=true
has_twitter	boolean	Filter by Twitter presence	?has_twitter=true
has_website	boolean	Filter by website presence	?has_website=true
is_founder	boolean	Filter by founder status	?is_founder=true
fields	string	Specific fields to return	?fields=id,name,linkedin
include_companies	boolean	Include company relationships	?include_companies=true
include_investments	boolean	Include VC firm relationships	?include_investments=true
sort	string	Sort by: name, updated, created	?sort=updated
order	string	Sort order: asc, desc	?order=desc

Example Request

cURL

curl -X GET "https://mentibus.xyz/api/v1/people?search=ai&location=san%20francisco&type=founder&include_companies=true&sort=updated&order=desc" \
  -H "Authorization: Bearer mk_your_api_key_here"

Example Response

200 OK

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Sam Altman",
      "slug": "sam-altman",
      "picture": "https://example.com/sam-altman.jpg",
      "linkedin": "https://linkedin.com/in/samaltman",
      "github": "https://github.com/samaltman",
      "twitter_url": "https://twitter.com/sama",
      "facebook_url": "https://facebook.com/samaltman",
      "website_url": "https://blog.samaltman.com",
      "discord": "sama#1234",
      "telegram": "@sama",
      "web3_address": "0x1234...",
      "email": "sam@example.com",
      "personal_email": "sam.personal@example.com",
      "work_email": "sam@openai.com",
      "city": "San Francisco",
      "country": "United States",
      "location_json": {
        "formatted_address": "San Francisco, CA, USA",
        "city": "San Francisco",
        "state": "California",
        "country": "United States"
      },
      "about": "Former President of Y Combinator, CEO of OpenAI...",
      "type": "founder",
      "status": "active",
      "companies": [
        {
          "id": 1,
          "company_id": 1,
          "title": "CEO",
          "function": "Executive",
          "is_current": true,
          "founder": false,
          "company": {
            "id": 1,
            "name": "OpenAI",
            "slug": "openai",
            "logo": "https://example.com/openai-logo.png",
            "website": "https://openai.com",
            "layer": "Artificial Intelligence"
          }
        }
      ],
      "vc_firms": [
        {
          "id": 1,
          "vc_firm_id": 1,
          "title": "Investor",
          "is_current": true,
          "vc_firm": {
            "id": 1,
            "name": "Andreessen Horowitz",
            "slug": "andreessen-horowitz",
            "logo": "https://example.com/a16z-logo.png",
            "website": "https://a16z.com"
          }
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  },
  "message": "Retrieved 1 people"
}

Get Individual Person

GET/api/v1/people/{slug}

Retrieve detailed information about a specific person including career history and connections.

Path Parameters

Parameter	Type	Description
slug	string	Unique identifier for the person

Query Parameters

Parameter	Default	Description
include_companies	true	Include company relationships
include_investments	true	Include VC firm relationships

Example Request

cURL

curl -X GET "https://mentibus.xyz/api/v1/people/sam-altman" \
  -H "Authorization: Bearer mk_your_api_key_here"

Example Response

200 OK

{
  "success": true,
  "data": {
    "id": 1,
    "name": "Sam Altman",
    "slug": "sam-altman",
    "picture": "https://example.com/sam-altman.jpg",
    "linkedin": "https://linkedin.com/in/samaltman",
    "github": "https://github.com/samaltman",
    "twitter_url": "https://twitter.com/sama",
    "facebook_url": "https://facebook.com/samaltman",
    "website_url": "https://blog.samaltman.com",
    "discord": "sama#1234",
    "telegram": "@sama",
    "web3_address": "0x1234...",
    "email": "sam@example.com",
    "personal_email": "sam.personal@example.com",
    "work_email": "sam@openai.com",
    "city": "San Francisco",
    "country": "United States",
    "location_json": {
      "formatted_address": "San Francisco, CA, USA",
      "city": "San Francisco",
      "state": "California",
      "country": "United States"
    },
    "about": "Former President of Y Combinator, CEO of OpenAI...",
    "type": "founder",
    "status": "active",
    "companies": [
      {
        "id": 1,
        "company_id": 1,
        "title": "CEO",
        "function": "Executive",
        "start_date": "2019-01-01",
        "end_date": null,
        "is_current": true,
        "founder": false,
        "company": {
          "id": 1,
          "name": "OpenAI",
          "slug": "openai",
          "logo": "https://example.com/openai-logo.png",
          "website": "https://openai.com",
          "layer": "Artificial Intelligence"
        }
      }
    ],
    "vc_firms": [
      {
        "id": 1,
        "vc_firm_id": 1,
        "title": "Investor",
        "function": "General Partner",
        "start_date": "2015-01-01",
        "end_date": null,
        "is_current": true,
        "founder": false,
        "vc_firm": {
          "id": 1,
          "name": "Andreessen Horowitz",
          "slug": "andreessen-horowitz",
          "logo": "https://example.com/a16z-logo.png",
          "website": "https://a16z.com"
        }
      }
    ]
  },
  "message": "Retrieved person: Sam Altman"
}

Create Person

POST/api/v1/people

Create a new person record. Requires write permissions.

Request Body

JSON

{
  "name": "Jane Smith",
  "slug": "jane-smith", // Optional, auto-generated if not provided
  "picture": "https://example.com/jane-smith.jpg",
  "city": "San Francisco",
  "country": "United States",
  "website_url": "https://janesmith.com",
  "linkedin": "https://linkedin.com/in/janesmith",
  "twitter_url": "https://twitter.com/janesmith",
  "github": "https://github.com/janesmith",
  "email": "jane@example.com"
  // Note: Fields like 'about', 'type', and 'status' are not currently supported in POST
}

Advanced Filtering Examples

AI Founders in Bay Area

Query

?type=founder&location=san francisco&has_linkedin=true&include_companies=true

VC Investors by Company

Query

?company=stripe&include_investments=true&sort=updated

Technical People with GitHub

Query

?has_github=true&has_linkedin=true&fields=id,name,github,linkedin

Active People with Email

Query

?status=active&has_email=true&limit=100

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": "Person not found",
  "meta": {
    "requestId": "req_ghi789",
    "timestamp": "2024-01-15T10:30:00Z",
    "version": "v1"
  }
}