Using the Random Passphrase API

Welcome to the Random Passphrase API! This API generates random passphrases for you to use. In this guide, we'll walk you through how to use the API to generate passphrases. See the source code here: GitHub

Getting Started

To use the API, you'll need to make a GET request to one of the following endpoints:

Passphrase Generation

By default, the API will generate a passphrase with 6 words. If the count you provide is invalid, the API will use this default value. The maximum count is 1000. If the count exceeds this maximum, the result will be truncated to the maximum count.

Word List

The API uses the EFF Long Word List, a list of 7,776 words curated by the Electronic Frontier Foundation (EFF) for generating strong and memorable passphrases. You can view the full list of words here.

Without API Key

If you don't provide an API key, the API will generate a passphrase using a local random number generator, which utilizes Cloudflare's cryptographically secure library to ensure high-quality randomness.

Make a GET request to /api/random/:count, replacing :count with the number of words you want in your passphrase.

Example: https://random.daedalist.net/api/random/8

With API Key

If you provide an API key, the API will generate a passphrase using the specified API key. If the API key is for Random.org, the API will use Random.org's API to generate true randomness from atmospheric noise.

Make a GET request to /api/random/:count/token/:token, replacing :count with the number of words you want in your passphrase and :token with your API key.

Example: https://random.daedalist.net/api/random/8/token/your_api_key_here

Parameters

Response

The API will respond with a text string containing the generated passphrase.

Example Use Cases