Skip to main content
The Finta API gives you programmatic access to your company’s financial data: transactions, journal entries, categories, and financial reports. The API is read-only for now.

​
Base URL

All requests go to: 
https://app.finta.com/api/v1

​
Authentication

Include your API key in the Authorization header as a Bearer token: 
curl https://app.finta.com/api/v1/company \
  -H "Authorization: Bearer finta_your_key_here"
Each API key is tied to the user who created it and scoped to a single company. There is no company ID parameter; the key already knows which company it belongs to. If you manage multiple companies, create a separate key for each. If you are removed from a company, your key automatically loses access.
1

Go to API Keys

Log into Finta and go to Settings > API Keys.
2

Create a key

Click Create API key.
3

Copy the key

Copy the key immediately. It starts with finta_ and is only shown once. You cannot retrieve it later.

​
Content Type

All responses are returned as JSON. There are no request bodies; all parameters are passed as query strings.

​
Monetary Amounts

All monetary amounts are returned as integers in cents and use a _cents suffix (e.g. amount_cents, balance_cents, total_cents). For example, $499.00 is represented as 49900. Divide by 100 to get the dollar amount. This avoids floating-point precision issues.

​
Response Codes

StatusDescription
200Success.
400Bad request. A required parameter is missing or invalid.
401Unauthorized. API key is missing, malformed, or revoked.
404Not found. The endpoint path does not exist.
429Rate limited. Either the per-minute burst limit or monthly call limit was exceeded.
5xxServer error. Something went wrong on our end.
See Errors for the full list of error codes with resolution steps.

​
Making Your First Request

Verify your API key by pulling your company’s metadata: 
curl https://app.finta.com/api/v1/company \
  -H "Authorization: Bearer finta_your_key_here"

{
  "id": "comp_a1b2c3d4e5f6g7",
  "object": "company",
  "name": "Acme Corp",
  "legal_name": "Acme Corp Inc.",
  "entity_type": "c_corp",
  "federal_ein": "12-3456789",
  "incorporation": {
    "date": "2022-10-21",
    "state": "delaware"
  },
  "legal_address": {
    "line_1": "548 Market Street",
    "line_2": "PMB 39381",
    "city": "San Francisco",
    "state": "california",
    "postal_code": "94104",
    "country": "United States"
  },
  "created": 1688053841
}
From here, try pulling your income statement, balance sheet, or journal entries. To understand how these relate, see Data Model.