Skip to main content
The Finta API lets you read your stored financial data — accounts, transactions, balances, holdings, investment activity, and bank connections — from any HTTP client or script.
  • Base URL: https://api.finta.io/v2
  • Format: JSON
  • Authentication: Bearer token (API key)

Requirements

RequirementDetails
Active subscriptionAPI access is available on Standard and Pro plans.
Storage ModeThe v2 API reads from data Finta has already synced and stored. Creating an API key from the dashboard enables Storage Mode automatically.
API keyGenerate one from API settings.

Rate limits

PlanLimit
Standard200 requests / minute
ProHigher limits (contact us)
Requests that exceed the limit return 429 RATE_LIMITED. The response may include a retryAfter field (seconds).

Errors

Most errors use a structured envelope:
{
  "error": {
    "code": "STORAGE_MODE_REQUIRED",
    "message": "Storage mode must be enabled to use the v2 API"
  }
}
CodeHTTPWhen
BAD_REQUEST400Invalid parameters or body
STORAGE_MODE_REQUIRED403Storage mode is off
SUBSCRIPTION_REQUIRED403Subscription inactive or canceled
NOT_FOUND404Resource missing or not owned by the caller
RATE_LIMITED429Rate limit exceeded
PROVIDER_UNAVAILABLE502Upstream provider error
INTERNAL_ERROR500Unexpected server error
401 responses use a plain string rather than the envelope:
{ "error": "Missing or invalid Authorization header" }

OpenAPI spec

The full OpenAPI spec is available at:
https://api.finta.io/v2/openapi.json