API Documentation

v1.0REST

API for extracting transaction data from PDF bank statements with AI-powered processing

Base URL

https://bankstatementconverters.ai

All API endpoints are prefixed with /api/v1

Authentication

All API requests require authentication using your API key. Include your key in the request header:

x-bsc-api-key: bsc_live_your_api_key_here

Keep your API key secure

Never expose your API key in client-side code or public repositories. Always make API calls from your backend server.

API Endpoints

Rate Limits

Rate limits vary by plan tier and are enforced per minute:

PlanRequests/MinutePages/Month
Starter10800
Professional302,000
Business508,000

Note: Rate limit headers are included in all API responses:X-RateLimit-Limit andX-RateLimit-Remaining

Error Codes

The API uses standard HTTP status codes to indicate success or failure:

400

Bad Request

Invalid request format or missing required fields

401

Unauthorized

Missing or invalid API key

413

Payload Too Large

File size exceeds 10MB limit

415

Unsupported Media Type

File format not supported

429

Too Many Requests

Rate limit exceeded or quota exhausted

500

Internal Server Error

Server error during processing

503

Service Unavailable

API temporarily unavailable

Best Practices

  • Implement retry logic with exponential backoff for rate limit and server errors
  • Validate files client-side before uploading (file type, size, page count)
  • Store API keys securely using environment variables, never in code
  • Monitor your usage regularly via the dashboard or /api/v1/usage endpoint
  • Use HTTPS for all API requests to ensure data security
  • Cache results when appropriate to reduce API calls and improve performance