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

# API Reference

> Fincelo API — authentication, base URL, and rate limits.

## Overview

The Fincelo API allows you to integrate Fincelo's revenue intelligence capabilities into your own systems — push ticket events, trigger agent actions, fetch ARR data, and more.

<Info>
  The Fincelo API is currently in private beta. Access is available to Enterprise plan subscribers. Contact [founders@fincelo.app](mailto:founders@fincelo.app) to request access.
</Info>

***

## Base URL

```
https://app.fincelo.app/api
```

***

## Authentication

All API requests require a Bearer token:

```bash theme={null}
curl -X GET "https://app.fincelo.app/api/customers"   -H "Authorization: Bearer YOUR_API_KEY"
```

Generate your API key: **Settings → API → Generate Key**

***

## Rate Limits

| Plan            | Requests per minute | Requests per day |
| --------------- | ------------------- | ---------------- |
| Growth + Agents | 60                  | 10,000           |
| Enterprise      | 300                 | 100,000          |

Rate limit headers are returned on every response:

```
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1720000000
```

***

## Response Format

All responses return JSON:

```json theme={null}
{
  "success": true,
  "data": { ... },
  "error": null
}
```

Error responses:

```json theme={null}
{
  "success": false,
  "data": null,
  "error": "Customer not found"
}
```

***

## Key Endpoints

| Endpoint                          | Method | Description            |
| --------------------------------- | ------ | ---------------------- |
| `/api/customers`                  | GET    | List all customers     |
| `/api/customers/:id`              | GET    | Get customer details   |
| `/api/contracts`                  | GET    | List all contracts     |
| `/api/invoices`                   | GET    | List invoices          |
| `/api/ticket-intelligence/import` | POST   | Import support tickets |
| `/api/webhooks/tickets`           | POST   | Push ticket events     |
| `/api/cfo/predictions`            | GET    | Get churn predictions  |

Full endpoint documentation coming soon. Contact [founders@fincelo.app](mailto:founders@fincelo.app) for early access.