OpenSkillIndex← back to search
claude-codeopenclawdata

Skills bank-statement-converter

Bank Statement Converter Skill

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/ballerindustries/bank-statement-converter" ~/.claude/skills/openclaw-skills-bank-statement-converter && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/ballerindustries/bank-statement-converter" ~/.openclaw/skills/openclaw-skills-bank-statement-converter && rm -rf "$T"
manifest: skills/ballerindustries/bank-statement-converter/SKILL.md
tags
#bank-statements#pdf-parsing#data-extraction#csv#json#api-integration
source content

Bank Statement Converter Skill

Convert PDF bank statements to CSV/JSON.

Requirements

BANKSTATEMENT_API_KEY

Setup

  1. Register here https://bankstatementconverter.com/legacy-register
  2. Verify your email
  3. Login https://bankstatementconverter.com/login
  4. Get your API key here https://bankstatementconverter.com/settings
export BANKSTATEMENT_API_KEY="your-api-key-here"

APIs

Get your remaining credits and user info

curl -s -H "Authorization: $BANKSTATEMENT_API_KEY" \
  https://api2.bankstatementconverter.com/api/v1/user | jq

Shows user details and credits.

Upload a PDF bank statement

curl -s -X POST \
  -H "Authorization: $BANKSTATEMENT_API_KEY" \
  -F "file=@/path/to/your/bankstatement.pdf" \
  https://api2.bankstatementconverter.com/api/v1/BankStatement | jq

Response example (array of uploaded items):

[
  {
    "uuid": "bb2f3c62-331e-42ee-a931-d25a5ee0946f",
    "filename": "bankstatement.pdf",
    "pdfType": "TEXT_BASED",
    "state": "READY"
  }
]

Save the uuid for the next steps. If state is PROCESSING, poll status.

Check processing status (poll if needed)

curl -s -X POST \
  -H "Authorization: $BANKSTATEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '["bb2f3c62-331e-42ee-a931-d25a5ee0946f"]' \
  https://api2.bankstatementconverter.com/api/v1/BankStatement/status | jq

Poll every ~10 seconds until state becomes READY.

Convert PDF JSON (normalized transactions)

curl -s -X POST \
  -H "Authorization: $BANKSTATEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '["bb2f3c62-331e-42ee-a931-d25a5ee0946f"]' \
  "https://api2.bankstatementconverter.com/api/v1/BankStatement/convert?format=JSON&raw=false" | jq

For CSV instead: change format=CSV. Add &raw=true to get all raw columns instead of normalized.

Provide password for encrypted PDF

If upload returns pdfType: UNKNOWN or indicates password needed:

curl -s -X POST \
  -H "Authorization: $BANKSTATEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"passwords": [{"uuid": "bb2f3c62-331e-42ee-a931-d25a5ee0946f", "password": "yourpdfpassword"}]}' \
  https://api2.bankstatementconverter.com/api/v1/BankStatement/setPassword | jq

Then poll status or convert as above.# Markdown syntax guide