GET /v1/stats/voter/:voter_name

Pro+

Retrieve comprehensive statistics and vote history for a specific voter. This endpoint provides detailed analytics including total vote counts, breakdowns by provider, daily voting trends, and a paginated list of individual vote records. Use this endpoint to build voter profile pages, track individual voting patterns, analyze voter engagement, identify your most loyal community members, or create personalized reward systems based on voting history. The response includes summary statistics, provider breakdowns, trend data, and detailed vote records with filtering and pagination options. Available on Pro+ plans.

Request

http

GET https://api.votepipe.com/v1/stats/voter/PlayerOne?page=1&limit=20&provider=hytale-servers-pro&from=2026-01-01T00:00:00Z&to=2026-01-31T23:59:59Z
Authorization: Bearer mr_live_your_api_key_here

Query Parameters

Parameter	Type	Required	Description
page	integer	No	Page number (default: 1)
limit	integer	No	Results per page (default: 20, max: 100)
provider	string	No	Filter by provider key
from	string	No	Start date (ISO 8601)
to	string	No	End date (ISO 8601)

Response (200 OK)

json

{
  "data": {
    "voter_name": "PlayerOne",
    "summary": {
      "total": 156,
      "today": 3,
      "this_week": 12,
      "this_month": 45,
      "first_vote": "2025-12-15T10:30:00Z",
      "last_vote": "2026-01-02T15:32:01Z"
    },
    "by_provider": [
      {
        "key": "hytale-servers-pro",
        "name": "Hytale-Servers.pro",
        "count": 58
      },
      {
        "key": "hytalecharts",
        "name": "HytaleCharts",
        "count": 98
      }
    ],
    "daily_trend": [
      {
        "date": "2026-01-01",
        "count": 5
      },
      {
        "date": "2026-01-02",
        "count": 3
      }
    ],
    "votes": [
      {
        "id": "123",
        "public_id": "vt_550e8400-e29b-41d4-a716-446655440000",
        "voter_name": "PlayerOne",
        "provider_key": "hytale-servers-pro",
        "provider_name": "Hytale-Servers.pro",
        "received_at": "2026-01-02T15:32:01Z",
        "discord_status": "sent",
        "callback_status": "sent"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 156,
      "pages": 8
    }
  }
}

Learn More

→ Statistics Endpoints → GET /v1/stats/leaderboard