Free API

To generate codes or random strings programmatically, you can use our free API. The API has the same free usage limit as our generator on the website - you can generate up to 250,000 codes 10 times per hour. Below you can find the simple documentation with examples of how to use it.

JSON API

API URL
https://codito.io/free-random-code-generator/api/generate
Request method
POST
Request content type
application/json
Request data

Request data should be a JSON encoded object containing following fields:

Required fields:

  • codesToGenerate - (int) - number of codes to generate
  • onlyUniques - (bool) - set to true if you do not want duplicated codes in the generated codes
  • charactersSets - (array of strings) - list of the allowed characters on each code character position. For example, if you'd like to generate 10-digit code you need to fill this field with array of 10 strings containing \d pattern. Please note that the \ character should be escaped in the JSON string, so you must use the double backslash \\d notation to apply the patterns.

Optional fields:

  • prefix - (string) - the text added before each code.
  • suffix - (string) - the text added after each code.

Example:

{ "codesToGenerate": 5, "prefix": "EXAMPLE-", "onlyUniques": true, "charactersSets": [ "ABC", "123", "\\d" ] }
Codes limit
Maximum 250,000 codes per request.
Rate limit
Maximum 10 successful requests per hour.
Rate limit details

After sending a valid JSON request you can check the current limit, remaining requests and next allowed request date by checking the response headers.

  • x-ratelimit-limit - the requests limit in current time frame.
  • x-ratelimit-remainingrequests - the number of remaining requests in current time frame.
  • x-ratelimit-nextallowedrequest - the date and time when you can make next generation request.

Example:

x-ratelimit-limit: 10
x-ratelimit-remainingrequests: 0
x-ratelimit-nextallowedrequest: 2024-10-12T21:46:55+00:00

Examples

A simple example of generating 10 six-digit numbers.

Request
curl --header "Content-Type: application/json" \
--request POST \
--data '{ "codesToGenerate": 10, "onlyUniques": true, "charactersSets": [ "\\d", "\\d", "\\d", "\\d", "\\d", "\\d" ] }' \
https://codito.io/free-random-code-generator/api/generate
Response
["398785","077629","920758","773844","195664","986727","224308","501655","151524","573400"]

Generating 5 codes with US- country prefix and -2024 suffix.

Request
curl --header "Content-Type: application/json" \
--request POST \
--data '{ "codesToGenerate": 5, "prefix": "US-", "suffix": "-2024", "onlyUniques": true, "charactersSets": [ "ABC", "DEF", "GHI" ] }' \
https://codito.io/free-random-code-generator/api/generate
Response
["US-ADH-2024","US-BDH-2024","US-CFH-2024","US-AEI-2024","US-BFH-2024"]

Generating secure 16 characters long password.

Request
curl --header "Content-Type: application/json" \
--request POST \
--data '{ "codesToGenerate": 1, "onlyUniques": false, "charactersSets": [ "\\d\\l\\L\\@", "\\d\\l\\L\\@", "\\d\\l\\L\\@", "\\d\\l\\L\\@", "\\d\\l\\L\\@", "\\d\\l\\L\\@", "\\d\\l\\L\\@", "\\d\\l\\L\\@", "\\d\\l\\L\\@", "\\d\\l\\L\\@", "\\d\\l\\L\\@", "\\d\\l\\L\\@", "\\d\\l\\L\\@", "\\d\\l\\L\\@", "\\d\\l\\L\\@", "\\d\\l\\L\\@" ] }' \
https://codito.io/free-random-code-generator/api/generate
Response
["Sr5s88y%Lh!QXdqg"]