Flutter E-Commerce Mobile App Documentation

🛒 Product APIs

GET /api/products

List all products

Input Example:

{baseurl}/api/products?page=1

Output Example:

{
    "success": true,
    "message": "Products retrieved successfully",
    "data": {
        "products": [
            {
                "id": 18,
                "slug": "Lava-Storm-Lite5G",
                "price": 1000,
                "offer_price": 999,
                "stock": "10",
                "is_offer": "0",
                "sales_count": 0,
                "new_label": "1",              
                "share_url": false,
                "default_image": {
                    "id": 66,
                    "product_id": 18,
                    "path": "product/tshirtpngWhnPa7Xd1wKrqHo41753338378.png",
                    "default": "1",
                    "locale": "en",
                    "url": "https://umc.askjitendra.com/storage/product/tshirtpngWhnPa7Xd1wKrqHo41753338378.png"
                },
                 
                "translations": [
                    {
                        "id": 18,
                        "product_id": 18,
                        "title": "Lava Storm Lite 5G",
                        "description": "Lava Storm Lite 5G",
                        "locale": "en"
                    },
                    {
                        "id": 22,
                        "product_id": 18,
                        "title": "Lava Storm Lite 5G",
                        "description": "Lava Storm Lite 5G",
                        "short_description": "Lava Storm Lite 5G",
                        "locale": "hi"
                    }
                ],               
            },
            .
            .            
        ]
    },
    "meta": {
        "total": 10,
        "per_page": 10,
        "current_page": 1,
        "languages": {
            "en": {
                "name": "English",
                "flag": "https://umc.askjitendra.com/storage/language/flags/en.png"
            }
        }
    },
    "errors": []
}

GET /api/product/range/{min_price}/{max_price}

Get products by min/max price

min_price max_price

Input Example:

{ "min_price": 100, "max_price": 500 }

Output Example:

{
    "success": true,
    "data": [
        {
            "id": 2,
            "slug": "ninja-silhouette",
            "price": 500,
            "offer_price": 400,
            "stock": "100",
            "is_offer": "0",
            "sales_count": 0,
            "new_label": "1",
            "featured": "0",
            "is_mlm_plan": "0",
            "eligible_for_commision": "0",
            "status": "1",
            "created_at": "2025-03-29T09:13:26.000000Z",
            "updated_at": "2025-03-29T09:13:26.000000Z",             
            "translations": [],
            "images": []
        },
        .
        .
    ],
    "meta": {
        "total": 5,
        "per_page": 10,
        "current_page": 1,
        "languages": {
            "en": {
                "name": "English",
                "flag": "https://umc.askjitendra.com/storage/language/flags/en.png"
            }
        }
    },
    "errors": []
}

GET /api/product/search

Search products by query string

Input Example:

{ "query": "shoes" }

{baseurl}/api/product/search?query=shoes

Output Example:

{
    "success": true,
    "data": [
        {
            "id": 5,
            "product_id": 5,
            "title": "Realme 7",             
            "locale": "en",
            "default_image_url": "https://umc.askjitendra.com/storage/product/realme-7292IxbzJsryAtOoha1754310559.png",
            "product": {
                "id": 5,
                "slug": "realme-7",
                "price": 19000,
                "offer_price": 17000,
                "stock": "5",
                "is_offer": "0",
                "sales_count": 0,
                "new_label": "1",
                "featured": "1",
                "is_mlm_plan": "0",
                "eligible_for_commision": "0",
                "status": "1",
                "created_at": "2025-03-29T09:13:26.000000Z",
                "updated_at": "2025-05-10T11:35:12.000000Z",
                "share_url": false,
                "default_image": {
                    "id": 124,
                    "product_id": 5,
                    "path": "product/realme-7292IxbzJsryAtOoha1754310559.png",
                    "default": "1",
                    "locale": "en",
                    "url": "https://umc.askjitendra.com/storage/product/realme-7292IxbzJsryAtOoha1754310559.png"
                },
                "default_image_url": "https://umc.askjitendra.com/storage/product/realme-7292IxbzJsryAtOoha1754310559.png",
                "title": {
                    "en": "Realme 7",
                    "locale": "Realme 7"
                },
                "translations": [
                    {
                        "id": 5,
                        "product_id": 5,
                        "title": "Realme 7",                         
                    }
                ]
            }
        }
    ],
    "meta": {
        "total": 1,
        "per_page": 10,
        "current_page": 1,
        "languages": {
            "en": {
                "name": "English",
                "flag": "https://umc.askjitendra.com/storage/language/flags/en.png"
            }
        }
    },
    "errors": []
}

GET /api/product/{id}

Get product details by ID

Input Example:

{ "id": 1 }

Output Example:

{
  "id": 1,
  "name": "Product 1",
  "price": 100,
  "description": "A sample product."
}

POST /api/getProductsByType

Get products by type (e.g. featured, new)

type

Input Example:

{ "type": "featured" }

Output Example:

{
  "products": [ { "id": 5, "name": "Featured Product", "price": 500 } ]
}

🏷️ Banner APIs

GET /api/banners

Get all banners for homepage or offers

Output Example:

{
    "success": true,
    "message": "Banners retrieved successfully",
    "data": [
        {
            "locale": "en",
            "title": "Big Sale",
            "subtitle": "This Week",
            "description": null,
            "slide_order": "1",
            "btn_url": null,
            "btn_label": null,
            "image": "/settings/a88073229ca85958d63a1d5b211a2bfb.jpeg",
            "image_url": "https://umc.askjitendra.com/storage//settings/a88073229ca85958d63a1d5b211a2bfb.jpeg"
        },
        {
            "locale": "en",
            "title": "Flat Shop",
            "subtitle": "Big Sale",
            "description": null,
            "slide_order": "2",
            "btn_url": null,
            "btn_label": null,
            "image": "/settings/0d9e5bcf7375807646e4fa0a905d174f.jpeg",
            "image_url": "https://umc.askjitendra.com/storage//settings/0d9e5bcf7375807646e4fa0a905d174f.jpeg"
        },
        {
            "locale": "en",
            "title": "Special",
            "subtitle": "Hot Sale",
            "description": null,
            "slide_order": "3",
            "btn_url": null,
            "btn_label": null,
            "image": "/settings/d7bae38338f98d22bc8c2acb994e1468.jpeg",
            "image_url": "https://umc.askjitendra.com/storage//settings/d7bae38338f98d22bc8c2acb994e1468.jpeg"
        }
    ],
    "errors": []
}

🗂️ Category APIs

GET /api/categories

List all categories

Output Example:

{
    "success": true,
    "data": {   
        "total_categories": 11,
        "categories": [
            {
                "id": 1,
                "parent_id": 0,
                "order": 1,
                "slug": "electonics",
                "status": "1",
                "created_at": "2025-03-29T09:13:26.000000Z",
                "updated_at": "2025-03-29T09:13:26.000000Z",
                "translations": [
                    {
                        "id": 27,
                        "category_id": 1,
                        "title": "Electonics",
                        "description":"Explore the latest models from top brands and find the perfect laptop to meet your needs.",
                        "locale": "en"
                    }
                ],
                "image": {
                    "id": 12,
                    "category_id": 1,
                    "path": "category/electronic-OU8i18cERtqw5eXo.png",
                    "default": "1",
                    "locale": "en",
                    "created_at": null,
                    "updated_at": null,
                    "url": "https://umc.askjitendra.com/storage/category/electronic-OU8i18cERtqw5eXo.png"
                }
            },             
        ]
    },     
}

GET /api/categories/childCategory/{id}

Get child categories for a parent category

Input Example:

{ "id": 1 }

Output Example:

{
    "success": true,
    "data": {
        "total_categories": 1,
        "categories": [
            {
                "id": 2,
                "parent_id": 1,
                "order": 1,
                "slug": "laptop",
                "status": "1",
                "created_at": "2025-03-29T09:13:26.000000Z",
                "updated_at": "2025-03-29T09:13:26.000000Z",
                "translations": [
                    {
                        "id": 29,
                        "category_id": 2,
                        "title": "Laptop",
                        "description": "Explore the latest models from top brands and find the perfect laptop to meet your needs",
                        "locale": "en"
                    }
                ]
            }
        ]
    }
}

POST /api/categories/products

Get products by category ID

categoryId

Input Example:

{ "categoryId": 1 }

Output Example:

{
    "success": true,
    "data": {
        "products": [
            {
                "id": 1,
                "slug": "hp-15-thin",
                "price": 71000,
                "offer_price": 70000,
                "stock": "10",
                "is_offer": "0",
                "sales_count": 0,
                "new_label": "1",
                "featured": "0",
                "is_mlm_plan": "0",
                "eligible_for_commision": "0",
                "status": "1",
                "created_at": "2025-03-29T09:13:26.000000Z",
                "updated_at": "2025-03-29T09:13:26.000000Z",
                "share_url": false,
                "default_image": {
                    "id": 121,
                    "product_id": 1,
                    "path": "product/hp-15-thin2NO8iiMgP4scbzkFm1754310417.png",
                    "default": "1",
                    "locale": "en",
                    "url": "https://umc.askjitendra.com/storage/product/hp-15-thin2NO8iiMgP4scbzkFm1754310417.png"
                },
                "default_image_url": "https://umc.askjitendra.com/storage/product/hp-15-thin2NO8iiMgP4scbzkFm1754310417.png",
                "title": {
                    "en": "HP 15 Thin",
                    "locale": "HP 15 Thin"
                },
                "translations": [
                    {
                        "id": 1,
                        "product_id": 1,
                        "title": "HP 15 Thin",
                        "description": "description",
                        "short_description": "Processor: 11th Gen Intel Core i5-1135G7 ",
                        "locale": "en"
                    }
                ],
                "images": [
                    {
                        "id": 121,
                        "product_id": 1,
                        "path": "product/hp-15-thin2NO8iiMgP4scbzkFm1754310417.png",
                        "default": "1",
                        "locale": "en",
                        "url": "https://umc.askjitendra.com/storage/product/hp-15-thin2NO8iiMgP4scbzkFm1754310417.png"
                    },
                    {
                        "id": 122,
                        "product_id": 1,
                        "path": "product/hp-15-thin1CHOpxfn87QyQCyVX1754310422.png",
                        "default": "0",
                        "locale": "en",
                        "url": "https://umc.askjitendra.com/storage/product/hp-15-thin1CHOpxfn87QyQCyVX1754310422.png"
                    }
                ]
            },             
        ],
        "category": {
            "id": 1,
            "parent_id": 0,
            "order": 1,
            "slug": "electonics",
            "status": "1",
            "created_at": "2025-03-29T09:13:26.000000Z",
            "updated_at": "2025-03-29T09:13:26.000000Z"
        }
    }     
}

👤 User Registration & Authentication APIs

POST /api/registration

name email password

Input Example:

{
  "username":"user3",
  "first_name":"user3",
  "last_name":"user3",
  "email":"user3@test.com",
  "password":"12345678",
  "password_confirmation":"12345678",
  "phone":"1234567890",
  "sponsor":"rootuser"
}

Output Example:

{   
    "success": true,
    "message": "Congratulations!! you have successfully registered",
    "data": {
        "redirect_url": "https://umc.askjitendra.com/mlm-referrals",
        "sms_network_message": "Congratulations Root User, a new referral has successfully registered with laravel unilevel demo, for info please check mlm dashboard on our website.",
        "sms_registration_message": "Congratulations user10 user10, you have successfully registered with laravel unilevel demo",
        "user": {
            "username": "user10",
            "first_name": "user10",
            "last_name": "user10",
            "email": "user10@test.com",
            "phone": "1234567811",
            "user_key": "95267183",
            "sponsor_id": 10001,
            "parent_id": 10001,
            "role": "0",
            "updated_at": "2025-08-12T12:59:57.000000Z",
            "created_at": "2025-08-12T12:59:57.000000Z",
            "id": 10008,
            "parent": "rootuser",
            "sponsor": "rootuser",
            "payment_status_label": "Unpaid",
            "photo_url": "https://umc.askjitendra.com/default-avatar-profile-picture.png",
            "joiningtime": "12-08-2025, 06:29:57 PM",
            "order_status": []
        }
    },
    "error": []
}

POST /api/login

User login

Input Example:

{"email":"rootuser@test.com","password":"1234567890"}

Output Example:

{
    "success": true,
    "token": "101|w7piyPlnbFW9fqtxsQiMGRLptV8Gbg7EpCi4ucgQ1dcafb74",
    "user": {
        "id": 10001,
        "first_name": "Root",
        "last_name": "User",
        "email": "rootuser@test.com",
        "nickname": "rootuser",
        "photo": "https://umc.askjitendra.com/storage/user/logo.png"
    }
}

GET /api/authenticate

Get authenticated user info (requires token)

Auth Required

POST /api/user_forgot_password

Request password reset OTP

Input Example:

{"email":"rootuser@test.com","password":"1234567890","password_confirmation":"1234567890","varify_password":"1"}

POST /api/otp_verify

Verify OTP for password reset

email otp

POST /api/user_reset_password

Reset password using OTP

email otp new_password

🔒 Authenticated APIs (Bearer Token Required)

POST /api/logout

Logout user (invalidate token)

Auth Required

🛒 Cart APIs

POST /api/addToCart

Add product to cart

Auth Required

product_id quantity

Input Example:

{
  "product_id":17,
  "qty":1
}

Output Example:

{
    "success": true,
    "message": "UMIDIGI G9X Unlocked Cell PhoneAdded to cart successfully!",
    "data": {
        "cart": [
            {
                "id": 194,
                "user_id": 10001,
                "product_id": 17,
                "qty": 1,
                "price": 100,
                "subtotal": 100,
                "discount": 0,
                "total": 100,
                "created_at": "2025-08-13T05:16:02.000000Z",
                "updated_at": "2025-08-13T05:16:02.000000Z",
                "product": {
                    "id": 17,
                    "slug": "UMIDIGI",
                    "price": 200,
                    "offer_price": 100,
                    "stock": "10",                    
                }
            }
        ],
        "cart_count": 1,
        "cart_total": {
            "subtotal": 100,
            "total": 100,
            "discount": 0
        }
    },
    "error": []
}

POST /api/removeFromCart

Remove item from cart

Auth Required

Input Example:

{"product_id":17}

Output Example:

{
    "success": true,
    "message": "Item Removed successfully"
}

GET /api/cartItemscount

Get count of items in cart

Auth Required

Output Example:

{
    "success": true,
    "data": 1
}

GET /api/cartItems

Get all items in user's cart

Auth Required

Output Example:

{
    "success": true,
    "data": [
        {
            "id": 195,
            "user_id": 10001,
            "product_id": 17,
            "qty": 1,
            "price": 100,
            "subtotal": 100,
            "discount": 0,
            "total": 100,
            "created_at": "2025-08-13T07:44:44.000000Z",
            "updated_at": "2025-08-13T07:44:44.000000Z",
            "product": {
                "id": 17,
                "slug": "UMIDIGI",
                "price": 200,
                "offer_price": 100,
                "stock": "10",
                "is_offer": "0",
                "sales_count": 0,
                "new_label": "1",
                "featured": "1",
                "is_mlm_plan": "0",
                "eligible_for_commision": "0",
                "status": "1",                 
            }
        }
    ],
    "cart_total_amount": {
        "subtotal": 100,
        "total": 100,
        "discount": 0
    },
    "total": 1,
    "message": "Cart Items"
}

💳 Checkout APIs

GET /api/getCountries

List all countries for shipping

Auth Required

Output Example:

{
    "success": true,
    "message": "Defaul address data.",
    "data": {
        "countries": [
            {
                "id": 1,
                "code": "AF",
                "status": 1,
                "created_at": "2025-03-29T09:12:57.000000Z",
                "updated_at": "2025-03-29T09:12:57.000000Z",
                "name": {
                    "en": "Afghanistan",
                    "locale": "Afghanistan"
                },
                "translations": [
                    {
                        "id": 1,
                        "country_id": 1,
                        "name": "Afghanistan",
                        "locale": "en"
                    }
                ]
            },
            {
                "id": 2,
                "code": "AL",
                "status": 1,
                "created_at": "2025-03-29T09:12:57.000000Z",
                "updated_at": "2025-03-29T09:12:57.000000Z",
                "name": {
                    "en": "Albania",
                    "locale": "Albania"
                },
                "translations": [
                    {
                        "id": 2,
                        "country_id": 2,
                        "name": "Albania",
                        "locale": "en"
                    }
                ]
            },
            .
            .
        ]
    }
}

POST /api/getStates

List all states for a country

country_id

Auth Required

Input Example:

{"country_id":1}

Output Example:

{
    "success": true,
    "message": "States data.",
    "data": {
        "states": [
            {
                "id": 1,
                "country_id": 1,
                "code": "BDS",
                "status": 1,
                "created_at": "2025-03-29T09:12:58.000000Z",
                "updated_at": "2025-03-29T09:12:58.000000Z",
                "name": {
                    "en": "Badakhshan",
                    "locale": "Badakhshan"
                },
                "translations": [
                    {
                        "id": 1,
                        "state_id": 1,
                        "name": "Badakhshan",
                        "locale": "en"
                    }
                ]
            },
            {
                "id": 2,
                "country_id": 1,
                "code": "BDG",
                "status": 1,
                "created_at": "2025-03-29T09:12:58.000000Z",
                "updated_at": "2025-03-29T09:12:58.000000Z",
                "name": {
                    "en": "Badghis",
                    "locale": "Badghis"
                },
                "translations": [
                    {
                        "id": 2,
                        "state_id": 2,
                        "name": "Badghis",
                        "locale": "en"
                    }
                ]
            },
            .
            . 
        ],
        "address": []
    }
}

POST /api/addBillingAddress

Add a new billing address

address fields

Auth Required in the request body.

Input Example:

{
    "nickname":"user2test",
    "full_name":"user2 test fl",
    "street":"abc user2 place 33",
    "city":"harigarh",
    "country":1,
    "state":5,
    "postal_code":"202001",
    "phone":"9856987845",
    "billing":1
}

Output Example:

{
    "success": true,
    "message": "Address created successfully.",
    "data": {
        "nickname": "rootuser@test.comtest",
        "full_name": "rootuse test fl",
        "street": "abc user2 place 33",
        "city": "harigarh",
        "state": 5,
        "country": 1,
        "postal_code": "202001",
        "phone": "9856987845",
        "billing": "1",
        "user_id": 10001,
        "updated_at": "2025-08-13T08:01:01.000000Z",
        "created_at": "2025-08-13T08:01:01.000000Z",
        "id": 18,
        "state_full_name": "Bamian",
        "country_full_name": "Afghanistan"
    }
}

GET /api/getBillingAddress/{id}

Get billing address by ID

Auth Required

Input Example:

{"id":18}

Output Example:

{
    "success": true,
    "message": "Billing address fetched successfully.",
    "data": {
        "id": 18,
        "user_id": 10001,
        "nickname": "rootuser@test.comtest",
        "full_name": "rootuse test fl",
        "street": "abc user2 place 33",
        "city": "harigarh",
        "state": "5",
        "country": "1",
        "postal_code": "202001",
        "phone": "9856987845",
        "billing": "1",
        "created_at": "2025-08-13T08:01:01.000000Z",
        "updated_at": "2025-08-13T08:01:01.000000Z",
        "state_full_name": "Bamian",
        "country_full_name": "Afghanistan"
    }
}

POST /api/deleteBillingAddress/{id}

Delete billing address by ID

Auth Required

Input Example:

{"id":17}

Output Example:

{
    "success": true,
    "message": "Address deleted successfully."
}

POST /api/updateBillingAddress/{id}

Update billing address by ID

id address fields

Auth Required

Input Example:

{        
"nickname": "rootuser@test.comtest",
"full_name": "rootuse test fl",
"street": "abc user2 place 33",
"city": "harigarh",
"state": "5",
"country": "1",
"postal_code": "202005",
"phone": "9856987845"
}

Output Example:

{
    "success": true,
    "message": "Address updated successfully."
}

GET /api/getBillingAddresses

Get all billing addresses for user

Auth Required

Output Example:

{
    "success": true,
    "message": "Billing addresses fetched successfully.",
    "data": [
        {
            "id": 18,
            "user_id": 10001,
            "nickname": "rootuser@test.comtest",
            "full_name": "rootuse test fl",
            "street": "abc user2 place 33",
            "city": "harigarh",
            "state": "5",
            "country": "1",
            "postal_code": "202005",
            "phone": "9856987845",
            "billing": "0",
            "created_at": "2025-08-13T08:01:01.000000Z",
            "updated_at": "2025-08-13T08:12:10.000000Z",
            "state_full_name": "Bamian",
            "country_full_name": "Afghanistan"
        },
        {
            "id": 12,
            "user_id": 10001,
            "nickname": "rootuser",
            "full_name": "rootuser",
            "street": "abdbdn",
            "city": "aligarh",
            "state": "1500",
            "country": "99",
            "postal_code": "123456",
            "phone": "9718263489",
            "billing": "0",
            "created_at": "2025-06-18T13:47:07.000000Z",
            "updated_at": "2025-08-13T07:55:51.000000Z",
            "state_full_name": "Punjab",
            "country_full_name": "India"
        }
    ]
                    }

POST /api/applyCouponCode

Apply a coupon code to cart

coupon_code

Auth Required

Input Example

{
    "success": false,
    "message": "Coupon code is not active.",
    "data": []
 }

Output Example

{
    "success": false,
    "message": "Coupon code is not active.",
    "data": []
}

POST /api/placeOrder

Place an order

order details

Auth Required

Input Example

{
"billing_address":18,
"shipping_address":18,
"coupon_code":"",
"order_notes":"",
"payment_method":"razorpay"
}

Output Example

{
    "success": true,
    "order_id": 10135,
    "grand_total": 100,
    "message": "Order Placed Successfully"
}

POST /api/generatePaymentOrderId

Generate payment order ID (Razorpay)

order_id

Auth Required

Input Example

{ "order_id": 10135 }

Output Example

{
    "success": true,
    "message": "Payment Order created successfully.",
    "data": {
        "razorpay_order_id": "order_R4kq9AUa0G5UJ6",
        "email": "rootuser@test.com",
        "contact": "9856987845",
        "amount": 10000,
        "currency": "USD"
    }
}

POST /api/generatePaymentStripeSecretKey

Generate Stripe payment secret key

order_id

Auth Required

POST /api/varifyPayment

Verify payment

payment details and it is working on app only

Auth Required

GET /api/thank/{orderId}

Thank you page for order

orderId

Auth Required

Output Example

{
"success": true,
"message": "Order Data.",
    "data": {
    "order_data": {
    "id": 10135,
    "user_id": 10001,
    "status": "pending",
    "sub_total": "100.00",
    "shipping_total": "0.00",
    "discount_total": "0.00",
    "grand_total": "100.00",
    "items_count": 1,
    "coupon": "",
    "payment_status": "0",
    "payment_method": "razorpay",
    "shipping_address":
    "{\"id\":18,\"user_id\":10001,\"nickname\":\"rootuser@test.comtest\",\"full_name\":\"rootuse
    test fl\",\"street\":\"abc user2 place
    33\",\"city\":\"harigarh\",\"state\":\"5\",\"country\":\"1\",\"postal_code\":\"202005\",\"phone\":\"9856987845\",\"billing\":\"0\",\"created_at\":\"2025-08-13T08:01:01.000000Z\",\"updated_at\":\"2025-08-13T08:12:10.000000Z\",\"state_full_name\":\"Bamian\",\"country_full_name\":\"Afghanistan\"}",
    "billing_address":
    "{\"id\":18,\"user_id\":10001,\"nickname\":\"rootuser@test.comtest\",\"full_name\":\"rootuse
    test fl\",\"street\":\"abc user2 place
    33\",\"city\":\"harigarh\",\"state\":\"5\",\"country\":\"1\",\"postal_code\":\"202005\",\"phone\":\"9856987845\",\"billing\":\"0\",\"created_at\":\"2025-08-13T08:01:01.000000Z\",\"updated_at\":\"2025-08-13T08:12:10.000000Z\",\"state_full_name\":\"Bamian\",\"country_full_name\":\"Afghanistan\"}",
    "country": "1",
    "state": "5",
    "postal_code": "202005",
    "phone": "9856987845",
    "note": null,
    "created_at": "2025-08-13T08:31:17.000000Z",
    "updated_at": "2025-08-13T08:31:17.000000Z",

    },
    "currency": {
    "currency_name": "USD",
    "currency_position": "left",
    "currency_format": "$"
                }
    }
}

👤 User Account APIs

GET /api/info

Get user account info

Auth Required

Output Example:

{
    "success": true,
    "message": "Account info",
    "data": {
        "page_title": "My Account",
        "user": {
            "id": 10001,
            "username": "rootuser",
            "email": "rootuser@test.com",
            "phone": 8787874452,
            "first_name": "Root",
            "last_name": "User",
            "user_key": "72314090",
            "sponsor": "NULL",
            "parent": "NULL",
            "payment_status_label": "Paid"
        },
        "orders": {
            "total_orders": 27,
            "pending_orders": 5,
            "completed_orders": 0
        }
    }
}

GET /api/orders

Get all user orders

Auth Required

Output Example:

{
    "success": true,
    "message": "Orders fetched successfully.",
    "meta": {
        "currency_symbol": "$",
        "page_title": "Orders"
    },
    "data": [
        {
            "id": 138,
            "order_id": 10135,
            "product_id": 17,
            "quantity": 1,
            "price": "100.00",
            "sub_total": "100.00",
            "shipping": "0.00",
            "discount": "0.00",
            "total": "100.00",
            "enable_for_commission": "1",
            "product_details": "{\"title\":\"UMIDIGI G9X Unlocked Cell Phone\",\"short_description\":\"UMIDIGI G9X Unlocked Cell Phone,6.75\\\" 90Hz Display Smart Phone,Android 14 Phone,5000mAh,Octa-Core 8(4+4)+64GB 1TB,Face ID Unlock,4G Dual SIM Phone,GPS,FM Radio,Show captions,Unlocked Android Phones\",\"image\":\"product\\/umidigi-g9x-unlocked-cell-phone2dZPIxDKRTHpcsSWt1754310786.jpg\",\"category\":[\"Mobile\",\"Electonics\"]}",
            "created_at": "2025-08-13T08:31:17.000000Z",
            "updated_at": "2025-08-13T08:31:17.000000Z",
            "laravel_through_key": 10001,
            "product_image": "https://umc.askjitendra.com/storage/product/umidigi-g9x-unlocked-cell-phone2dZPIxDKRTHpcsSWt1754310786.jpg",
            "status": "pending",
            "parent_order": {
                "id": 10135,
                "user_id": 10001,
                "status": "pending",
                "sub_total": "100.00",
                "shipping_total": "0.00",
                "discount_total": "0.00",
                "grand_total": "100.00",
                "items_count": 1,
                "coupon": "",
                "payment_status": "0",
                "payment_method": "razorpay",
                "shipping_address": "{\"id\":18,\"user_id\":10001,\"nickname\":\"rootuser@test.comtest\",\"full_name\":\"rootuse test fl\",\"street\":\"abc user2 place 33\",\"city\":\"harigarh\",\"state\":\"5\",\"country\":\"1\",\"postal_code\":\"202005\",\"phone\":\"9856987845\",\"billing\":\"0\",\"created_at\":\"2025-08-13T08:01:01.000000Z\",\"updated_at\":\"2025-08-13T08:12:10.000000Z\",\"state_full_name\":\"Bamian\",\"country_full_name\":\"Afghanistan\"}",
                "billing_address": "{\"id\":18,\"user_id\":10001,\"nickname\":\"rootuser@test.comtest\",\"full_name\":\"rootuse test fl\",\"street\":\"abc user2 place 33\",\"city\":\"harigarh\",\"state\":\"5\",\"country\":\"1\",\"postal_code\":\"202005\",\"phone\":\"9856987845\",\"billing\":\"0\",\"created_at\":\"2025-08-13T08:01:01.000000Z\",\"updated_at\":\"2025-08-13T08:12:10.000000Z\",\"state_full_name\":\"Bamian\",\"country_full_name\":\"Afghanistan\"}",
                "country": "1",
                "state": "5",
                "postal_code": "202005",
                "phone": "9856987845",
                "note": null,
                "created_at": "2025-08-13T08:31:17.000000Z",
                "updated_at": "2025-08-13T08:31:17.000000Z"
            }
        },
        .
        .         
    ]
}

GET /api/order/{order_id}

Get order details by order ID

order_id

Auth Required

GET /api/profile

Get user profile

Auth Required

Output Example:

{
    "success": true,
    "message": "User details fetched successfully.",
    "data": {
        "id": 10001,
        "username": "rootuser",
        "user_key": "72314090",
        "parent_id": 0,
        "sponsor_id": 0,
        "level": 2,
        "role": "0",
        "first_name": "Root",
        "last_name": "User",
        "email": "rootuser@test.com",
        "phone": 8787874452,
        "email_verified_at": null,
        "photo": "user/logo.png",
        "status": "1",
        "forgot_password_token": null,
        "rank": 3,
        "deleted_at": null,
        "created_at": "2025-03-29T09:16:12.000000Z",
        "updated_at": "2025-08-05T08:13:44.000000Z",
        "parent": "NULL",
        "sponsor": "NULL",
        "payment_status_label": "Paid",
        "photo_url": "https://umc.askjitendra.com/storage/user/logo.png",
        "joiningtime": "29-03-2025, 02:46:12 PM"
    },
    "meta": {
        "currency_symbol": "$",
        "page_title": "Profile"
    }
}

POST /api/updateProfile

Update user profile

profile fields

Auth Required

Input Example:
{ "first_name":"ram", "last_name":"kumar", "email": "rootuser@test.com", "phone": "8787874452" }

Output Example:
{ "success": true, "message": "Profile updated successfully." }

POST /api/updatePassword
Update user password

old_password new_password
Auth Required
Input Example:
{ "password":"1234567890", "password_confirmation":"1234567890", "old_password":"1234567890" }

Output Example:
{ "success": true, "message": "Password updated.", "data": [] }

GET /api/getPaymentSetting
Get payment settings for user
Auth Required
Output Example:
{ "success": true, "data": { "payment_gateway_test_mode": "1", "payment_gateway_stripe_enable": "1", "payment_gateway_stripe_public_key": "pk_test_WExKaur4gKd8B5LBh8snFLAQ0BIu", "payment_gateway_stripe_secrect_key": "sk_test_51NRVDkSDpAVKNrZmmAHJivjMRv3CZ9cWvPGORF7RptKWRsIUZjUefYSRpKt1VfraFm17rR00jesMivso", "payment_gateway_razorpay_enable": "1", "payment_gateway_razorpay_public_key": "rzp_test_H5dcSLQJG2S", "payment_gateway_razorpay_secrect_key": "eYwKEQnH3sMyAEG5YaeT" } }

💼 MLM User APIs

GET /api/mlm-dashboard
Get MLM dashboard data
Auth Required
Output Example:
{ "success": true, "message": "User data", "data": { "currency": "USD", "earned_amount": 42806.130000000005, "e_wallet_balance": 42806.130000000005, "total_downlines": 4, "total_withdrawal": 400, "total_order": 27, "affiliate_link": "https://umc.askjitendra.com/sponsor/rootuser", "chart_data": { "users": { "data": [ [ "Thu", 0 ], [ "Fri", 0 ], [ "Sat", 0 ], [ "Sun", 0 ], [ "Mon", 0 ], [ "Tue", 1 ], [ "Wed", 0 ] ], "label": "Users", "color": "#f00" }, "referrals": { "data": [ [ "Thu", 0 ], [ "Fri", 0 ], [ "Sat", 0 ], [ "Sun", 0 ], [ "Mon", 0 ], [ "Tue", 1 ], [ "Wed", 0 ] ], "label": "Referrals", "color": "#ff0" } }, }, "errors": [], "meta": { "currency": "USD", "currency_symbol": "$" } }

GET /api/affiliate-link
Get affiliate link for user
Auth Required
Output Example:
{ "success": true, "message": "User data", "data": { "currency": "USD", "affiliate_link": "https://umc.askjitendra.com/sponsor/rootuser", "user": { "id": 10001, "username": "rootuser", "user_key": "72314090", "parent_id": 0, "sponsor_id": 0, "level": 2, "role": "0", "first_name": "ram", "last_name": "kumar", "email": "rootuser@test.com", "phone": 8787874452, "email_verified_at": null, "photo": "user/logo.png", "status": "1", "forgot_password_token": null, "rank": 3, "deleted_at": null, "created_at": "2025-03-29T09:16:12.000000Z", "updated_at": "2025-08-13T10:59:27.000000Z", "parent": "NULL", "sponsor": "NULL", "payment_status_label": "Paid", "photo_url": "https://umc.askjitendra.com/storage/user/logo.png", "joiningtime": "29-03-2025, 02:46:12 PM" } }, "errors": [] }

GET /api/referrals
Get direct referrals for user
Auth Required
Output Example:
{ "success": true, "message": "Direct Referrals", "data": [ { "id": 10008, "username": "user10", "user_key": "95267183", "parent_id": 10001, "sponsor_id": 10001, "level": 0, "role": "0", "first_name": "user10", "last_name": "user10", "email": "user10@test.com", "phone": 1234567811, "email_verified_at": null, "photo": null, "status": "1", "forgot_password_token": null, "rank": 0, "deleted_at": null, "created_at": "2025-08-12T12:59:57.000000Z", "updated_at": "2025-08-12T12:59:57.000000Z", "parent": "rootuser", "sponsor": "rootuser", "payment_status_label": "Unpaid", "photo_url": "https://umc.askjitendra.com/default-avatar-profile-picture.png", "joiningtime": "12-08-2025, 06:29:57 PM" }, { "id": 10004, "username": "user3", "user_key": "70538024", "parent_id": 10001, "sponsor_id": 10001, "level": 0, "role": "0", "first_name": "user3", "last_name": "kumar", "email": "user3@test.com", "phone": 6457187318, "email_verified_at": null, "photo": null, "status": "1", "forgot_password_token": null, "rank": 0, "deleted_at": null, "created_at": "2025-05-08T09:53:00.000000Z", "updated_at": "2025-05-08T10:18:27.000000Z", "parent": "rootuser", "sponsor": "rootuser", "payment_status_label": "Unpaid", "photo_url": "https://umc.askjitendra.com/default-avatar-profile-picture.png", "joiningtime": "08-05-2025, 03:23:00 PM" }, ], "errors": [] }

GET /api/payouts
Get all payouts for user
Auth Required
Output Example:
{ "success": true, "message": "User Payouts", "data": [ { "id": 10007, "master_payout_id": 10005, "user_id": 10001, "total_commission": 8441.51, "company_commission": 1445.6, "referral_commission": 7174, "join_commission": 100, "level_commission": 165, "regular_bonus": 0.5, "rank_bonus": 0.7, "deduction": 444.29, "referrence": "{\"regular_bonus\":{\"min_referrals\":\"2\",\"max_referrals\":\"4\",\"amount\":\"5\",\"amount_type\":\"percent\"},\"rank_bonus\":{\"min_downliners_sales\":\"7000\",\"amount\":\"7\",\"amount_type\":\"percent\"},\"deductions\":[{\"name\":\"TDS\",\"amount\":\"5\",\"amount_type\":\"Percent\"},{\"name\":\"GST\",\"amount\":\"0\",\"amount_type\":\"percent\"}]}", "created_at": "2025-08-05T11:56:28.000000Z", "updated_at": "2025-08-05T11:56:28.000000Z", "run_at": "05-08-2025, 05:26:28 PM" }, ], "errors": [], "meta": { "currency": "USD", "currency_symbol": "$" } }

GET /api/transactions
Get all transactions for user
Auth Required
Output Example:
{ "success": true, "message": "User Transactions", "data": [ { "id": 7, "user_id": 10001, "cr": 8441.51, "dr": 0, "type": "0", "reference": "10007", "created_at": "2025-08-05T11:56:28.000000Z", "updated_at": "2025-08-05T11:56:28.000000Z", "reference_label": "Payout #10007", "time": "05-08-25, 05:26:28 PM" }, { "id": 5, "user_id": 10001, "cr": 8430.11, "dr": 0, "type": "0", "reference": "10005", "created_at": "2025-08-05T10:58:49.000000Z", "updated_at": "2025-08-05T10:58:49.000000Z", "reference_label": "Payout #10005", "time": "05-08-25, 04:28:49 PM" }, ], "errors": [], "meta": { "currency": "USD", "currency_symbol": "$" } }

GET /api/genealogy
Get user genealogy tree
Auth Required
Output Example:
{ "success": true, "message": "Genealogy", "data": { "name": "ram kumar", "imageUrl": "https://umc.askjitendra.com/storage/user/logo.png", "area": "Corporate", "profileUrl": "#", "email": "rootuser@test.com", "phone": "8787874452", "userKey": "72314090", "sponsor": "NULL", "parentUser": "NULL", "level": "2", "downline": "4", "userName": "rootuser", "earned_amount": "42806.13$", "withdrawal_amount": "400$", "children": [ { "name": "user1 kumar", "imageUrl": "https://umc.askjitendra.com/default-avatar-profile-picture.png", "area": "Corporate", "profileUrl": "#", "email": "user1@test.com", "phone": "9876543542", "userKey": "27106054", "sponsor": "rootuser", "parentUser": "rootuser", "level": "1", "downline": "3", "userName": "user1", "earned_amount": "429.876$", "withdrawal_amount": "0$", "children": [ { "name": "nuser1 kkk", "imageUrl": "https://umc.askjitendra.com/default-avatar-profile-picture.png", "area": "Corporate", "profileUrl": "#", "email": "nuser1@test.com", "phone": "9797978987", "userKey": "31827054", "sponsor": "user1", "parentUser": "user1", "level": "0", "downline": "0", "userName": "nuser1", "earned_amount": "0$", "withdrawal_amount": "0$", "children": [] }, ] }, { "name": "user10 user10", "imageUrl": "https://umc.askjitendra.com/default-avatar-profile-picture.png", "area": "Corporate", "profileUrl": "#", "email": "user10@test.com", "phone": "1234567811", "userKey": "95267183", "sponsor": "rootuser", "parentUser": "rootuser", "level": "0", "downline": "0", "userName": "user10", "earned_amount": "0$", "withdrawal_amount": "0$", "children": [] } ] }, "errors": [] }

GET /api/withdrawals
Get all withdrawal requests for user
Auth Required
Output Example:
{ "success": true, "message": "User Withdrawals", "data": [ { "id": 4, "user_id": 10001, "amount": 100, "payment_method": "bank", "getway_data": "{\"ac_number\":\"79789879764111\",\"ac_holder\":\"rootuser\",\"bank\":\"abckad\",\"ifsc\":\"djlsk9390\",\"pan_number\":\"092039023239ww\"}", "transaction_id": null, "status": "0", "comment": null, "created_at": "2025-07-29T11:00:48.000000Z", "updated_at": "2025-07-29T11:00:48.000000Z", "status_label": "Pending ", "requested_at": "29-07-2025, 04:30:48 PM", "status_label_html": "Pending" }, { "id": 3, "user_id": 10001, "amount": 100, "payment_method": "bank", "getway_data": "{\"ac_number\":\"79789879764111\",\"ac_holder\":\"rootuser\",\"bank\":\"abckad\",\"ifsc\":\"djlsk9390\",\"pan_number\":\"092039023239ww\"}", "transaction_id": null, "status": "0", "comment": null, "created_at": "2025-06-16T11:38:26.000000Z", "updated_at": "2025-06-16T11:38:26.000000Z", "status_label": "Pending", "requested_at": "16-06-2025, 05:08:26 PM", "status_label_html": "Pending" }, ], "errors": [], "meta": { "currency": "USD", "currency_symbol": "$" } }

GET /api/bankDetails
Get bank details for user
Auth Required
Output Example:
{ "success": true, "data": { "id": 1, "user_id": 10001, "ac_number": "79789879764111", "ac_holder": "rootuser", "bank": "abckad", "ifsc": "djlsk9390", "pan_number": "092039023239ww", "created_at": "2025-06-10T07:11:02.000000Z", "updated_at": "2025-06-12T12:26:15.000000Z", "phone": 8787874452 }, "error": [] }

POST /api/updateBankDetails
Update bank details for user

bank details
Auth Required
Input Example:
{ "id": 1, "user_id": 10001, "ac_number": "797898797649666", "ac_holder": "rootuser", "bank": "abckadqqqq", "ifsc": "djlsk9390", "pan_number": "092039023239lijhfoiaw", "created_at": "2025-06-10T12:41:02.000000Z", "updated_at": "2025-06-10T12:41:02.000000Z" }

Output Example:
{ "success": true, "message": "Bank details updated successfully." }

GET /api/withdrawal_request
Get withdrawal request form
Auth Required
Output Example:
{ "success": true, "message": "User Withdrawal Request Data", "data": { "e_wallet_balance": 42806.130000000005, "proccessed_amount": 400, "available_balance": 42406.130000000005, "min_withdrawal_limit": "100", "max_withdrawal_limit": "1000" }, "errors": [], "meta": { "currency": "USD", "currency_symbol": "$" } }

POST /api/withdrawal_request
Submit withdrawal request

withdrawal details
Auth Required
Input Example:
{ "amount":"100" }

Output Example:
{ "success": true, "message": "Withdrawal requested successfully." }

Flutter App Apis

Flutter E-Commerce Mobile App Documentation