DevKits API Documentation

GET /api/uuid/generate Free · Pro

Generate a random UUID v4. Optionally request a bulk batch of UUIDs in one call.

Query Parameters

Param	Type	Default	Description
count	integer	1	Number of UUIDs (max 5 Free, 50 Pro)

cURL

curl https://api.aiforeverthing.com/api/uuid/generate

# With API Key (Pro)
curl -H "X-API-Key: dk_live_xxxx" \
  "https://api.aiforeverthing.com/api/uuid/generate?count=5"

JavaScript

const res = await fetch(
  'https://api.aiforeverthing.com/api/uuid/generate',
  { headers: { 'X-API-Key': 'dk_live_xxxx' } }
);
const { uuid } = await res.json();

Response

{
  "uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "version": 4,
  "timestamp": "2026-03-19T10:00:00.000Z"
}
// count=3 returns { "uuids": [...], "count": 3 }

POST /api/uuid/validate Free · Pro

Validate whether a string is a valid UUID and return its version.

cURL

curl -X POST https://api.aiforeverthing.com/api/uuid/validate \
  -H "Content-Type: application/json" \
  -d '{"uuid":"f47ac10b-58cc-4372-a567-0e02b2c3d479"}'

JavaScript

const res = await fetch('https://api.aiforeverthing.com/api/uuid/validate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ uuid: myUuid })
});

Response

{
  "valid": true,
  "version": 4,
  "uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
}

POST /api/base64/encode Free · Pro

Encode a string to Base64. Supports standard and URL-safe Base64 alphabet.

Field	Type	Required	Description
text	string	yes	Text to encode
url_safe	boolean	no	Use URL-safe Base64 (default: false)

cURL

curl -X POST https://api.aiforeverthing.com/api/base64/encode \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello, World!"}'

JavaScript

const { encoded } = await (
  await fetch('https://api.aiforeverthing.com/api/base64/encode', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ text: 'Hello, World!' })
  })
).json();

Response

{
  "encoded": "SGVsbG8sIFdvcmxkIQ==",
  "original_length": 13,
  "encoded_length": 20,
  "url_safe": false
}

POST /api/base64/decode Free · Pro

Decode a Base64 string back to plain text.

cURL

curl -X POST https://api.aiforeverthing.com/api/base64/decode \
  -H "Content-Type: application/json" \
  -d '{"encoded":"SGVsbG8sIFdvcmxkIQ=="}'

Python

import requests
res = requests.post(
  'https://api.aiforeverthing.com/api/base64/decode',
  json={'encoded': 'SGVsbG8sIFdvcmxkIQ=='}
)
print(res.json()['decoded'])

Response

{
  "decoded": "Hello, World!",
  "valid": true,
  "bytes": 13
}

POST /api/json/format Free · Pro

Pretty-print and validate a JSON string. Control indentation and key sorting.

Field	Type	Default	Description
json	string	required	The JSON string to format
indent	integer	2	Spaces of indentation (1-8)
sort_keys	boolean	false	Alphabetically sort object keys

cURL

curl -X POST https://api.aiforeverthing.com/api/json/format \
  -H "Content-Type: application/json" \
  -d '{"json":"{\"name\":\"Alice\",\"age\":30}","indent":2}'

JavaScript

const { formatted } = await (
  await fetch('https://api.aiforeverthing.com/api/json/format', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ json: compactString, indent: 2 })
  })
).json();

Response

{
  "formatted": "{\n  \"name\": \"Alice\",\n  \"age\": 30\n}",
  "valid": true,
  "size_bytes": 34,
  "depth": 1
}

POST /api/json/minify Free · Pro

Strip whitespace from a JSON string to minimize payload size.

cURL

curl -X POST https://api.aiforeverthing.com/api/json/minify \
  -H "Content-Type: application/json" \
  -d '{"json":"{\n  \"name\": \"Alice\",\n  \"age\": 30\n}"}'

Go

resp, _ := http.Post(
  "https://api.aiforeverthing.com/api/json/minify",
  "application/json",
  strings.NewReader(`{"json":"`+prettyJSON+`"}`),
)
defer resp.Body.Close()

Response

{
  "minified": "{\"name\":\"Alice\",\"age\":30}",
  "original_bytes": 34,
  "minified_bytes": 24,
  "savings_pct": 29.4
}

POST /api/jwt/decode Free · Pro

Decode a JWT token and inspect its header and payload. Does not verify the signature — use for debugging only.

cURL

curl -X POST https://api.aiforeverthing.com/api/jwt/decode \
  -H "Content-Type: application/json" \
  -d '{"token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."}'

JavaScript

const { header, payload, expired } = await (
  await fetch('https://api.aiforeverthing.com/api/jwt/decode', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ token: jwtString })
  })
).json();

Response

{
  "header": { "alg": "HS256", "typ": "JWT" },
  "payload": { "sub": "1234567890", "name": "Alice", "exp": 1716239022 },
  "expired": false,
  "expires_at": "2024-05-20T21:43:42.000Z"
}

POST /api/hash/generate Free · Pro

Compute a cryptographic hash. Supports MD5, SHA-1, SHA-256, SHA-512.

Field	Type	Default	Description
text	string	required	Input string to hash
algorithm	string	sha256	One of: md5, sha1, sha256, sha512

cURL

curl -X POST https://api.aiforeverthing.com/api/hash/generate \
  -H "Content-Type: application/json" \
  -d '{"text":"hello","algorithm":"sha256"}'

Python

import requests
res = requests.post(
  'https://api.aiforeverthing.com/api/hash/generate',
  json={'text': 'hello', 'algorithm': 'sha256'}
)
print(res.json()['hash'])

Response

{
  "hash": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824",
  "algorithm": "sha256",
  "input_length": 5
}

POST /api/url/encode Free · Pro

Percent-encode a string for safe use in URLs.

cURL

curl -X POST https://api.aiforeverthing.com/api/url/encode \
  -H "Content-Type: application/json" \
  -d '{"text":"hello world & more=things"}'

JavaScript

const { encoded } = await (
  await fetch('https://api.aiforeverthing.com/api/url/encode', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ text: rawString })
  })
).json();

Response

{
  "encoded": "hello%20world%20%26%20more%3Dthings",
  "original": "hello world & more=things"
}

POST /api/url/decode Free · Pro

Decode a percent-encoded URL string back to its original form.

cURL

curl -X POST https://api.aiforeverthing.com/api/url/decode \
  -H "Content-Type: application/json" \
  -d '{"encoded":"hello%20world%20%26%20more%3Dthings"}'

JavaScript

const { decoded } = await (
  await fetch('https://api.aiforeverthing.com/api/url/decode', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ encoded: encodedString })
  })
).json();

Response

{
  "decoded": "hello world & more=things",
  "encoded": "hello%20world%20%26%20more%3Dthings"
}

POST /api/color/convert Free · Pro

Convert between HEX, RGB, HSL, and HSV color formats. Input format is auto-detected.

Field	Type	Required	Description
color	string	yes	Input color value (e.g. #10b981, rgb(16,185,129))
to	string	yes	Target format: hex, rgb, hsl, hsv

cURL

curl -X POST https://api.aiforeverthing.com/api/color/convert \
  -H "Content-Type: application/json" \
  -d '{"color":"#10b981","to":"rgb"}'

JavaScript

const { result } = await (
  await fetch('https://api.aiforeverthing.com/api/color/convert', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ color: '#10b981', to: 'hsl' })
  })
).json();

Response

{
  "input": "#10b981",
  "input_format": "hex",
  "result": "rgb(16, 185, 129)",
  "output_format": "rgb",
  "components": { "r": 16, "g": 185, "b": 129 }
}

POST /api/timestamp/convert Free · Pro

Convert Unix timestamps to ISO 8601 / human-readable dates, and vice versa.

Field	Type	Default	Description
timestamp	integer	required	Unix timestamp to convert
unit	string	seconds	seconds or ms (milliseconds)

cURL

curl -X POST https://api.aiforeverthing.com/api/timestamp/convert \
  -H "Content-Type: application/json" \
  -d '{"timestamp":1710864000,"unit":"seconds"}'

JavaScript

const { iso, relative } = await (
  await fetch('https://api.aiforeverthing.com/api/timestamp/convert', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ timestamp: Date.now(), unit: 'ms' })
  })
).json();

Response

{
  "timestamp": 1710864000,
  "unit": "seconds",
  "iso": "2024-03-19T16:00:00.000Z",
  "utc": "Tue, 19 Mar 2024 16:00:00 GMT",
  "relative": "1 year ago"
}

Error Codes

All errors return JSON with error and message fields.

{
  "error": "INVALID_JSON",
  "message": "The provided JSON is malformed at line 3",
  "status": 400
}

HTTP	Error Code	Description
400	BAD_REQUEST	Missing required fields or invalid parameter values
400	INVALID_JSON	The provided JSON string is malformed
401	INVALID_API_KEY	The X-API-Key header is invalid or expired
404	NOT_FOUND	The requested endpoint does not exist
413	PAYLOAD_TOO_LARGE	Body exceeds 1 MB (Free) or 10 MB (Pro)
429	RATE_LIMITED	Daily limit reached. See Retry-After header
500	INTERNAL_ERROR	Unexpected server error. Retry or contact support

Rate Limit Headers

Header	Description
X-RateLimit-Limit	Your total daily limit
X-RateLimit-Remaining	Requests remaining today
X-RateLimit-Reset	Unix timestamp when limit resets (midnight UTC)
Retry-After	Seconds to wait before retrying (on 429 only)

Authentication

Query Parameters

Error Codes

Rate Limit Headers

Need More Than 100 Requests/Day?