PhP Implementation of's JSON-RPC API
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Native PHP and Laravel Implementation of's JSON-RPC API

Installation with Composer

composer require defiant/randomorg

or add it in your composer.json require block.

    "require": {
        "defiant/randomorg": "1.*"


composer update

Native PHP Usage

$apiKey = '00000000-0000-0000-0000-000000000000';
$random = new RandomOrg\Random($apiKey);

// Simple method
// following functions returns 52 random non-repeating numbers between 1-52

$result = $random->generateIntegers(52, 1, 52, false);

// Signed methods
// following functions returns the above with signed data
$result = $random->generateIntegers(52, 1, 52, false, 10, true);

// Verify Signature
$verified = $random->verifySignature($result['result']['random'], $result['result']['signature']);

Laravel Usage

  • Register service provider in your config/app.php file.
  • Register the RandomOrg facade in the aliases key of your config/app.php
'RandomOrg' => RandomOrg\Facades\Random::class,
  • Run a vendor:publish artisan command to publish your configuration assets to config/randomorg.php
$ php artisan vendor:publish --provider="RandomOrg\RandomServiceProvider"

You may set your API key directly in your config/randomorg.php file or in your .env file like so:


Example code:

use RandomOrg;

public function random()
    return RandomOrg::generateIntegers(52, 1, 52, false);

About API Keys

You can get your own API key at

Api Key (00000000-0000-0000-0000-000000000000) used in these examples will be disabled when the beta ends. Get your API key at

For the native implementation, there are three methods where you can set the API key in your class.

First in the constructor:

$apiKey = '00000000-0000-0000-0000-000000000000';
$random = new RandomOrg\Random($apiKey);

Secondly you can set it directly your class

protected $apiKey = '00000000-0000-0000-0000-000000000000';

or you can use the setApi method

$apiKey = '00000000-0000-0000-0000-000000000000';
$random = new RandomOrg\Random();

Note: Method names are the same with simple method names on the API. To make signed request an optional boolean parameter is needed as the final argument.

Currently supports simple and signed methods below. For more information see

  • generateIntegers
  • generateDecimalFractions
  • generateGaussians
  • generateStrings
  • generateUUIDs
  • generateBlobs
  • getUsage
  • generateSignedIntegers
  • generateSignedDecimalFractions
  • generateSignedGaussians
  • generateSignedStrings
  • generateSignedUUIDs
  • generateSignedBlobs
  • verifySignature