> For the complete documentation index, see [llms.txt](/llms.txt).
[miniwebtool /api](/)
[tools](/tools/) [docs](/docs/) [reference](/v1/docs) [pricing](/#pricing) [log in](/dashboard/login/) [get free key →](/billing/checkout/?plan=free)
- [~](/)
- /
- [tools](/tools/)
- /
- [random](/tools/#random)
- /
- Random Date Generator API

# Random Date Generator API

random 1 credit / call v2026-04-22
Generate random dates inside a bounded date range.
One POST adds Random Date Generator to your app, site, workflow, or agent — formula, validation, edge cases, and docs already handled.
prefer a UI? [Open the Random Date Generator on miniwebtool.com →](https://miniwebtool.com/random-date-generator/)
[Start free — get a key →](/billing/checkout/?plan=free) 1,000 credits · no card · 30 seconds

### Endpoint

POST · 1cr

```text
POST https://api.miniwebtool.com/v1/tools/random-date-generator/run
```

### Request body

Field
Type
Req.
`start_date`
`date`
✓
`end_date`
`date`
✓
`count`
`int`
—
`output_format`
iso | us | eu | long | short | unix
`str`
—
`exclude_weekends`
`bool`
—
`sort_results`
`bool`
—
`seed`
`int | None`
—

### Cost & access

- 1 credit per successful call — failed calls refund.
- Starts on: Free.
- Max payload:`65536`bytes.
- Privacy mode:`hash_only`
- Available on: free, starter, pro, business, scale

### Response envelope

```text
{
  "request_id": "01K...",
  "tool": "random-date-generator",
  "tool_version": "2026-04-22",
  "credits_used": 1,
  "result": {... }
}
```

### Try it

API key *
Stored only in this browser tab. Playground test key is prefilled and only works on this page. [Get a live key →](/billing/checkout/?plan=free)
start_date (date) * 2026-01-01
end_date (date) * 2026-12-31
count (int)
output_format (str) iso us eu long short unix
iso | us | eu | long | short | unix
exclude_weekends (bool) false true
sort_results (bool) false true
seed (int | None)
Send request →
Response copy body
This endpoint starts on Free
Your key is valid, but its current plan cannot call`random-date-generator`. Upgrade to Free or higher to run this tool.
[Start Free →](/billing/checkout/?plan=free) [Compare plans](/#pricing)

```text

```

Response headers

```text

```

### Code examples

cURL Python JavaScript PHP Ruby Go Java
copy

```text
curl -X POST https://api.miniwebtool.com/v1/tools/random-date-generator/run \
  -H 'Authorization: Bearer mwt_live_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"start_date":"2026-01-01","end_date":"2026-12-31","count":5,"output_format":"iso"}'
```

copy

```text
import requests

resp = requests.post(
    'https://api.miniwebtool.com/v1/tools/random-date-generator/run',
    headers={'Authorization': 'Bearer mwt_live_YOUR_KEY'},
    json={'start_date': '2026-01-01', 'end_date': '2026-12-31', 'count': 5, 'output_format': 'iso'},
)
resp.raise_for_status()
print(resp.json())
```

copy

```text
const resp = await fetch(
  'https://api.miniwebtool.com/v1/tools/random-date-generator/run',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer mwt_live_YOUR_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({"start_date":"2026-01-01","end_date":"2026-12-31","count":5,"output_format":"iso"}),
  }
);
const data = await resp.json();
console.log(data);
```

copy

```text
<?php
$ch = curl_init('https://api.miniwebtool.com/v1/tools/random-date-generator/run');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mwt_live_YOUR_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
    'start_date' => '2026-01-01',
    'end_date' => '2026-12-31',
    'count' => 5,
    'output_format' => 'iso'
]),
]);
$resp = curl_exec($ch);
curl_close($ch);
print_r(json_decode($resp, true));
```

copy

```text
require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.miniwebtool.com/v1/tools/random-date-generator/run')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = (uri.scheme == 'https')

req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer mwt_live_YOUR_KEY'
req['Content-Type'] = 'application/json'
req.body = {
  'start_date' => '2026-01-01',
  'end_date' => '2026-12-31',
  'count' => 5,
  'output_format' => 'iso'
}.to_json

resp = http.request(req)
puts JSON.parse(resp.body).inspect
```

copy

```text
package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "io"
  "net/http"
)

func main() {
  body, _:= json.Marshal(map[string]interface{}{
    "start_date": "2026-01-01",
    "end_date": "2026-12-31",
    "count": 5,
    "output_format": "iso",
  })
  req, _:= http.NewRequest("POST", "https://api.miniwebtool.com/v1/tools/random-date-generator/run", bytes.NewReader(body))
  req.Header.Set("Authorization", "Bearer mwt_live_YOUR_KEY")
  req.Header.Set("Content-Type", "application/json")

  resp, err:= http.DefaultClient.Do(req)
  if err!= nil { panic(err) }
  defer resp.Body.Close()
  out, _:= io.ReadAll(resp.Body)
  fmt.Println(string(out))
}
```

copy

```text
import java.net.URI;
import java.net.http.*;

var client = HttpClient.newHttpClient();
var req = HttpRequest.newBuilder()
.uri(URI.create("https://api.miniwebtool.com/v1/tools/random-date-generator/run"))
.header("Authorization", "Bearer mwt_live_YOUR_KEY")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString("{\"start_date\":\"2026-01-01\",\"end_date\":\"2026-12-31\",\"count\":5,\"output_format\":\"iso\"}"))
.build();

var resp = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());
```

how-to call random-date-generator
- Get an API key
[Get an API key](/billing/checkout/?plan=free). Sign up free for a bearer token. 1,000 credits/month, no card.
- Assemble the JSON body
Required fields:`start_date`,`end_date`,. See the Request body table above for the full schema.
- POST to`https://api.miniwebtool.com/v1/tools/random-date-generator/run`
Headers:`Authorization: Bearer <key>`and`Content-Type: application/json`. Copy-paste snippets in 7 languages are under Code examples.
- Parse the response
Envelope:`{request_id, tool, tool_version, credits_used, result}`. The typed output lives in`result`.
faq frequently asked
What does the Random Date Generator API do? +
Generate random dates inside a bounded date range. Use it to add this utility without rebuilding formulas, validation, examples, and documentation.
How much does one call to Random Date Generator cost? +
1 credit per successful call. Failed calls (validation errors, 5xx) don't bill.
What parameters does the Random Date Generator API require? +
Required fields: start_date, end_date. Full schema at /v1/openapi.json.
Is the Random Date Generator API deterministic? +
This tool's output may vary (e.g. random generation). Version: 2026-04-22.
Can an AI agent call the Random Date Generator API? +
Yes. Connect to https://api.miniwebtool.com/v1/mcp over the Model Context Protocol. The agent discovers `random-date-generator` with its JSON Schema automatically, so the model can plan while MiniWebtool handles the exact tool result.
What format does the API return? +
JSON with a stable envelope: `{request_id, tool, tool_version, credits_used, result}`. Errors are RFC 7807 `application/problem+json`.
mcp use from an AI agent
Every endpoint on this site is also exposed via the [Model Context Protocol](/docs/#mcp) at`https://api.miniwebtool.com/v1/mcp`. Claude, Cursor, and any MCP-capable agent can discover this tool (`random-date-generator`) and its JSON Schema automatically — no client codegen.

```text
# List tools the agent can call
curl -s https://api.miniwebtool.com/v1/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
 | jq '.result.tools[] | select(.name=="random-date-generator")'
```

see-also related random tools
[
Random Color Generator
Generate random HEX, RGB, and HSL colors with optional harmony rules.
](/tools/random-color-generator/) [
Random Port Number Generator
Generate random network port numbers in standard or custom ranges.
](/tools/random-port-number-generator/) [
Random Integer Generator
Generate random integers with optional uniqueness, sorting, exclusions, and see…
](/tools/random-integer-generator/) [
Random Decimal Number Generator
Generate random decimal numbers between 0 and 1 with configurable precision.
](/tools/random-decimal-number-generator/)
API OPERATIONAL v1 · OpenAPI 3.1 · MCP 2025-06-18
[terms](https://miniwebtool.com/about/terms-and-disclaimer/#api-terms) [privacy](https://miniwebtool.com/about/privacy/#api-privacy) [llms.txt](/llms.txt) [consumer site →](https://miniwebtool.com) © 2026 miniwebtool
