Bank Statement Converter

Bank Statement Converter Skill\r

\r Convert PDF bank statements to CSV/JSON.\r \r

Requirements\r

BANKSTATEMENT_API_KEY\r \r

Setup\r

\r

1. Register here https://bankstatementconverter.com/legacy-register\r
2. Verify your email\r
3. Login https://bankstatementconverter.com/login\r
4. Get your API key here https://bankstatementconverter.com/settings\r \r

export BANKSTATEMENT_API_KEY="your-api-key-here"\r
```\r
\r
## APIs\r
\r
### Get your remaining credits and user info\r
```Bash\r
curl -s -H "Authorization: $BANKSTATEMENT_API_KEY" \\r
  https://api2.bankstatementconverter.com/api/v1/user | jq\r
```\r
\r
Shows user details and credits.\r
\r
### Upload a PDF bank statement\r
\r
```Bash\r
curl -s -X POST \\r
  -H "Authorization: $BANKSTATEMENT_API_KEY" \\r
  -F "file=@/path/to/your/bankstatement.pdf" \\r
  https://api2.bankstatementconverter.com/api/v1/BankStatement | jq\r
```\r
\r
Response example (array of uploaded items):\r
\r
```JSON\r
[\r
  {\r
    "uuid": "bb2f3c62-331e-42ee-a931-d25a5ee0946f",\r
    "filename": "bankstatement.pdf",\r
    "pdfType": "TEXT_BASED",\r
    "state": "READY"\r
  }\r
]\r
```\r
\r
Save the uuid for the next steps. If state is PROCESSING, poll status.\r
\r
### Check processing status (poll if needed)\r
```Bash\r
curl -s -X POST \\r
  -H "Authorization: $BANKSTATEMENT_API_KEY" \\r
  -H "Content-Type: application/json" \\r
  -d '["bb2f3c62-331e-42ee-a931-d25a5ee0946f"]' \\r
  https://api2.bankstatementconverter.com/api/v1/BankStatement/status | jq\r
```\r
  \r
  \r
Poll every ~10 seconds until state becomes READY.\r
\r
### Convert PDF JSON (normalized transactions)\r
\r
```Bash\r
curl -s -X POST \\r
  -H "Authorization: $BANKSTATEMENT_API_KEY" \\r
  -H "Content-Type: application/json" \\r
  -d '["bb2f3c62-331e-42ee-a931-d25a5ee0946f"]' \\r
  "https://api2.bankstatementconverter.com/api/v1/BankStatement/convert?format=JSON&raw=false" | jq\r
```\r
  \r
For CSV instead: change format=CSV. Add &raw=true to get all raw columns instead of normalized.\r
\r
### Provide password for encrypted PDF\r
If upload returns pdfType: UNKNOWN or indicates password needed:\r
\r
```Bash\r
curl -s -X POST \\r
  -H "Authorization: $BANKSTATEMENT_API_KEY" \\r
  -H "Content-Type: application/json" \\r
  -d '{"passwords": [{"uuid": "bb2f3c62-331e-42ee-a931-d25a5ee0946f", "password": "yourpdfpassword"}]}' \\r
  https://api2.bankstatementconverter.com/api/v1/BankStatement/setPassword | jq\r
```\r
  \r
Then poll status or convert as above.# Markdown syntax guide\r