List your raffles

GET

/raffles

Raffles your platform is attached to. Raffles belonging to other platforms are never visible and are indistinguishable from raffles that do not exist.

Authorization

PartnerApiKey

headerAuthorizationBearer <token>

Authorization: Bearer <your_api_key>

Keep this credential on your server, never in browser or mobile app code. A missing, invalid or disabled key returns 401 PLATFORM_KEY_INVALID. Ask Verity to replace a lost or exposed key.

Query Parameters

limit?integer

Range1 <= value <= 100

Default50

offset?integer

Range0 <= value

Default0

Response Body

application/json

response

success*boolean

data*

Example Request

curl -X GET 'https://api-staging.theverity.xyz/api/v1/platform/raffles' \
  -H 'Authorization: Bearer <your_partner_api_key>'

Example Request

curl -X GET 'https://api-staging.theverity.xyz/api/v1/platform/raffles' \  -H 'Authorization: Bearer <your_partner_api_key>'

Example ResponseSchema

{
  "success": true,
  "data": {
    "total": 1,
    "items": [
      {
        "id": 77,
        "name": "Submariner Drop",
        "description": "One Rolex Submariner. 5,000 tickets.",
        "ticket_price_usd": "50.00",
        "start_time": "2026-09-10T12:00:00.000Z",
        "end_time": "2026-09-14T18:00:00.000Z",
        "min_total_entries": 1000,
        "max_total_entries": 5000,
        "per_wallet_limit": 50,
        "buyback_enabled": true,
        "buyback_rate_pct": 85,
        "buyback_window_hours": 24,
        "status": "live",
        "tickets_sold": 4210,
        "published_at": "2026-09-10T12:00:00.000Z",
        "closed_at": null,
        "cancelled_at": null,
        "completed_at": null
      }
    ]
  }
}

{  "success": true,  "data": {    "total": 1,    "items": [      {        "id": 77,        "name": "Submariner Drop",        "description": "One Rolex Submariner. 5,000 tickets.",        "ticket_price_usd": "50.00",        "start_time": "2026-09-10T12:00:00.000Z",        "end_time": "2026-09-14T18:00:00.000Z",        "min_total_entries": 1000,        "max_total_entries": 5000,        "per_wallet_limit": 50,        "buyback_enabled": true,        "buyback_rate_pct": 85,        "buyback_window_hours": 24,        "status": "live",        "tickets_sold": 4210,        "published_at": "2026-09-10T12:00:00.000Z",        "closed_at": null,        "cancelled_at": null,        "completed_at": null      }    ]  }}

List your raffles

AuthorizationCopy Anchor Link

Query ParametersCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Query Parameters

Response Body