User - Ledgers

Base URL: https://your-domain.com

Admin endpoints for managing ledgers and transaction history. All endpoints require admin/staff authentication.

---

Fetch All Ledgers

Retrieve transaction ledger entries with optional filters.

Property	Value
Endpoint	Fetch All Ledgers
Method	GET
URL	/api/v1/ledgers
Authentication	Bearer Token

Request Headers:

Header	Value	Required
Accept	application/json	Yes
Authorization	Bearer your-auth-token	Yes

Query Parameters:

Parameter	Type	Required	Description
isp_id	integer	Yes	ISP ID
branch_id	integer	Yes	Branch ID
user_id	integer	Yes	User ID
subscriber_id	integer	No	Filter by subscriber
type	string	No	Filter by type (credit, debit)
from_date	date	No	Start date filter
to_date	date	No	End date filter

Request Body: None

Success Response (200 OK):

{
    "success": true,
    "data": {
        "ledgers": [
            {
                "id": 1,
                "subscriber_id": 1,
                "subscriber_name": "John Doe",
                "type": "credit",
                "amount": 1000,
                "balance_after": 1500,
                "description": "Payment received",
                "reference": "PAY-2024-001",
                "created_at": "2024-01-15 10:30:00"
            }
        ],
        "total": 100,
        "total_credit": 50000,
        "total_debit": 45000
    }
}

Error Response (401 Unauthorized):

{
    "success": false,
    "message": "Unauthenticated"
}