Authentication

Bearer Token

Pass your API key in the Authorization header. Both the Bearer prefix and plain key formats are accepted.

curl -X POST https://api.finconvert.dev/v1/parse \
  -H "Authorization: Bearer fc_live_xxxxx" \  # Your API key
  -F "file=@bank-statement.mt940"              # Upload a local file

const form = new FormData()
form.append('file', fs.createReadStream('statement.mt940'))

const response = await fetch('https://api.finconvert.dev/v1/parse', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer fc_live_xxxxx' },
  body: form,
})

const data = await response.json()

import requests

with open('statement.mt940', 'rb') as f:
    response = requests.post(
        'https://api.finconvert.dev/v1/parse',
        headers={'Authorization': 'Bearer fc_live_xxxxx'},
        files={'file': f},
    )

data = response.json()

API Key Prefixes

FinConvert uses prefixed API keys to distinguish between production and sandbox environments.

Test vs Live Environments

Both key types hit the same API endpoint and produce real conversions. The difference is in how usage is tracked:

• Live keys — Usage counts toward your monthly billing quota. Rate limits depend on your plan.
• Test keys — Usage is tracked separately with a fixed limit of 200 conversions/month and 30 requests/60 seconds, regardless of your plan.