List Contests

GET

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

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

Maintainer:Not configured

Returns a paginated list of all contests across all merchants. Admin only.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

Bodyapplication/json

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://stageapi.partake.ng/api/v2/admin/contests?page=1&limit=20' \
--header 'Authorization: Bearer <token>'

Response Example

200 - 200 OK

{
    "success": true,
    "data": [
        {
            "contestId": "uuid-c01",
            "title": "Best Upcoming Singer 2024",
            "merchantName": "Bright Events Ltd",
            "status": "active",
            "votingType": "paid",
            "startDate": "2024-03-01T00:00:00.000Z",
            "endDate": "2024-03-31T23:59:59.000Z",
            "entryCount": 12,
            "voteCount": 4320
        }
    ],
    "meta": {
        "page": 1,
        "limit": 20,
        "total": 45,
        "totalPages": 3
    },
    "message": "Contests retrieved."
}

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

Ban User

Get Contest Detail