Skip to content
Tools.Town
290+ free online tools

Epoch Converter API

Paste a Unix timestamp (epoch) and get UTC plus local date — or pick a date and get seconds, milliseconds, microseconds, or nanoseconds back. 10, 13, 16, and 19-digit values are auto-detected.

Category: Date & Time Endpoint: /v1/date/epoch Method: GET Auth: API Key

Fast & Accurate

Get precise results instantly.

Easy Integration

Simple REST API with JSON response.

Developer Friendly

Clear docs and SDK examples.

Free to Start

5,000 free requests/month.

Endpoint

All requests should be made to the following endpoint:

GEThttps://api.tools.town/v1/date/epoch

Authentication

This endpoint requires an API Key. Include your API key in the request header.

Authorization: Bearer YOUR_API_KEY
You can get your API key from your dashboard.

Request Parameters

Send a GET request with query parameters.

ParameterTypeRequiredDescriptionExample
modestringConversion mode: epoch-to-date or date-to-epoch.epoch-to-date
epochnumberUnix timestamp in seconds (or ms when 13 digits).1704067200

Example Request

curl -G "https://api.tools.town/v1/date/epoch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "mode=epoch-to-date" \
  --data-urlencode "epoch=1704067200"

Example Response 200 OK

application/json
{
  "success": true,
  "data": {
    "seconds": "0",
    "milliseconds": "0",
    "iso": "string",
    "local": "string",
    "relative": "string"
  }
}

Error Codes

CodeMeaning
400Bad Request — missing or invalid parameter
401Unauthorized — API key missing or invalid
429Rate limit exceeded — free tier: 5,000 requests/month
500Internal Server Error — try again or contact support