A buyer's tickets and odds

GET

/raffles/{raffleId}/users/{externalUserRef}

One of your buyers' position in a raffle, for your own UI. Counts confirmed purchases made through your platform only; odds_pct is measured against total tickets sold across all platforms.

An unknown ref returns zeros rather than a 404 — you cannot probe another platform's buyers with it.

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.

Path Parameters

raffleId*integer

Range1 <= value

externalUserRef*string

The buyer's external_user_ref.

Response Body

application/json

response

success*boolean

data*

Example Request

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

Example Request

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

Example ResponseSchema

{
  "success": true,
  "data": {
    "tickets": 0,
    "odds_pct": 0.1
  }
}

{  "success": true,  "data": {    "tickets": 0,    "odds_pct": 0.1  }}

A buyer's tickets and odds

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Path Parameters

Response Body