JSON Export Schemas

Complete documentation of JSON structures exported by each generator.

GUID Generator Schema

The GUID generator exports an array of string values representing unique identifiers.

JSON Schema
[
  "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "6ba7b811-9dad-11d1-80b4-00c04fd430c8"
]
Format Options: GUIDs can be exported with/without hyphens, with/without braces, and in upper/lowercase.
Schema Definition
{
  "type": "array",
  "items": {
    "type": "string",
    "pattern": "^[0-9a-fA-F]{8}-?[0-9a-fA-F]{4}-?[0-9a-fA-F]{4}-?[0-9a-fA-F]{4}-?[0-9a-fA-F]{12}$",
    "description": "A UUID/GUID string with optional formatting"
  }
}

People Generator Schema

The people generator exports an array of person objects with contact information and addresses.

JSON Example
[
  {
    "name": "John Smith",
    "email": "john.smith@example.com",
    "phone": "(555) 123-4567",
    "address": "123 Main St, Anytown, CA 12345"
  },
  {
    "name": "Jane Doe",
    "email": "jane.doe@example.com",
    "phone": "(555) 987-6543",
    "address": "456 Oak Ave, Another City, NY 67890"
  }
]
Schema Definition
{
  "type": "array",
  "items": {
    "type": "object",
    "required": ["name"],
    "properties": {
      "name": {
        "type": "string",
        "description": "Full name of the person"
      },
      "email": {
        "type": "string",
        "format": "email",
        "description": "Email address (optional)"
      },
      "phone": {
        "type": "string",
        "description": "Phone number (optional)"
      },
      "address": {
        "type": "string",
        "description": "Complete postal address (optional)"
      }
    }
  }
}

Orders Generator Schema

The orders generator exports an array of order objects with customer information and order details.

JSON Example
[
  {
    "orderNumber": "ORD-2024-001",
    "customerName": "Alice Johnson",
    "customerEmail": "alice.johnson@example.com",
    "customerPhone": "(555) 234-5678",
    "customerAddress": "789 Pine St, Sample City, TX 54321",
    "total": "$156.99",
    "status": "Shipped",
    "items": [
      {
        "productName": "Wireless Headphones",
        "details": "Electronics • Qty: 1",
        "price": "$79.99"
      },
      {
        "productName": "Phone Case",
        "details": "Accessories • Qty: 2",
        "price": "$77.00"
      }
    ]
  }
]
Schema Definition
{
  "type": "array",
  "items": {
    "type": "object",
    "required": ["orderNumber", "customerName", "items"],
    "properties": {
      "orderNumber": {
        "type": "string",
        "description": "Unique order identifier"
      },
      "customerName": {
        "type": "string",
        "description": "Customer's full name"
      },
      "customerEmail": {
        "type": "string",
        "format": "email",
        "description": "Customer's email address"
      },
      "customerPhone": {
        "type": "string",
        "description": "Customer's phone number"
      },
      "customerAddress": {
        "type": "string",
        "description": "Customer's address"
      },
      "total": {
        "type": "string",
        "description": "Order total amount (formatted currency)"
      },
      "status": {
        "type": "string",
        "description": "Order status (e.g., Pending, Shipped, Delivered)"
      },
      "items": {
        "type": "array",
        "items": {
          "type": "object",
          "required": ["productName"],
          "properties": {
            "productName": {
              "type": "string",
              "description": "Name of the product"
            },
            "details": {
              "type": "string",
              "description": "Product category and quantity info"
            },
            "price": {
              "type": "string",
              "description": "Item total price (formatted currency)"
            }
          }
        }
      }
    }
  }
}

Password Generator Schema

The password generator exports an array of plain string values. Passwords are never stored server-side and exist only in the response.

JSON Example
[
  "kR7!mNqP2xLv",
  "correct-horse-battery-staple",
  "8f3a1b2c4d5e"
]
Format Note: The string format varies by password type — random character strings, hyphen-separated word passphrases, numeric PINs, hexadecimal strings, or alphanumeric strings.
Schema Definition
{
  "type": "array",
  "items": {
    "type": "string",
    "description": "A generated password string. Format depends on the type requested."
  }
}

Color Palette Schema

The color generator exports an array of color swatches, each with values in three formats.

JSON Example
[
  {
    "hex": "#4A90E2",
    "rgb": "rgb(74, 144, 226)",
    "hsl": "hsl(211, 71%, 59%)"
  },
  {
    "hex": "#E24A7A",
    "rgb": "rgb(226, 74, 122)",
    "hsl": "hsl(341, 71%, 59%)"
  }
]
Schema Definition
{
  "type": "array",
  "items": {
    "type": "object",
    "required": ["hex", "rgb", "hsl"],
    "properties": {
      "hex": {
        "type": "string",
        "description": "Hexadecimal color string (e.g. #4A90E2)"
      },
      "rgb": {
        "type": "string",
        "description": "CSS rgb() function string"
      },
      "hsl": {
        "type": "string",
        "description": "CSS hsl() function string"
      }
    }
  }
}

Lorem Ipsum Schema

The Lorem Ipsum generator exports an array of strings. Each element is one word, sentence, or paragraph depending on the requested unit.

JSON Example (Paragraphs)
[
  "Lorem ipsum dolor sit amet, consectetur adipiscing elit...",
  "Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua...",
  "Ut enim ad minim veniam, quis nostrud exercitation ullamco..."
]
Schema Definition
{
  "type": "array",
  "items": {
    "type": "string",
    "description": "A word, sentence, or paragraph of placeholder text"
  }
}

Hash Generator Schema

The hash endpoint returns a single result object containing the computed hash and metadata.

JSON Example
{
  "hash": "dffd6021bb2bd5b0af676290809ec3a53191dd81c7f70a4b28688a362182986d",
  "error": null,
  "algorithm": "SHA-256",
  "encoding": "Hex"
}
Schema Definition
{
  "type": "object",
  "properties": {
    "hash": {
      "type": ["string", "null"],
      "description": "The computed hash string, or null on error"
    },
    "error": {
      "type": ["string", "null"],
      "description": "Error message if computation failed, otherwise null"
    },
    "algorithm": {
      "type": "string",
      "description": "Algorithm used: MD5, SHA-1, SHA-256, or SHA-512"
    },
    "encoding": {
      "type": "string",
      "description": "Output encoding used: Hex or Base64"
    }
  }
}

Base64 Schema

The Base64 endpoint returns a single result object with the encoded or decoded output.

JSON Example (Encode)
{
  "output": "SGVsbG8sIFdvcmxkIQ==",
  "error": null,
  "mode": 0
}
Schema Definition
{
  "type": "object",
  "properties": {
    "output": {
      "type": ["string", "null"],
      "description": "The encoded or decoded string, or null on error"
    },
    "error": {
      "type": ["string", "null"],
      "description": "Error message if conversion failed, otherwise null"
    },
    "mode": {
      "type": "integer",
      "description": "0 = Encode, 1 = Decode"
    }
  }
}

JSON Formatter Schema

The JSON formatter endpoint returns the processed JSON string along with the action that was applied.

JSON Example (Format)
{
  "output": "{\n  \"name\": \"Alice\",\n  \"age\": 30\n}",
  "error": null,
  "action": 0
}
Schema Definition
{
  "type": "object",
  "properties": {
    "output": {
      "type": ["string", "null"],
      "description": "The formatted or minified JSON string, or null on error"
    },
    "error": {
      "type": ["string", "null"],
      "description": "Error message if processing failed (e.g. invalid JSON), otherwise null"
    },
    "action": {
      "type": "integer",
      "description": "0 = Format, 1 = Minify"
    }
  }
}

JWT Decoder Schema

The JWT decoder returns the decoded header and payload as pretty-printed JSON strings. Token signatures are not verified.

JSON Example
{
  "headerJson": "{\n  \"alg\": \"HS256\",\n  \"typ\": \"JWT\"\n}",
  "payloadJson": "{\n  \"sub\": \"1234567890\",\n  \"name\": \"John Doe\",\n  \"iat\": 1516239022\n}",
  "error": null
}
Schema Definition
{
  "type": "object",
  "properties": {
    "headerJson": {
      "type": ["string", "null"],
      "description": "Pretty-printed JSON string of the token header, or null on error"
    },
    "payloadJson": {
      "type": ["string", "null"],
      "description": "Pretty-printed JSON string of the token payload, or null on error"
    },
    "error": {
      "type": ["string", "null"],
      "description": "Error message if decoding failed (e.g. malformed token), otherwise null"
    }
  }
}

Unix Timestamp Schema

The timestamp converter returns the converted value along with conversion direction metadata.

JSON Example (EpochToDate)
{
  "output": "2023-11-14 22:13:20 UTC",
  "error": null,
  "direction": 0
}
Schema Definition
{
  "type": "object",
  "properties": {
    "output": {
      "type": ["string", "null"],
      "description": "The converted value \u2014 a date string (EpochToDate) or epoch number (DateToEpoch), or null on error"
    },
    "error": {
      "type": ["string", "null"],
      "description": "Error message if conversion failed, otherwise null"
    },
    "direction": {
      "type": "integer",
      "description": "0 = EpochToDate, 1 = DateToEpoch"
    }
  }
}

TypeScript Definitions

Type definitions for TypeScript developers integrating with the exported data.

types.ts
// GUID Generator Types
export type GuidArray = string[];

// People Generator Types
export interface Person {
  name: string;
  email?: string;
  phone?: string;
  address?: string;
}
export type PeopleArray = Person[];

// Orders Generator Types
export interface OrderItem {
  productName: string;
  details?: string;
  price?: string;
}
export interface Order {
  orderNumber: string;
  customerName: string;
  customerEmail?: string;
  customerPhone?: string;
  customerAddress?: string;
  total?: string;
  status?: string;
  items: OrderItem[];
}
export type OrdersArray = Order[];

// Password Generator Types
export type PasswordArray = string[];

// Color Palette Types
export interface ColorSwatch {
  hex: string;
  rgb: string;
  hsl: string;
}
export type ColorPalette = ColorSwatch[];

// Lorem Ipsum Types
export type LoremArray = string[];

// Hash Generator Types
export interface HashResult {
  hash: string | null;
  error: string | null;
  algorithm: string;
  encoding: string;
}

// Base64 Types
export interface Base64Result {
  output: string | null;
  error: string | null;
  mode: 0 | 1; // 0 = Encode, 1 = Decode
}

// JSON Formatter Types
export interface JsonFormatterResult {
  output: string | null;
  error: string | null;
  action: 0 | 1; // 0 = Format, 1 = Minify
}

// JWT Decoder Types
export interface JwtDecodeResult {
  headerJson: string | null;
  payloadJson: string | null;
  error: string | null;
}

// Timestamp Types
export interface TimestampResult {
  output: string | null;
  error: string | null;
  direction: 0 | 1; // 0 = EpochToDate, 1 = DateToEpoch
}