Alerts
Endpoints under/v2/alerts let an authenticated user define criteria for new listings (filters mirror market-oriented dimensions such as brand, reference, price, region — exact fields are in the reference). List endpoints expose definitions and matches; match payloads expose ids so clients can deep-link into listings or message context.
Mark-as-seen routes acknowledge matches per listing without altering underlying listings.
Consult GET/PATCH semantics and schemas in the API reference; pagination shapes match patterns used elsewhere.
Dashboard stats
GET /v2/dashboard/stats returns pre-aggregated counters intended for home/overview dashboards (fresh listings, alert backlog-style summaries — precise keys are versioned in OpenAPI).
Treat aggregates as read-only indicators, not accounting-grade totals unless documented otherwise.