Overview of the JSON-RPC API (Release 2)


Learn the fundamentals about how to interact with RANDOM.ORG's JSON-RPC services. This is a must-read for anyone wishing to use a JSON-RPC client.

API Keys, Authentication and Delegation

API Keys
Some of our services (marked with ) require an API key. This section explains how API keys work, when you need them and how to get one.
Authentication API
Some of our services (marked with ) require a RANDOM.ORG account. This section explains how your client can authenticate itself to RANDOM.ORG using such an account.
Delegation API
Delegation allows someone else to act on your behalf. This section explains how you can delegate access to the different RANDOM.ORG services, including the Third-Party Draw Service.
Prerequisites: Fundamentals, Authentication

Core APIs

Basic API
Learn how to use our simplest interface to fetch true random numbers into your mobile app or web app. This is a good section to read, even if you want ultimately to write a more sophisticated client.
Prerequisites: Fundamentals, API Keys
Signed API
The Signed API extends our Basic API by digitally signing the random data, such that you can prove it really came from RANDOM.ORG (authenticity) and that your application has not tampered with it (integrity). This is useful if you want your application to implement non-repudiation.
Prerequisites: Fundamentals, API Keys, Basic API

Drawings and Verifiable Randomness

Third-Party Draw Service API
The Third-Party Draw Service is our flagship service for drawings and lotteries. It supports up to 3,000,000 entries and 50,000 winners and has many privacy options to show your drawings are fair and unbiased with maximum flexibility and transparency.
Prerequisites: Fundamentals, Authentication
Multi-Round Giveaway Service API
The Multi-Round Giveaway Service is to run smaller giveaways with up to 3,000 entries. It is particularly suited for giveaways that are streamed via live video.
Prerequisites: Fundamentals, Authentication
Note: Access to this API is currently by invitation only. To request an invitation, please get in touch.

Error Handling and Developer Tools

Error Codes
Lists all the error codes that your client can encounter while using the JSON-RPC API.
Request Builder
A handy learning and debugging tool that will construct JSON-RPC requests for you, so you can see what they should look like.
Source Code
Libraries in various languages that you can use to interface to the JSON-RPC service.