Finvry Data API

Push figures and contacts into Finvry as they change in your own systems (accounting, CRM, data warehouse, Zapier or Make), and pull your data out. Everything is JSON over HTTPS.

Base URLhttps://app.finvry.com/api/v1

Authentication

Create a key in Settings → Data API. Read keys can only read; write keys can also add data. Send the key as a bearer token. Keys belong to one workspace and are shown once; revoke a key at any time.

Authorization: Bearer fv_live_…

Rate limits

600 requests per minute per key. Above that you get 429; wait a minute and retry.

Errors

Errors return a status code and a JSON body with a code and a human-readable message.

`401`	Missing, wrong or revoked key
`403`	The key lacks write access, or API access is switched off
`422`	The request body failed validation (the message says which field)
`429`	Rate limit reached

{ "statusCode": 422, "data": { "error": { "code": "invalid", "message": "Check period_type, period_end (YYYY-MM-DD), currency and the figures." } } }

GET/financialsread key

List statements

Your monthly, quarterly or yearly statements in their original currency, with derived metrics (gross margin, EBITDA, burn, runway).

Query parameter	Type	Description
`period_type`	string	month (default), quarter or year

Request

curl https://app.finvry.com/api/v1/financials?period_type=… \
  -H "Authorization: Bearer fv_live_…"

Response

{
  "data": [
    {
      "period_end": "2026-09-30",
      "period_type": "month",
      "currency": "USD",
      "lines": { "revenue": 120000, "cogs": 40000, "cash": 900000 },
      "kpis": { "customers": 412 },
      "metrics": { "gross_margin": 0.667, "burn": 35000, "runway_months": 25.7 },
      "source": "api"
    }
  ]
}

POST/financialswrite key

Add or replace a period

Creates the statement for a period, or replaces it if it exists. Send only the lines you have.

Body field	Type	Description
`period_type`required	string	month, quarter or year
`period_end`required	date	Last day of the period, YYYY-MM-DD
`currency`required	string	ISO code, e.g. USD or NGN
`lines`	object	revenue, cogs, opex_payroll, opex_marketing, opex_rnd, opex_ga, opex_other, depreciation, interest, tax, net_income, cash, receivables, inventory, other_assets, total_assets, payables, debt, other_liabilities, equity …
`kpis`	object	Any numeric KPIs, e.g. { "customers": 412 }
`notes`	string	Optional note (max 1,000 characters)

Request

curl -X POST https://app.finvry.com/api/v1/financials \
  -H "Authorization: Bearer fv_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "period_type": "month", "period_end": "2026-09-30", "currency": "USD", "lines": { "revenue": 120000, "cogs": 40000, "cash": 900000 } }'

Response

{ "ok": true, "id": "…", "replaced": false }

GET/metricsread key

Latest metrics

Key metrics for the latest month, in your reporting currency.

Request

curl https://app.finvry.com/api/v1/metrics \
  -H "Authorization: Bearer fv_live_…"

Response

{
  "data": {
    "period_end": "2026-09-30",
    "currency": "USD",
    "metrics": { "revenue": 120000, "gross_margin": 0.667, "burn": 35000, "runway_months": 25.7 }
  }
}

GET/contactsread key

List contacts

Your investor and partner contacts with their lists.

Query parameter	Type	Description
`updated_since`	date	Only contacts created on or after this date

Request

curl https://app.finvry.com/api/v1/contacts?updated_since=… \
  -H "Authorization: Bearer fv_live_…"

Response

{
  "data": [
    { "id": "…", "name": "Amara Obi", "email": "[email protected]", "firm": "Ventures Africa", "lists": ["Investors"], "subscribed": true }
  ]
}

POST/contactswrite key

Add or update contacts

Matched by email. Up to 1,000 per request. Lists are created if they do not exist.

Body field	Type	Description
`contacts`required	array	[{ name, email, firm?, title?, lists? }]

Request

curl -X POST https://app.finvry.com/api/v1/contacts \
  -H "Authorization: Bearer fv_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "contacts": [ { "name": "Amara Obi", "email": "[email protected]", "firm": "Ventures Africa", "lists": ["Investors"] } ] }'

Response

{ "ok": true, "added": 1, "updated": 0 }

GET/complianceread key

Compliance deadlines

Your filing and renewal deadlines, soonest first.

Request

curl https://app.finvry.com/api/v1/compliance \
  -H "Authorization: Bearer fv_live_…"

Response

{
  "data": [
    { "title": "Delaware franchise tax", "category": "franchise_tax", "next_due": "2027-03-01", "days_left": 147 }
  ]
}

GET/pipelinesread key

Fundraising pipelines

Each pipeline with its investors, stages and amounts.

Request

curl https://app.finvry.com/api/v1/pipelines \
  -H "Authorization: Bearer fv_live_…"

Response

{
  "data": [
    { "name": "Seed", "currency": "USD", "target": 1500000, "investors": [{ "investor": "Partech Africa", "stage": "Diligence", "amount": 500000 }] }
  ]
}