Skip to main content

​
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

PlanRequests per minuteRequests per day
Growth + Agents6010,000
Enterprise300100,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

EndpointMethodDescription
/api/customersGETList all customers
/api/customers/:idGETGet customer details
/api/contractsGETList all contracts
/api/invoicesGETList invoices
/api/ticket-intelligence/importPOSTImport support tickets
/api/webhooks/ticketsPOSTPush ticket events
/api/cfo/predictionsGETGet churn predictions
Full endpoint documentation coming soon. Contact founders@fincelo.app for early access.