- Base URL:
https://api.finta.io/v2 - Format: JSON
- Authentication: Bearer token (API key)
Requirements
| Requirement | Details |
|---|---|
| Active subscription | API access is available on Standard and Pro plans. |
| Storage Mode | The v2 API reads from data Finta has already synced and stored. Creating an API key from the dashboard enables Storage Mode automatically. |
| API key | Generate one from API settings. |
Rate limits
| Plan | Limit |
|---|---|
| Standard | 200 requests / minute |
| Pro | Higher limits (contact us) |
429 RATE_LIMITED. The response may include a retryAfter field (seconds).
Errors
Most errors use a structured envelope:| Code | HTTP | When |
|---|---|---|
BAD_REQUEST | 400 | Invalid parameters or body |
STORAGE_MODE_REQUIRED | 403 | Storage mode is off |
SUBSCRIPTION_REQUIRED | 403 | Subscription inactive or canceled |
NOT_FOUND | 404 | Resource missing or not owned by the caller |
RATE_LIMITED | 429 | Rate limit exceeded |
PROVIDER_UNAVAILABLE | 502 | Upstream provider error |
INTERNAL_ERROR | 500 | Unexpected server error |
401 responses use a plain string rather than the envelope: