Browse documentation

Generators API

23 endpoints for generators workflows. Every call requires bearer authentication and uses the standard ToolsOnDuty response envelope.

Try it

Runs a real request from your browser to your own ToolsOnDuty account. Your key is only kept in this page and is never stored.

EndpointAPI key

count

POST/v1/uuid1 credit / call

UUID v4 generator

Generate one or more random UUID v4 values.

Parameter	Type	Required	Description
count	number	No	How many to generate (1-100). Default: 1.

Request

curl -X POST https://toolsonduty.com/api/v1/uuid \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"count":3}'

Response

{
  "ok": true,
  "data": {
    "uuids": [
      "b3b7...",
      "c4d8...",
      "e5f1..."
    ]
  }
}

POST/v1/token1 credit / call

Random token generator

Generate one or more cryptographically random tokens in hex, base62, base64url or alphanumeric.

Parameter	Type	Required	Description
format	string	No	hex \| base62 \| base64url \| alphanumeric. Default: base62.
length	number	No	Token length (1-256). Default: 32.
count	number	No	How many to generate (1-100). Default: 1.
prefix	string	No	Optional prefix prepended to each token.

Request

curl -X POST https://toolsonduty.com/api/v1/token \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"format":"base62","length":24}'

Response

{
  "ok": true,
  "data": {
    "tokens": [
      "aZ9k..."
    ]
  }
}

POST/v1/generators/passphrase1 credit / call

Memorable passphrase generator

Generate a memorable passphrase (e.g. correct-horse-battery-staple) from a curated word list using secure randomness.

Parameter	Type	Required	Description
words	number	No	Number of words (2-12). Default: 4.
separator	string	No	Separator between words. Default: -.
capitalize	boolean	No	Capitalize each word. Default: false.
number	boolean	No	Append a random 2-digit number. Default: false.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/passphrase \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"words":4}'

Response

{
  "ok": true,
  "data": {
    "result": "coral-lantern-otter-brave"
  }
}

POST/v1/generators/ascii-banner1 credit / call

ASCII banner generator

Render text as a large block-letter ASCII banner (5-row font).

Parameter	Type	Required	Description
text	string	Yes	Text to render (max ~40 characters recommended).

Request

curl -X POST https://toolsonduty.com/api/v1/generators/ascii-banner \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"text":"HI"}'

Response

{
  "ok": true,
  "data": {
    "result": "#   #  #####\n#   #    #\n#####    #\n#   #    #\n#   #  #####"
  }
}

POST/v1/generators/mock-data1 credit / call

Mock data generator

Generate an array of mock JSON records with the requested fields: id, firstName, lastName, fullName, email, phone, city, street, company, jobTitle, date, boolean, uuid.

Parameter	Type	Required	Description
fields	string	Yes	Array of field names, e.g. ["firstName","email"]. Allowed: id, firstName, lastName, fullName, email, phone, city, street, company, jobTitle, date, boolean, uuid.
count	number	No	Number of records (1-1000). Default: 10.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/mock-data \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"fields":["firstName","email"],"count":2}'

Response

{
  "ok": true,
  "data": {
    "result": [
      {
        "firstName": "Ada",
        "email": "ada.lovelace@example.com"
      }
    ]
  }
}

POST/v1/generators/deep-link1 credit / call

Mobile deep link builder

Build a custom-scheme deep link URI from a scheme, host, path and query parameters.

Parameter	Type	Required	Description
scheme	string	Yes	URI scheme, e.g. "myapp".
host	string	No	Host segment. Default: .
path	string	No	Path segment. Default: .
params	string	No	Array of {key, value} query parameters.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/deep-link \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"scheme":"myapp","host":"product","path":"/123","params":[{"key":"ref","value":"email"}]}'

Response

{
  "ok": true,
  "data": {
    "result": "myapp://product/123?ref=email"
  }
}

POST/v1/generators/emoji-search1 credit / call

Emoji / symbol search

Search the curated emoji and symbol catalog by name or keyword.

Parameter	Type	Required	Description
query	string	Yes	Search term, e.g. "heart" or "smile".
limit	number	No	Maximum matches to return (1-100). Default: 20.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/emoji-search \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"query":"heart"}'

Response

{
  "ok": true,
  "data": {
    "matches": [
      {
        "char": "❤️",
        "name": "Red Heart",
        "group": "Symbols"
      }
    ]
  }
}

POST/v1/generate/cuid1 credit / call

CUID generator

Generate one or more collision-resistant CUID-style identifiers using secure randomness.

Parameter	Type	Required	Description
count	number	No	Number of identifiers from 1 to 100. Default: 1.

Request

curl -X POST https://toolsonduty.com/api/v1/generate/cuid \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"count":2}'

Response

{
  "ok": true,
  "data": {
    "values": [
      "cm...",
      "cm..."
    ]
  }
}

POST/v1/generate/user-agent1 credit / call

User-Agent generator

Generate a plausible browser User-Agent for a selected operating system and version.

Parameter	Type	Required	Description
browser	string	No	chrome \| firefox \| safari \| edge. Default: chrome.
os	string	No	windows \| macos \| linux \| android \| ios. Default: windows.
version	string	No	Browser version with 1 to 4 numeric segments. Default: 125.

Request

curl -X POST https://toolsonduty.com/api/v1/generate/user-agent \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"browser":"chrome","os":"windows","version":"125"}'

Response

{
  "ok": true,
  "data": {
    "result": "Mozilla/5.0 ..."
  }
}

POST/v1/generate/test-imei1 credit / call

Test IMEI generator

Generate synthetic checksum-valid IMEI-format values for software testing only.

Parameter	Type	Required	Description
tac	string	No	Eight-digit test TAC. Default: 35693803.
count	number	No	Number of values from 1 to 100. Default: 1.

Request

curl -X POST https://toolsonduty.com/api/v1/generate/test-imei \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"tac":"35693803","count":2}'

Response

{
  "ok": true,
  "data": {
    "values": [
      "35693803...",
      "35693803..."
    ]
  }
}

POST/v1/generators/ulid1 credit / call

ULID generator

Generate lexicographically sortable 26-character ULIDs using a supplied or current Unix millisecond timestamp.

Parameter	Type	Required	Description
count	number	No	Number of ULIDs to generate (1-100). Default: 1.
timestampMs	number	No	Optional Unix timestamp in milliseconds.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/ulid \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"count":2}'

Response

{
  "ok": true,
  "data": {
    "result": [
      "01J00000000000000000000000"
    ],
    "count": 2
  }
}

POST/v1/generators/lorem-ipsum1 credit / call

Lorem Ipsum generator

Generate placeholder text by paragraphs, sentences or words with an optional classic opening.

Parameter	Type	Required	Description
unit	string	No	paragraphs \| sentences \| words. Default: paragraphs.
count	number	No	Number of requested units (1-100). Default: 3.
startWithLead	boolean	No	Begin with the classic Lorem Ipsum opening. Default: true.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/lorem-ipsum \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"unit":"paragraphs","count":2,"startWithLead":true}'

Response

{
  "ok": true,
  "data": {
    "unit": "paragraphs",
    "count": 2,
    "result": "Lorem ipsum..."
  }
}

POST/v1/generators/username1 credit / call

Username generator

Generate username ideas from an optional normalized keyword without checking external account availability.

Parameter	Type	Required	Description
keyword	string	No	Optional keyword included in each username.
count	number	No	Number of unique suggestions (1-100). Default: 12.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/username \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"tools","count":3}'

Response

{
  "ok": true,
  "data": {
    "result": [
      "brighttools42",
      "pixeltools18",
      "swifttools73"
    ],
    "count": 3
  }
}

POST/v1/generators/qr-code2 credits / call

QR Code SVG generator

Generate a scalable QR Code SVG with configurable error correction, quiet zone and colors.

Parameter	Type	Required	Description
text	string	Yes	Text or URL to encode.
errorCorrection	string	No	L \| M \| Q \| H. Default: M.
margin	number	No	Quiet-zone width in modules (0-16). Default: 4.
dark	string	No	Dark-module hexadecimal color. Default: #0f172a.
light	string	No	Background hexadecimal color. Default: #ffffff.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/qr-code \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"text":"https://toolsonduty.com","errorCorrection":"M"}'

Response

{
  "ok": true,
  "data": {
    "modules": 29,
    "viewBoxSize": 37,
    "svg": "<svg>...</svg>"
  }
}

POST/v1/generators/barcode2 credits / call

CODE128 barcode SVG generator

Generate a dependency-free SVG rendering of a CODE128 barcode for printable or web output.

Parameter	Type	Required	Description
value	string	Yes	ASCII text to encode (maximum 200 characters).
moduleWidth	number	No	Width of each barcode module (1-4). Default: 2.
height	number	No	Bar height in pixels (20-400). Default: 100.
margin	number	No	Outer margin in pixels (0-40). Default: 16.
displayValue	boolean	No	Print the encoded value below the bars. Default: true.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/barcode \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"value":"ToolsOnDuty"}'

Response

{
  "ok": true,
  "data": {
    "format": "CODE128",
    "width": 266,
    "height": 156,
    "svg": "<svg>...</svg>"
  }
}

POST/v1/generators/test-card1 credit / call

Test credit-card number generator

Generate synthetic Luhn-valid card-number formats for QA and form testing; generated values cannot be used for payments.

Parameter	Type	Required	Description
brand	string	No	visa \| mastercard \| amex \| discover. Default: visa.
count	number	No	Number of test values (1-100). Default: 1.
formatted	boolean	No	Include standard visual spacing. Default: true.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/test-card \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"brand":"visa","count":2}'

Response

{
  "ok": true,
  "data": {
    "values": [
      "4111 1111 1111 1111"
    ],
    "warning": "Synthetic test data only."
  }
}

POST/v1/generators/hashtags1 credit / call

Hashtag generator

Generate up to thirty hashtag ideas from supplied keywords and curated category terms; no live trend data is used.

Parameter	Type	Required	Description
keywords	string	Yes	Comma- or newline-separated topic keywords.
category	string	No	business \| education \| fitness \| food \| creator. Default: creator.
location	string	No	Optional location term.
brand	string	No	Optional brand term.
count	number	No	Number of hashtags (1-30). Default: 18.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/hashtags \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"keywords":"meal prep, healthy lunch","category":"food","count":10}'

Response

{
  "ok": true,
  "data": {
    "hashtags": [
      "#mealprep",
      "#healthylunch"
    ],
    "count": 10
  }
}

POST/v1/generators/baby-names1 credit / call

Baby-name idea generator

Return a randomized selection from a small curated name list for inspiration.

Parameter	Type	Required	Description
style	string	No	any \| feminine \| masculine. Default: any.
count	number	No	Number of unique suggestions (1-6). Default: 5.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/baby-names \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"style":"any","count":3}'

Response

{
  "ok": true,
  "data": {
    "names": [
      "Avery",
      "Sage",
      "Rowan"
    ],
    "count": 3
  }
}

POST/v1/generators/company-name1 credit / call

Company-name generator

Generate synthetic company-name ideas from an optional keyword and industry style.

Parameter	Type	Required	Description
keyword	string	No	Optional word included in each suggestion.
industry	string	No	technology \| finance \| health \| retail \| creative. Default: technology.
count	number	No	Number of suggestions (1-25). Default: 12.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/company-name \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"Orbit","industry":"technology","count":3}'

Response

{
  "ok": true,
  "data": {
    "names": [
      "Apex Orbit Labs"
    ],
    "count": 3
  }
}

POST/v1/generators/random-user1 credit / call

Random user generator

Generate synthetic user fixtures with example.com email addresses and fictional 555 phone numbers.

Parameter	Type	Required	Description
count	number	No	Number of records (1-100). Default: 5.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/random-user \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"count":2}'

Response

{
  "ok": true,
  "data": {
    "users": [
      {
        "fullName": "Avery Morgan",
        "email": "avery.morgan123@example.com"
      }
    ],
    "count": 2
  }
}

POST/v1/generators/random-identity1 credit / call

Random identity generator

Generate synthetic identity fixtures for QA, demos and local development.

Parameter	Type	Required	Description
count	number	No	Number of identities (1-100). Default: 3.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/random-identity \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"count":1}'

Response

{
  "ok": true,
  "data": {
    "identities": [
      {
        "synthetic": true
      }
    ],
    "count": 1
  }
}

POST/v1/generators/random-word1 credit / call

Random word generator

Generate randomized nouns, verbs, adjectives or a mixed word list from a curated local vocabulary.

Parameter	Type	Required	Description
category	string	No	mixed \| noun \| verb \| adjective. Default: mixed.
count	number	No	Number of unique words. Default: 8.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/random-word \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"category":"noun","count":3}'

Response

{
  "ok": true,
  "data": {
    "words": [
      "bridge",
      "signal",
      "canvas"
    ],
    "count": 3
  }
}

POST/v1/generators/short-code1 credit / call

Short-code generator

Generate unique short codes with configurable length, safe alphabet and prefix.

Parameter	Type	Required	Description
length	number	No	Generated portion length (4-16). Default: 8.
count	number	No	Number of unique codes (1-100). Default: 10.
alphabet	string	No	alphanumeric \| uppercase \| numeric. Default: alphanumeric.
prefix	string	No	Optional safe prefix.

Request

curl -X POST https://toolsonduty.com/api/v1/generators/short-code \
  -H "Authorization: ******" \
  -H "Content-Type: application/json" \
  -d '{"length":8,"count":2,"prefix":"REF-"}'

Response

{
  "ok": true,
  "data": {
    "codes": [
      "REF-X7kp92Qa"
    ],
    "count": 2
  }
}