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

Drawings and Lotteries

Third-Party Draw Service API
Explains how your application can use RANDOM.ORG's Third-Party Draw Service to hold random drawings in a manner you can show is fair and unbiased.
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

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.