API Reference

Authorization: Bearer ll_a3f8b2c1d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0

{
  "transactions": [
    {
      "id": "job123-0",
      "date": "2024-03-05",
      "description": "AMAZON WEB SERVICES",
      "debit": 87.43,
      "credit": null,
      "balance": 18345.07,
      "category": "software"
    },
    {
      "id": "job123-1",
      "date": "2024-03-10",
      "description": "ACH PAYROLL GUSTO INC",
      "debit": 6500.00,
      "credit": null,
      "balance": 11845.07,
      "category": "payroll"
    },
    {
      "id": "job123-2",
      "date": "2024-03-18",
      "description": "WIRE TRANSFER RECEIVED CLIENT PMT",
      "debit": null,
      "credit": 7500.00,
      "balance": 19345.07,
      "category": "income"
    }
  ],
  "bankDetected": "Chase Business Checking",
  "pageCount": 3,
  "rowCount": 47,
  "jobId": "0f9d2c1e-..."
}

{ "error": "Monthly page limit reached." }

curl -X POST https://ledgerlift.me/api/v1/parse \
  -H "Authorization: Bearer ll_your_api_key_here" \
  -F "file=@/path/to/statement.pdf"

const fs = require('fs')
const FormData = require('form-data')

async function parseStatement(filePath) {
  const form = new FormData()
  form.append('file', fs.createReadStream(filePath))

  const res = await fetch('https://ledgerlift.me/api/v1/parse', {
    method: 'POST',
    headers: {
      Authorization: 'Bearer ll_your_api_key_here',
      ...form.getHeaders(),
    },
    body: form,
  })

  if (!res.ok) {
    const { error } = await res.json()
    throw new Error(error)
  }

  const { transactions, bankDetected, rowCount } = await res.json()
  console.log(`${bankDetected}: ${rowCount} transactions`)
  return transactions
}

parseStatement('./chase_march_2024.pdf')

import requests

def parse_statement(file_path: str, api_key: str) -> list[dict]:
    with open(file_path, 'rb') as f:
        response = requests.post(
            'https://ledgerlift.me/api/v1/parse',
            headers={'Authorization': f'Bearer {api_key}'},
            files={'file': f},
        )

    response.raise_for_status()
    data = response.json()

    print(f"{data['bankDetected']}: {data['rowCount']} transactions")
    return data['transactions']


transactions = parse_statement('statement.pdf', 'll_your_api_key_here')

# Filter to debits only
debits = [t for t in transactions if t['debit'] is not None]
total = sum(t['debit'] for t in debits)
print(f"Total spent: ${total:,.2f}")

interface Transaction {
  id: string
  date: string
  description: string
  debit: number | null
  credit: number | null
  balance: number | null
  category: string
}

interface ParseResponse {
  transactions: Transaction[]
  bankDetected: string
  pageCount: number
  rowCount: number
}

async function parseStatement(file: File, apiKey: string): Promise<ParseResponse> {
  const form = new FormData()
  form.append('file', file)

  const res = await fetch('https://ledgerlift.me/api/v1/parse', {
    method: 'POST',
    headers: { Authorization: `Bearer ${apiKey}` },
    body: form,
  })

  if (!res.ok) {
    const { error } = await res.json()
    throw new Error(error)
  }

  return res.json()
}