---
title: "Get giveaway winners"
method: GET
path: "/v1/giveaway/{giveaway_id}/winners"
tags: ["giveaway"]
---

# Get giveaway winners

`GET /v1/giveaway/{giveaway_id}/winners`

## Request

- Base URL: `https://api.grove.city` (the document declares no server; this is the origin it was published from)
- URL: `https://api.grove.city/v1/giveaway/{giveaway_id}/winners`
- Auth: none declared

Get the winners of a drawn giveaway.

## Path parameters

- `giveaway_id` string, required: Giveaway ID

## Response `200`

Successful Response

- DrawWinnersResponse: Response for draw operation.
  - `giveaway_id` string, required
  - `drawn_at` string, date-time, required
  - `winners` WinnerResponse[], required
    - `rank` integer, required
    - `entry_id` string, required
    - `winner_account_id` string, required
    - `earning_address` string, required
    - `handle` string, nullable
    - `ens_name` string, nullable
    - `base_name` string, nullable
    - `entry_count` integer, nullable
    - `selected_at` string, date-time, nullable
    - `client_address` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/grove/apis/grove-api.md) - [All operations](https://skmtc.dev/grove/apis/grove-api/llms.txt) - [OpenAPI document](https://skmtc.dev/grove/apis/grove-api/revisions/f286b48a8105?raw)