• RANDOM.ORG▾
  • api.random.org
  • www.random.org
• API Overview▾
  • Features
  • Pricing
  • Uptime
  • Usage Guidelines
  • About API Keys
  • Get a Beta Key
  • Terms and Conditions
• Verification▾
  • Verify Data
  • Manual Verification
• JSON-RPC▾
  • Table of Contents
  • Introduction
  • Basic Methods
  • Digital Signing
  • Error Codes
  • Request Builder
  • Source Code
• Login

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:

Introduction

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.