Template Variables

Template variables let you insert dynamic values into your mock responses. Use {{variable}} syntax in your response body or headers — values are generated fresh on each request.

Built-in Generators

Basic

Variable	Output	Example
`{{$uuid}}`	Random UUID	`f47ac10b-58cc-4372-a567-0e02b2c3d479`
`{{$randomInt}}`	Integer 0-1000	`42`
`{{$randomFloat}}`	Float 0.00-1.00	`0.73`
`{{$randomBool}}`	Boolean	`true`
`{{$randomEmail}}`	Email address	`[email protected]`
`{{$randomName}}`	Full name	`Alice Smith`
`{{$randomString}}`	16-char alphanumeric	`kf82mq1xp03nzw9y`
`{{$timestamp}}`	ISO 8601 timestamp	`2025-06-15T14:30:00.000Z`
`{{$timestampUnix}}`	Unix seconds	`1750000200`
`{{$date}}`	Date	`2025-06-15`

Identity & Contact

Variable	Output	Example
`{{$firstName}}`	First name	`Alice`
`{{$lastName}}`	Last name	`Smith`
`{{$phone}}`	Phone number	`(555) 123-4567`
`{{$username}}`	Username	`alice.smith42`
`{{$avatar}}`	Avatar URL	`https://i.pravatar.cc/150?u=abc123`

Location

Variable	Output	Example
`{{$street}}`	Street address	`742 Maple Ave`
`{{$city}}`	City	`Portland`
`{{$state}}`	US state	`Oregon`
`{{$zip}}`	ZIP code	`97201`
`{{$country}}`	Country	`United States`
`{{$latitude}}`	Latitude	`45.5231`
`{{$longitude}}`	Longitude	`-122.6765`

Text

Variable	Output	Example
`{{$word}}`	Single word	`synergy`
`{{$sentence}}`	Sentence	`The quick service responds promptly.`
`{{$paragraph}}`	Multi-sentence paragraph	(2-4 sentences)
`{{$slug}}`	URL slug	`optimize-deploy-iterate`

Date & Time

Variable	Output	Example
`{{$dateISO}}`	Current ISO date	`2025-06-15T14:30:00.000Z`
`{{$datePast}}`	Random past date (within 1 year)	`2024-11-03T08:15:00.000Z`
`{{$dateFuture}}`	Random future date (within 1 year)	`2026-02-20T19:45:00.000Z`
`{{$time}}`	Time of day	`14:30:00`

Internet

Variable	Output	Example
`{{$url}}`	URL	`https://example.com/optimize-deploy-iterate`
`{{$domain}}`	Domain name	`example.com`
`{{$ipv4}}`	IPv4 address	`192.168.1.42`
`{{$ipv6}}`	IPv6 address	`2001:0db8:85a3:0000:0000:8a2e:0370:7334`
`{{$color}}`	Hex color	`#a3c1f0`
`{{$userAgent}}`	Browser user agent	`Mozilla/5.0 (Windows NT 10.0; ...)`

Parameterized Generators

Some generators accept parameters using colon syntax: {{$generator:arg1:arg2}}.

Variable	Description	Example
`{{$randomInt:min:max}}`	Integer in range	`{{$randomInt:1:100}}` → `42`
`{{$randomFloat:min:max:decimals}}`	Float in range with precision	`{{$randomFloat:0:10:3}}` → `7.234`
`{{$randomString:length}}`	String of custom length	`{{$randomString:8}}` → `kf82mq1x`
`{{$oneOf:option1,option2,...}}`	Pick from comma-separated list	`{{$oneOf:active,inactive,pending}}` → `active`

All parameterized generators work without arguments too, using their defaults.

Array Generation

Use repeat blocks to generate arrays of dynamic data. Wrap content in {{#repeat:N}}...{{/repeat}} to produce N comma-separated copies with fresh values each iteration.

Syntax	Description
`{{#repeat:N}}...{{/repeat}}`	Repeat the enclosed template N times (comma-separated)
`{{$index}}`	0-based iteration index (available inside repeat blocks)

Repeat blocks can be nested for arrays within objects
Maximum of 500 iterations per block

Basic array of objects

{
  "users": [
    {{#repeat:3}}
    {
      "id": "{{$uuid}}",
      "name": "{{$randomName}}",
      "email": "{{$randomEmail}}"
    }
    {{/repeat}}
  ]
}

Nested repeat for arrays within objects

{
  "teams": [
    {{#repeat:2}}
    {
      "teamId": {{$index}},
      "name": "{{$word}}",
      "members": [
        {{#repeat:3}}
        {
          "id": "{{$uuid}}",
          "role": "{{$oneOf:admin,editor,viewer}}"
        }
        {{/repeat}}
      ]
    }
    {{/repeat}}
  ]
}

Request Data

Echo back parts of the incoming request:

Variable	Description
`{{request.method}}`	HTTP method (GET, POST, …)
`{{request.path}}`	Request path
`{{request.header.Name}}`	Header value (case-insensitive)
`{{request.query.key}}`	Query parameter value
`{{request.body}}`	Raw request body
`{{request.body.field}}`	JSON body field (dot notation, e.g. `request.body.user.name`)

Variables

Variable	Description
`{{vars.name}}`	Endpoint-level variable (set by actions)
`{{project.name}}`	Project-level variable
`{{globals.name}}`	Account-level variable

Path Parameters

If your endpoint path has dynamic segments like /users/:id, use {{id}} to echo the captured value:

{
  "userId": "{{id}}",
  "message": "Found user {{id}}"
}

Examples

A user profile endpoint returning realistic fake data:

{
  "id": "{{$uuid}}",
  "firstName": "{{$firstName}}",
  "lastName": "{{$lastName}}",
  "email": "{{$randomEmail}}",
  "phone": "{{$phone}}",
  "username": "{{$username}}",
  "avatar": "{{$avatar}}",
  "address": {
    "street": "{{$street}}",
    "city": "{{$city}}",
    "state": "{{$state}}",
    "zip": "{{$zip}}"
  },
  "createdAt": "{{$datePast}}",
  "active": {{$randomBool}}
}

An endpoint that echoes request data alongside generated values:

{
  "requestId": "{{$uuid}}",
  "method": "{{request.method}}",
  "path": "{{request.path}}",
  "timestamp": "{{$timestamp}}",
  "status": "{{$oneOf:success,pending,failed}}",
  "score": {{$randomFloat:0:100:1}},
  "ip": "{{$ipv4}}"
}

A list endpoint using repeat blocks to return an array of items:

{
  "total": 5,
  "items": [
    {{#repeat:5}}
    {
      "id": {{$index}},
      "uuid": "{{$uuid}}",
      "name": "{{$randomName}}",
      "email": "{{$randomEmail}}",
      "status": "{{$oneOf:active,inactive,pending}}",
      "createdAt": "{{$datePast}}"
    }
    {{/repeat}}
  ]
}