GET /v1/votes

Growth+

Retrieve a paginated list of votes with comprehensive filtering options. This endpoint allows you to query your vote history by date range, provider, voter name, and delivery status. The response includes pagination metadata, making it easy to navigate through large vote datasets. Use this endpoint to build vote history interfaces, generate reports, audit vote processing, or integrate vote data into external systems. Advanced filtering options including date ranges, provider filters, and status filters require Growth plan or higher. Starter plan users can retrieve the last 10 votes without filtering options.

Request

http

GET https://api.votepipe.com/v1/votes?page=1&limit=50&provider=hytale-servers-pro&from=2026-01-01&to=2026-01-31
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: 50, max: 100)
provider	string	No	Filter by provider key
from	date	No	Start date (YYYY-MM-DD)
to	date	No	End date (YYYY-MM-DD)

Response (200 OK)

json

{
  "data": {
    "votes": [
      {
        "id": "uuid",
        "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-02T12:00:00Z",
        "discord_status": "sent",
        "callback_status": "sent"
      }
    ]
  },
  "meta": {
    "page": 1,
    "limit": 50,
    "total": 456,
    "pages": 10,
    "request_id": "req_abc123"
  }
}

Learn More

→ Vote Endpoints → GET /v1/votes/:id