Get Contest

GET

https://stageapi.partake.ng/api/v2/merchants/me/contests/{{contestId}}

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

Maintainer:Not configured

Returns a single contest by ID. Only accessible by the owning merchant. Merchant only.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Header Params

Responses

🟢200

application/json

Bodyapplication/json

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://stageapi.partake.ng/api/v2/merchants/me/contests/{{contestId}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'

Response Example

200 - 200 OK

{
  "success": true,
  "data": {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "title": "Miss iVoteNg 2026",
    "description": "Annual national beauty and talent pageant.",
    "status": "active",
    "votingType": "paid",
    "costPerVote": 100,
    "prizeDetails": "₦500,000 cash prize + crown",
    "startDate": "2026-05-01T00:00:00.000Z",
    "endDate": "2026-06-01T00:00:00.000Z",
    "bannerImageUrl": "https://cdn.example.com/banners/miss-ivoteng-2026.jpg",
    "createdAt": "2026-04-15T08:00:00.000Z",
    "updatedAt": "2026-04-20T12:00:00.000Z"
  },
  "message": "Contest retrieved successfully"
}

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

Create Contest

Update Contest