توثيق API

Authorization: Bearer <your_api_key>

https://api.bayainy.com/api/v1

POST /upload/preview HTTP/1.1
Authorization: Bearer <your_api_key>
Content-Type: multipart/form-data
 
file: statement.pdf

{
  "page_count": 3,
  "digital_pages": 2,
  "scanned_pages": 1,
  "credit_cost": 4,
  "pages": [
    { "page": 1, "type": "digital" },
    { "page": 2, "type": "digital" },
    { "page": 3, "type": "scanned" }
  ]
}

POST /upload HTTP/1.1
Authorization: Bearer <your_api_key>
Content-Type: multipart/form-data
 
file: statement.pdf

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "filename": "statement.pdf",
  "status": "pending",
  "page_count": 3,
  "estimated_seconds": 6
}

GET /statements/550e8400-e29b-41d4-a716-446655440000 HTTP/1.1
Authorization: Bearer <your_api_key>

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "bank_name": "Al Rajhi Bank",
  "transaction_count": 42,
  "opening_balance": 12480.00,
  "closing_balance": 24755.00,
  "available_exports": ["excel", "csv", "qbo", "xml"],
  "transactions": [
    {
      "date": "2026-09-01",
      "description": "Card purchase, Panda",
      "debit": 184.50,
      "credit": 0.00,
      "balance": 12295.50,
      "category": "grocery",
      "reference": "FT26244S1K7Q",
      "page_number": 1
    }
  ]
}

GET /statements HTTP/1.1
Authorization: Bearer <your_api_key>

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "filename": "statement.pdf",
    "status": "completed",
    "transaction_count": 42
  }
]

GET /download/550e8400-e29b-41d4-a716-446655440000/excel HTTP/1.1
Authorization: Bearer <your_api_key>

HTTP/1.1 200 OK
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
 
<binary .xlsx file>

DELETE /statements/550e8400-e29b-41d4-a716-446655440000 HTTP/1.1
Authorization: Bearer <your_api_key>

HTTP/1.1 204 No Content