List Public Contests

GET

https://stageapi.partake.ng/api/v2/contests

Last modified:2026-07-10 13:15:30

Maintainer:Not configured

Returns a paginated list of public contests. Excludes draft and cancelled contests. Public — no authentication required.

Request

Query Params

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://stageapi.partake.ng/api/v2/contests?page=1&limit=20&status=active&sort=created_at&order=desc'

Response Example

{
  "success": true,
  "data": [
    {
      "contestId": "c1a2b3c4-d5e6-7f8a-9b0c-d1e2f3a4b5c6",
      "title": "Miss Anambra 2026",
      "description": "Annual pageant celebrating the beauty and intelligence of Anambra women.",
      "bannerImageUrl": "https://cdn.ivoteng.com/banners/miss-anambra-2026.jpg",
      "startDate": "2026-05-01T00:00:00.000Z",
      "endDate": "2026-07-31T23:59:59.000Z",
      "prizeDetails": "\u20a65,000,000 cash prize + crown + sponsorship",
      "votingType": "paid",
      "costPerVote": "50.00",
      "status": "active",
      "createdAt": "2026-04-15T10:30:00.000Z",
      "merchant": {
        "merchantId": "m1a2b3c4-d5e6-7890-abcd-ef1234567890",
        "merchantName": "Adeola Events & Productions"
      },
      "entryCount": 24,
      "totalVotes": 1872
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  },
  "message": "Contests retrieved successfully."
}

Modified at 2026-07-10 13:15:30

Cast Free Vote

Get Contest Detail