Contests

Contests

Manage and retrieve information about your contests.

List Contests

Returns a list of all contests belonging to the team associated with your API key.

Request

No parameters required.

curl -X GET https://blitzrocket.com/api/v1/contests \
  -H "x-api-key: your_api_key_here"

const response = await fetch("https://blitzrocket.com/api/v1/contests", {
  headers: {
    "x-api-key": "your_api_key_here",
  },
});

const { success, data } = await response.json();
console.log(data);
// => [{ id: "abc123", title: "Summer Giveaway", ... }, ...]

import requests

response = requests.get(
    "https://blitzrocket.com/api/v1/contests",
    headers={"x-api-key": "your_api_key_here"}
)

data = response.json()
print(data["data"])
# => [{"id": "abc123", "title": "Summer Giveaway", ...}, ...]

Response

{
  "success": true,
  "data": [
    {
      "id": "clx1abc123def456",
      "title": "Summer Giveaway 2025",
      "description": "Win amazing prizes this summer!",
      "status": "active",
      "startDate": "2025-06-01T00:00:00.000Z",
      "endDate": "2025-08-31T23:59:59.000Z",
      "isEvergreen": false,
      "mode": "giveaway",
      "slug": "summer-giveaway-2025",
      "entriesCount": 1523
    },
    {
      "id": "clx2def456ghi789",
      "title": "Product Launch Contest",
      "description": null,
      "status": "draft",
      "startDate": null,
      "endDate": null,
      "isEvergreen": true,
      "mode": "leaderboard",
      "slug": "product-launch",
      "entriesCount": 0
    }
  ]
}

Response Fields

Get Contest

Retrieve detailed information about a specific contest.

Path Parameters

Request

curl -X GET https://blitzrocket.com/api/v1/contests/clx1abc123def456 \
  -H "x-api-key: your_api_key_here"

const contestId = "clx1abc123def456";
const response = await fetch(
  `https://blitzrocket.com/api/v1/contests/${contestId}`,
  {
    headers: { "x-api-key": "your_api_key_here" },
  }
);

const { success, data } = await response.json();
console.log(data);

import requests

contest_id = "clx1abc123def456"
response = requests.get(
    f"https://blitzrocket.com/api/v1/contests/{contest_id}",
    headers={"x-api-key": "your_api_key_here"}
)

data = response.json()
print(data["data"])

Response

{
  "success": true,
  "data": {
    "id": "clx1abc123def456",
    "title": "Summer Giveaway 2025",
    "description": "Win amazing prizes this summer!",
    "status": "active",
    "startDate": "2025-06-01T00:00:00.000Z",
    "endDate": "2025-08-31T23:59:59.000Z",
    "isEvergreen": false,
    "mode": "giveaway",
    "slug": "summer-giveaway-2025",
    "entriesCount": 1523,
    "viewsCount": 12847
  }
}

Error Responses