> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryfundable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> Complete reference for all Fundable API endpoints

## Base URL

All API requests use the following base URL:

```
https://www.tryfundable.ai/api/v1
```

## Authentication

All endpoints require Bearer token authentication. See the [Authentication](/authentication) page for details.

## Endpoints

### Deals

* **POST /deals** -- Search and filter funding rounds with pagination and sorting. Combine filters across deal attributes (financing type, size, date), company attributes (location, industry, size), and investor participation (firms or people).
* **GET /deals/{id}** -- Retrieve full details for a single funding round by its UUID.
* **GET /deals/{id}/investors** -- Get the full investor lineup for a deal, including lead status, the partners involved, angel investors, and profile links.

### Companies

* **POST /companies** -- Search and filter companies with pagination, sorting, and optional AI-powered semantic search. Filter by company attributes, latest funding round, and investors across all rounds.
* **GET /company** -- Get full company details and the latest funding round (with participating investors) by any identifier -- UUID, domain, LinkedIn, or Crunchbase.
* **GET /company/deals** -- Retrieve a company's complete funding history (paginated) by any identifier.
* **GET /company/search** -- Quick lookup for a company by fuzzy name, domain, LinkedIn, or Crunchbase, with relevance scoring.

### Investors

* **POST /investors** -- List and filter investors with pagination and sorting. Filter by entity attributes (location, size) and by portfolio (industries, deal characteristics, semantic search); portfolio filters return per-investor matched deal and lead counts.
* **GET /investor** -- Get an investor's full profile, statistics, and portfolio summary by any identifier -- UUID, domain, LinkedIn, or Crunchbase.
* **GET /investor/deals** -- Retrieve an investor's complete deal history (paginated) by any identifier.
* **GET /investor/search** -- Quick lookup for an investor by fuzzy name, domain, LinkedIn, or Crunchbase, with relevance scoring.

### People

* **POST /people** -- Search people (founders, executives, investors) with pagination, sorting, and optional semantic search. Filter by person attributes, current employer, and investor activity.
* **GET /person** -- Get full person detail, including complete employment and education history, by any identifier -- UUID, LinkedIn, Crunchbase, or Twitter.
* **GET /person/deals** -- Retrieve every deal a person has participated in as an investor (angel plus lead/firm deals), paginated.
* **GET /person/search** -- Quick lookup for a person by fuzzy name, UUID, LinkedIn, Crunchbase, or Twitter, across both investors and non-investor people.

### Filters

* **GET /industry/search** -- Look up industries and super categories by name with fuzzy matching and relevance scoring; optionally filter by type (`INDUSTRY` or `SUPER_CATEGORY`).
* **GET /location/search** -- Look up locations by name with fuzzy matching and relevance scoring; optionally filter by type (`CITY`, `STATE`, `REGION`, or `COUNTRY`).

<Tip>
  `locations`, `industries`, and `super_categories` filters must use **exact
  permalinks** — a wrong value is silently ignored and returns zero results. Always
  resolve labels via the search endpoints above first. See
  [Filtering & Permalinks](/api-reference/filtering) for the full workflow and the
  round-type enum values.
</Tip>

### Alerts

* **GET /alerts** -- Retrieve saved alert data with all matching deals in a date range (up to 10 alerts per request). Deals are deduplicated, sorted newest-first, and each includes AI-generated reasoning for why it matched.
* **GET /alerts/configurations** -- List the authenticated user's alert configurations (filters, frequency, descriptions). Does not consume usage credits.

## Error Handling

All endpoints return consistent error responses:

| Status Code | Description                                              |
| ----------- | -------------------------------------------------------- |
| **400**     | Bad request (invalid parameters)                         |
| **401**     | Unauthorized (missing or invalid API key)                |
| **422**     | Validation error (unknown parameter, invalid enum value) |
| **429**     | Rate limit exceeded                                      |
| **500**     | Internal server error                                    |