Winner Picker

Use this endpoint to pick a random winner(s), optionally with standings.

The random result object added properties

Properties

  • Name
    winner
    Type
    array
    Description
    Picked winner(s)
POST /api/random/winner

Pick random winner(s)

This endpoint allows you to pick a random winner(s), optionally with standings.

Parameters

  • Name
    names
    Type
    array
    Description
    Array of names to pick from.
  • Name
    numWinners
    Type
    integer
    Description
    Amount of winners to pick.
  • Name
    standings
    Type
    boolean
    Description
    Assign standings to the winners.

Request

POST
/api/random/winner
 curl -X POST https://qrandom.io/api/random/winner 
 -H 'Content-Type: application/json' 
 -d '{"names":["John","Mac","Ailbhe","Brian"],"numWinners":2,"standings":true}'

Response

{
    "signature": "OZElJBEZEAZJPng64L3B7URAJe+ZT9ewcI5ulggHd/C59QBXOukgN84qRpgu3Ok6SbGSzxo3LoIvTr3Tutgc3MxFR5hayrNBmvpgFxeZr5t83gUOu3pw0Tm154Tm6IqN980jEKof8vi2eLMlk6VAtE78RNeu4Tk3W5R+JbtG4a2dT18x3X4qzhTw4vmihX66yaqfv69733bQMHnqu8Wg+ePrKnuParnjtDHXYOeb0k0iQiHWGTwE7Pxa35wbT+5DR78/ZFnQUjKVKcREv1YUxCqWjRApcVDOL5tumv/W1V8saJIo5ib2xc3QinadGSGOwPonGJI1qrKjkHJvoXhrBJFpWSnuoVlsOny/IfrC5rzTtObfyKLCU+Vu1zqXSFS27/FkW3Ex/Iocvi89DESCDYaL6LQCPzHKI3eEbk85X4m2dcmWyDBmelvNT8+dHULxqVzNEjh4uahXOZW6XuqQuiyBUqo0syZFjfNQDJ30irNJrvFdWl2KjC1RHdXCtry6uuEkz7z3ZOKChTVoP0NhNGCWK/qa2F99xbcjaU1qO/Y2GdHFMZUehkZm/qA6xj+QidRK70M/GmFVtY+yTCCsK5bWlwa1mDhC32tiUyHZ8megI0KRj8XFmyxMxQ34ZthqStGeo6SrHB88YVEHxS/1pZFNvSp8teW1TDuiNOYbzCFwOVsX0hUUR0O1uzQ8SMN58Y2S2Z5vdpeZ7oPe8KWPresp2pe0E/TJ4HO5XzM0nPPyjrVQ90ub+AkU0x2r9OLDDySzU6v72brQ6/axafIav31CvxVqGrLepkTld3okfmnZq3v46lt1fd0nLD3bNngxCAODIGEVBlkfVLs3FFo2a6rdlRIckkTNO3xy1h62Fg==",
    "winner": ["1: Brian","2: John"],
    "elapsedTime": 0.0478,
    "timestamp": "2023-02-11T09:45:11Z",
    "resultType": "winner",
    "message": "Request: Winner(s): ["1: Brian", "2: John"], Amount: 2, ResultHash: dafff8b528f861370ab54b4992e2f211de8a649f1db93350c293db875945e535, Timestamp: 1676108711.026375","id":"Q0Y2NDFEMkEtMDQwMy00REU1LTlBRDktNTdCRUUzMTJBOTc2"
}