True Random Number Service

Note: There is a newer version of this API available.

JSON-RPC API – Release 1

This page describes how to interface to RANDOM.ORG through JSON-RPC. You can invoke this API from any application that has Internet access, including web applications and mobile apps. You need an API key to use the API. Before you run your client, please review our Usage Guidelines.

The documentation is structured as follows:

Explains 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.
Basic Methods
Explains how to use the simplest interface to fetch true random numbers into your mobile app or web app. This is a good second chapter to read, even if you want ultimately to write a more sophisticated client.
Digital Signing
Explains how to generate digitally signed 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.
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.
© 1998-2024 RANDOM.ORG
Valid XHTML 1.0 Transitional | Valid CSS
Web Design by TSDA