Skip to main content

Subscription Records

This section covers the API endpoints for managing subscription records in the admin panel. Subscription records track the history of changes made to subscriptions, including transfers between customers and status changes.

List Subscription Records​

Retrieve a paginated list of subscription records for a specific subscription.

GET /v1/admin/subscriptions/{id}/subscription-records

Query Parameters​

ParameterTypeDescription
filter[created_at]stringFilter by creation date
search_textstringSearch in usernames, full names, operations, and descriptions
per_pageintegerNumber of items per page (default: 10)

Response​

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "current_page": 1,
        "first_page_url": "http://192.168.0.139:8080/v1/admin/subscriptions/572eb2c0-d260-11ef-8384-7f36cc3384ae/subscription-records?page=1",
        "from": 1,
        "last_page": 1,
        "last_page_url": "http://192.168.0.139:8080/v1/admin/subscriptions/572eb2c0-d260-11ef-8384-7f36cc3384ae/subscription-records?page=1",
        "links": [
            {
                "url": null,
                "label": "« السابق",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/subscriptions/572eb2c0-d260-11ef-8384-7f36cc3384ae/subscription-records?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "التالي »",
                "active": false
            }
        ],
        "next_page_url": null,
        "path": "http://192.168.0.139:8080/v1/admin/subscriptions/572eb2c0-d260-11ef-8384-7f36cc3384ae/subscription-records",
        "per_page": 10,
        "prev_page_url": null,
        "to": 4,
        "total": 4,
        "subscription_records": [
            {
                "id": "5734f2e0-d260-11ef-822b-e33603268162",
                "causer_name": "فاطمة الحداد",
                "causer_email": "zahraaalhaddad.2031@hotmail.com",
                "causer_type": "customer",
                "current_owner_name": "فاطمة الحداد",
                "current_owner_email": "zahraaalhaddad.2031@hotmail.com",
                "previous_owner_name": null,
                "previous_owner_email": null,
                "operation": "اشتراك جديد",
                "description": "اشتراك مجاني",
                "created_at": "2025-01-14T10:14:29.000000Z"
            },
            {
                "id": "0729c5a0-05aa-11f0-83cd-7ff05acceb09",
                "causer_name": "omar Alakbri",
                "causer_email": "mazenahmed@bootfi.com",
                "causer_type": "admin",
                "current_owner_name": "Noor Now",
                "current_owner_email": "ladynmb@hotmail.com",
                "previous_owner_name": "فاطمة الحداد",
                "previous_owner_email": "zahraaalhaddad.2031@hotmail.com",
                "operation": "نقل اشتراك",
                "description": null,
                "created_at": "2025-03-20T16:40:27.000000Z"
            },
            {
                "id": "072bfeb0-05aa-11f0-8be6-fbe37d711f5d",
                "causer_name": "omar Alakbri",
                "causer_email": "mazenahmed@bootfi.com",
                "causer_type": "admin",
                "current_owner_name": "Noor Now",
                "current_owner_email": "ladynmb@hotmail.com",
                "previous_owner_name": "Noor Now",
                "previous_owner_email": "ladynmb@hotmail.com",
                "operation": "تحديث تاريخ الإنتهاء",
                "description": null,
                "created_at": "2025-03-20T16:40:27.000000Z"
            },
            {
                "id": "1759d2e0-05aa-11f0-85ca-e1e1992ce90c",
                "causer_name": "omar Alakbri",
                "causer_email": "mazenahmed@bootfi.com",
                "causer_type": "admin",
                "current_owner_name": "Mohammed Bootfi",
                "current_owner_email": "mohammed@bootfi.com",
                "previous_owner_name": "Noor Now",
                "previous_owner_email": "ladynmb@hotmail.com",
                "operation": "نقل اشتراك",
                "description": null,
                "created_at": "2025-03-20T16:40:54.000000Z"
            }
        ]
    },
    "status_code": 200
}

Notes​

  • The subscription records are sorted by creation date in ascending order by default.
  • The search functionality looks for matches in:
    • Previous owner's username and full name
    • Current owner's username and full name
    • Causer's username and full name
    • Operation type
    • Description