API Reference - Fincelo

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.

The Fincelo API is currently in private beta. Access is available to Enterprise plan subscribers. Contact founders@fincelo.app to request access.

Base URL

https://app.fincelo.app/api

Authentication

All API requests require a Bearer token:

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:

{
  "success": true,
  "data": { ... },
  "error": null
}

Error responses:

{
  "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 for early access.

​Overview

​Base URL

​Authentication

​Rate Limits

​Response Format

​Key Endpoints

Overview

Base URL

Authentication

Rate Limits

Response Format

Key Endpoints