API Documentation

Programmatically upload invoices and receive structured, AI-extracted data. Available on the Scale plan.

Authentication

All API requests require a Bearer token. Create a token from your account's API tokens page.

Authorization: Bearer YOUR_API_TOKEN
Accept: application/json

Upload an invoice

Upload a PDF or image. AutoPayables stores it, runs AI extraction, and returns a structured bill.

POST /api/invoices/upload

curl -X POST https://autopayables.com/api/invoices/upload \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "[email protected]"

Response

{
  "success": true,
  "bill": {
    "id": 128,
    "hash": "a1b2c3d4-…",
    "status": "draft",
    "vendor": "Acme Supplies",
    "invoice_number": "INV-4821",
    "invoice_date": "2026-05-20",
    "due_date": "2026-06-19",
    "currency": "USD",
    "subtotal": 3000.00,
    "tax": 200.00,
    "total": 3200.00,
    "line_items": [
      { "description": "Widget A", "quantity": 10, "unit_price": 300, "amount": 3000 }
    ]
  }
}

Retrieve a bill

GET /api/invoices/{hash}

List bills & vendors

GET/api/invoices

GET/api/vendors

Get your API token

API access is included on the Scale plan.

View plans