Companies API

Access comprehensive company data including profiles, funding history, team information, and market insights.

List Companies

GET/api/v1/companies

Retrieve a paginated list of companies with advanced filtering, search, and sorting capabilities.

Query Parameters

Parameter	Type	Description	Example
search	string	Search across name, overview, slug	?search=openai
industry	string	Filter by industry/layer	?industry=artificial intelligence
location	string	Filter by location (city, country, address)	?location=san francisco
status	string	Filter by company status	?status=active
founded_after	integer	Founded after year	?founded_after=2020
founded_before	integer	Founded before year	?founded_before=2023
min_employees	integer	Minimum employee count	?min_employees=50
max_employees	integer	Maximum employee count	?max_employees=500
min_funding	number	Minimum funding amount	?min_funding=1000000
max_funding	number	Maximum funding amount	?max_funding=50000000
tags	string	Filter by tags (comma-separated)	?tags=ai,fintech
has_website	boolean	Filter by website presence	?has_website=true
has_linkedin	boolean	Filter by LinkedIn presence	?has_linkedin=true
fields	string	Specific fields to return (comma-separated)	?fields=id,name,website
include_team	boolean	Include team member data	?include_team=true
include_funding	boolean	Include funding round data	?include_funding=true
sort	string	Sort by: name, founded, updated, employees, funding	?sort=funding
order	string	Sort order: asc, desc	?order=desc

Example Request

cURL

curl -X GET "https://mentibus.xyz/api/v1/companies?search=ai&industry=artificial%20intelligence&min_employees=50&tags=ai,ml&include_team=true&sort=funding&order=desc" \
  -H "Authorization: Bearer mk_your_api_key_here"

Example Response

200 OK

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "OpenAI",
      "slug": "openai",
      "overview": "AI research and deployment company...",
      "website": "https://openai.com",
      "logo": "https://example.com/openai-logo.png",
      "layer": "Artificial Intelligence",
      "location_json": {
        "formatted_address": "San Francisco, CA, USA",
        "city": "San Francisco",
        "state": "California",
        "country": "United States"
      },
      "year_founded": 2015,
      "total_employees": 500,
      "status": "active",
      "tags": ["ai", "machine-learning", "nlp"],
      "investor_amount": "11300000000.00",
      "team": [
        {
          "person": {
            "id": 1,
            "name": "Sam Altman",
            "slug": "sam-altman",
            "picture": "https://example.com/sam.jpg"
          },
          "title": "CEO",
          "is_current": true,
          "founder": false
        }
      ],
      "funding_rounds": [
        {
          "id": 1,
          "round_date": "2023-01-15",
          "round": "Series C",
          "amount": 10000000000,
          "valuation": 29000000000
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  },
  "message": "Retrieved 1 companies"
}

Get Individual Company

GET/api/v1/companies/{slug}

Retrieve detailed information about a specific company including team, funding history, and relationships.

Path Parameters

Parameter	Type	Description
slug	string	Unique identifier for the company

Example Request

cURL

curl -X GET "https://mentibus.xyz/api/v1/companies/openai" \
  -H "Authorization: Bearer mk_your_api_key_here"

Create Company

POST/api/v1/companies

Create a new company record. Requires write permissions.

Request Body

JSON

{
  "name": "Example Startup",
  "slug": "example-startup", // Optional, auto-generated if not provided
  "overview": "Revolutionary AI company building the future of work",
  "website": "https://example-startup.com",
  "layer": "Artificial Intelligence",
  "year_founded": 2024,
  "total_employees": 25,
  "status": "active",
  "location_json": {
    "formatted_address": "New York, NY, USA",
    "city": "New York",
    "state": "New York",
    "country": "United States"
  },
  "tags": ["ai", "productivity", "saas"]
}

Advanced Filtering Examples

AI Companies in San Francisco

Query

?industry=artificial intelligence&location=san francisco&min_employees=10

Well-Funded Startups

Query

?min_funding=10000000&founded_after=2020&sort=funding&order=desc

Fintech Companies with Teams

Query

?tags=fintech&include_team=true&has_linkedin=true

Essential Fields Only

Query

?fields=id,name,slug,website,total_employees&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": "Company not found",
  "meta": {
    "requestId": "req_ghi789",
    "timestamp": "2024-01-15T10:30:00Z",
    "version": "v1"
  }
}