تاجر جني
Which API?
Merchant API For merchants: manage your own catalogue, orders and finances through the v2 Third-Party API. Application API For partner apps: browse Gini merchants and products, send customers to checkout and follow their orders.

New: Application API docs

Pick the API you are reading here — the Merchant API for your own store, the Application API for partner apps.

Merchant dashboard
Insights API
Dashboard stats

API documentation

Everything you need to integrate with the Gini v2 Third-Party API.

Dashboard stats

The headline figures a merchant sees on the dashboard home — wallet stages, order mix, payout totals and abandoned-cart numbers — computed the same way the dashboard computes them. Read-only.

Get dashboard stats

One summary object. The chart time-series on the dashboard are not included — this returns the figures an integration acts on.

GET /api/v2.0/third-party/dashboard-stats
Signed
Query parameters
Field Type Required Description
year integer Optional Restrict the order breakdown to this calendar year. Omit for all time.
Response
{
    "data": {
        "is_new_merchant": false,
        "wallet": {
            "settled": 475000,
            "settled_at": "2026-09-01",
            "ready": 120000,
            "in_transit": 30000,
            "at_risk": 15000,
            "at_risk_count": 2,
            "total_in_flight": 165000
        },
        "order_breakdown": {
            "total": 340,
            "slices": [
                {
                    "status": "delivered",
                    "label": "Delivered",
                    "count": 300,
                    "share": 88.2
                },
                {
                    "status": "pending",
                    "label": "Pending",
                    "count": 40,
                    "share": 11.8
                }
            ]
        },
        "payouts_summary": {
            "gross": 5000000,
            "paid": 4500000,
            "unpaid": 500000,
            "fees": 250000,
            "this_month": {
                "count": 3,
                "total": 1200000
            }
        },
        "abandoned_carts": {
            "total_customers": 52,
            "total_revenue": 780000
        }
    }
}
Notes
  • wallet: settled is your last payout; ready is money past the 24h hold; in_transit is within it; at_risk is orders stuck pending past 12h.
  • payouts_summary covers the online rails only (cash is excluded), matching the dashboard.
  • order_breakdown lists every status, so a status with no orders reads as count 0.