Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Fintent Public API
description: 'Welcome to **Fintent API**!
You can now access Fintent''s predictive scores like **CapRaise Score**, **M&A Score**, **Distress Score** or **Deal-Maker Scores** via our RESTful API.
For any questions and to get your API Key, reach out to support@fintent.ai.
## Authentication
All API requests require a valid API key passed as a Bearer token in the `Authorization` header:
```
Authorization: Bearer YOUR_API_KEY
```
## Rate Limits
| Limit | Description |
|-------|-------------|
| **60 requests per minute** | Per API key, fixed 60-second window |
| **200 MCP tool calls per minute** | Per organization, across every connected MCP client, fixed 60-second window. The REST limit above does not apply to MCP. Over the limit, a tool call returns an error saying how many seconds to wait. |
| **500 domains per request** | Maximum number of domains you can send in a single `/signals`, `/signals/history` or screener-write call |
| **Weekly unique companies** | Maximum unique companies you can query per week (plan-dependent). Re-querying the same domain does not count again. |
| **Tracked companies** | Maximum companies you can hold across all screeners (plan-dependent). Every screener entry counts, so a company in two screeners counts twice. |
| **Monthly deletions** | Maximum companies you can remove from screeners per month (plan-dependent). Resets on the 1st. |
Rate limit and usage information is included in response headers:
| Header | Description |
|--------|-------------|
| `X-RateLimit-Limit` | Max requests per minute |
| `X-RateLimit-Remaining` | Requests remaining in current window |
| `X-RateLimit-Reset` | Seconds until the rate limit window resets |
| `X-Usage-Limit` | Your weekly unique company limit |
| `X-Usage-Remaining` | Remaining unique companies this week |
You can also check your current usage anytime via the `/health` endpoint.
When a rate limit is exceeded, the API returns a `429 Too Many Requests` response with a `Retry-After` header.'
version: 2.0.0
servers:
- url: /
description: Current environment
- url: https://app.fintent.ai
description: Production server
security:
- BearerAuth: []
tags:
# --- truncated at 32 KB (59 KB total) ---
# Full source: https://artifacts.apis.io/fintent-ai/openapi/fintent-ai-public-api-openapi.yml