FinAiQ API

Upload invoices, receipts and bank statements, read what FinAiQ extracts, validate and export it to your accounting system, and get a webhook the moment anything changes.

AuthenticationOAuth2 client credentials for server integrations. ConventionsResponses, errors, pagination, rate limits, idempotency. WebhooksEvents, payloads and verifying signatures. API referenceEvery public endpoint, with schemas.

Base URL

https://api.finaiq.ai/finaiq/api/v1

All requests use HTTPS and JSON. Send Authorization: Bearer <access token> on every call except the token request.

How documents flow

Status	Meaning
`UPLOADED`	Received; waiting to be read.
`EXTRACTING` → `EXTRACTED`	Being read, then the extracted data is ready to review.
`VALIDATED`	Reviewed and approved for export.
`EXPORTING` → `EXPORTED`	Sent to the connected accounting system, then confirmed.
`EXPORT_FAILED`	The accounting system refused it; the reason is on the document. Fix and export again.

Quick start

# 1. Get a token with your API client (FinAiQ → API clients)
ACCESS_TOKEN=$(curl -s https://api.finaiq.ai/finaiq/api/v1/oauth/token \
  -u "$CLIENT_ID:$CLIENT_SECRET" -d grant_type=client_credentials | jq -r .access_token)

# 2. List your folders
curl -s https://api.finaiq.ai/finaiq/api/v1/folders \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Pricing

Published plans are available without authentication: GET /api/v1/public/pricing?currency=USD.