RandNext · Schema

Draw

Fields needed to verify a draw are documented at https://randnext.com/draws/how-it-works.

CompanyRandomGeneratorAPIFun

Properties

Name Type Description
id string
seq integer Public draw number.
title stringnull null when removed by moderation.
description stringnull
status string
algorithm string
entry_count integer
winner_count integer
duplicates string
entries_visibility string
entries_hash string SHA-256 (hex) of the normalized entry list.
commitment string SHA-256 (hex) of the server seed, published when the draw was locked.
server_seed stringnull Revealed at the draw time; null before.
params string id, winners and entries, bound into the final seed.
final_seed stringnull
beacon objectnull randnext-draw-v2: the drand quicknet round fixed at lock time. randomness and signature (BLS, G1) appear after the reveal.
prizes arraynull randnext-draw-v3 prize draws: prize tiers in locked order, drawn live by the host one by one. Each tier has its own drand round; winners of earlier tiers are excluded. Null for single draws.
signatures object Ed25519 signatures (hex) over the lock and result statements; null on v1 records. Public key: /api/v1/draws/signing-keys.
winners arraynull
created_at string When the entry list was locked.
draw_at string
drawn_at stringnull
cancelled_at stringnull
pre_announced boolean false when the draw happened less than 10 minutes after locking.
listed boolean Whether the organizer shows this record in the public list.
entries_purged boolean
entries_url stringnull
url string
verify_url string
View JSON Schema on GitHub

JSON Schema

randnext-draw-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/randnext/main/json-schema/randnext-draw-schema.json",
  "title": "Draw",
  "description": "Fields needed to verify a draw are documented at https://randnext.com/draws/how-it-works.",
  "x-generated": "2026-10-28",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/randnext-openapi.json#/components/schemas/Draw",
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "seq": {
      "type": "integer",
      "description": "Public draw number."
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "null when removed by moderation."
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "scheduled",
        "drawn",
        "cancelled",
        "removed"
      ]
    },
    "algorithm": {
      "type": "string",
      "enum": [
        "randnext-draw-v1",
        "randnext-draw-v2",
        "randnext-draw-v3"
      ]
    },
    "entry_count": {
      "type": "integer"
    },
    "winner_count": {
      "type": "integer"
    },
    "duplicates": {
      "type": "string",
      "enum": [
        "keep",
        "merge"
      ]
    },
    "entries_visibility": {
      "type": "string",
      "enum": [
        "hidden",
        "public"
      ]
    },
    "entries_hash": {
      "type": "string",
      "description": "SHA-256 (hex) of the normalized entry list."
    },
    "commitment": {
      "type": "string",
      "description": "SHA-256 (hex) of the server seed, published when the draw was locked."
    },
    "server_seed": {
      "type": [
        "string",
        "null"
      ],
      "description": "Revealed at the draw time; null before."
    },
    "params": {
      "type": "string",
      "description": "id, winners and entries, bound into the final seed."
    },
    "final_seed": {
      "type": [
        "string",
        "null"
      ]
    },
    "beacon": {
      "type": [
        "object",
        "null"
      ],
      "description": "randnext-draw-v2: the drand quicknet round fixed at lock time. randomness and signature (BLS, G1) appear after the reveal.",
      "properties": {
        "chain_hash": {
          "type": "string"
        },
        "round": {
          "type": "integer"
        },
        "randomness": {
          "type": [
            "string",
            "null"
          ]
        },
        "signature": {
          "type": [
            "string",
            "null"
          ]
        },
        "url": {
          "type": "string",
          "format": "uri"
        }
      }
    },
    "prizes": {
      "type": [
        "array",
        "null"
      ],
      "description": "randnext-draw-v3 prize draws: prize tiers in locked order, drawn live by the host one by one. Each tier has its own drand round; winners of earlier tiers are excluded. Null for single draws.",
      "items": {
        "type": "object",
        "properties": {
          "tier": {
            "type": "integer"
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "winner_count": {
            "type": "integer"
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "drawing",
              "drawn"
            ]
          },
          "beacon": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "chain_hash": {
                "type": "string"
              },
              "round": {
                "type": "integer"
              },
              "randomness": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "signature": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": "string"
              }
            }
          },
          "started_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "drawn_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "params": {
            "type": [
              "string",
              "null"
            ]
          },
          "final_seed": {
            "type": [
              "string",
              "null"
            ]
          },
          "winners": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "object",
              "properties": {
                "rank": {
                  "type": "integer"
                },
                "index": {
                  "type": "integer"
                },
                "entry": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          },
          "signatures": {
            "type": "object",
            "properties": {
              "start": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "result": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          }
        }
      }
    },
    "signatures": {
      "type": "object",
      "description": "Ed25519 signatures (hex) over the lock and result statements; null on v1 records. Public key: /api/v1/draws/signing-keys.",
      "properties": {
        "key_id": {
          "type": [
            "string",
            "null"
          ]
        },
        "lock": {
          "type": [
            "string",
            "null"
          ]
        },
        "result": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "winners": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "rank": {
            "type": "integer"
          },
          "index": {
            "type": "integer",
            "description": "0-based position in the normalized entry list."
          },
          "entry": {
            "type": [
              "string",
              "null"
            ],
            "description": "null when removed by moderation."
          }
        }
      }
    },
    "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "When the entry list was locked."
    },
    "draw_at": {
      "type": "string",
      "format": "date-time"
    },
    "drawn_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "cancelled_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "pre_announced": {
      "type": "boolean",
      "description": "false when the draw happened less than 10 minutes after locking."
    },
    "listed": {
      "type": "boolean",
      "description": "Whether the organizer shows this record in the public list."
    },
    "entries_purged": {
      "type": "boolean"
    },
    "entries_url": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri"
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "verify_url": {
      "type": "string",
      "format": "uri"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/randnext-draw"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.