API Documentation

v1.0REST

API for extracting and converting financial data from PDFs, CSV, OFX, and other accounting files

Base URL

https://accountingconverter.com

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-api-key: ac_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
Starter10500 a month, or 6,000 a year on the yearly plan
Professional301,250 a month, or 15,000 a year on the yearly plan
Business505,000 a month, or 60,000 a year on the yearly plan

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

Error Codes

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

202

Accepted

Upload queued, or /result asked before the job finished: check /status and try again

400

Bad Request

Missing or invalid field, unsupported file type, a failed job, or an invalid exchange_rate

401

Unauthorized

Missing or invalid API key

403

Forbidden

Subscription paused

404

Not Found

No job with this ID on your account

413

Payload Too Large

File size exceeds 25MB limit

422

Unprocessable

The PDF cannot be read, or no transactions could be read from the job

429

Too Many Requests

Rate limit exceeded, or your plan's pages are used up

500

Internal Server Error

Server error during processing

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

Need help with the API? Contact us at [email protected] or visit our Support page.