> For the complete documentation index, see [llms.txt](https://docs.theangel.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.theangel.app/api-and-technical-documentation/api-overview.md).

# API Overview

TheAngel provides a suite of APIs and smart contract interfaces designed to enable seamless integration with external systems, wallets, analytics tools, and partner platforms.

This documentation describes the available endpoints, authentication mechanisms, smart contract structure, and webhook events.

**The goal is to support:**

* Wallet integrations
* Founder dashboards
* Investor analytics tools
* Third-party marketplaces
* Internal automation

***

### Overview

TheAngel APIs allow developers to:

* Retrieve startup listing data
* Access investor portfolio data
* Execute token operations (where permitted)
* Retrieve token and valuation metadata
* Subscribe to liquidity-related events
* Integrate secure identity and compliance verification

***

### API Architecture

TheAngel API is built with:

* REST + Webhook support
* JWT-based authentication
* Enforced TLS encryption
* Compliance-gated endpoints
* Standardised data models
* Role-based access controls (RBAC

***

### Authentication

#### Authentication Method

TheAngel uses JWT (JSON Web Tokens) for all API calls.

#### Steps to Authenticate

**1. Request API Key**

Developers generate a key via:

```solidity
POST /developer/api-key
```

**2. Authenticate with Credentials**

```solidity
POST /auth/token
Content-Type: application/json
{
  "apiKey": "YOUR_API_KEY",
  "secret": "YOUR_SECRET"
}
```

**3. Response**

```solidity
{
  "accessToken": "JWT_TOKEN",
  "expiresIn": 3600
}
```

**4. Include Token in Headers**

```solidity
Authorization: Bearer JWT_TOKEN
```