Unix Timestamp Converter API Reference
Convert Unix epoch timestamps (seconds or milliseconds since 1970-01-01T00:00:00Z) to ISO 8601, UTC, and local date-time strings — or parse any date string back to a Unix timestamp. Shows the relative time from now (e.g. '3 days ago'). Accepts seconds, milliseconds, or an ISO 8601 / RFC 2822 date string as input.
Endpoint
/api/timestamp-converterFull URL: https://quickhelp.dev/api/timestamp-converter
Request
Content-Type: application/json. No authentication required for the anonymous free tier (30 req/min per IP).
| Field | Type | Required | Description |
|---|---|---|---|
| input | string | Yes | A Unix timestamp in seconds or milliseconds (e.g. 1716998400 or 1716998400000), or a date string in ISO 8601 or RFC 2822 format (e.g. '2024-05-29T12:00:00Z' or 'Wed, 29 May 2024 12:00:00 +0000') |
| mode | default | No | auto — detects whether the input is a timestamp or a date string; to-date — treat input as a Unix timestamp and convert to date strings; to-timestamp — parse input as a date string and return epoch seconds and milliseconds |
Response
Returns application/json. On error, returns a JSON object with an error string field and an appropriate HTTP status code.
| Field | Type | Description |
|---|---|---|
| unix_seconds | number | Unix timestamp in seconds |
| unix_ms | number | Unix timestamp in milliseconds |
| iso8601 | string | ISO 8601 UTC string (e.g. 2024-05-29T12:00:00.000Z) |
| utc | string | Human-readable UTC string (e.g. Wed, 29 May 2024 12:00:00 UTC) |
| relative | string | Relative time from now (e.g. '3 days ago', 'in 2 hours') |
| valid | boolean | — |
| error | optional | — |
Example
Unix seconds to date
curl
curl -X POST https://quickhelp.dev/api/timestamp-converter \
-H 'Content-Type: application/json' \
-d '{"input":"1716998400","mode":"to-date"}'Request body
{
"input": "1716998400",
"mode": "to-date"
}Response
{
"unix_seconds": 1716998400,
"unix_ms": 1716998400000,
"iso8601": "2024-05-29T16:00:00.000Z",
"utc": "Wed, 29 May 2024 16:00:00 UTC",
"relative": "about 1 year ago",
"valid": true
}Error codes
| Status | Meaning |
|---|---|
| 200 | Success — result in response body |
| 400 | Bad request — invalid input; error field describes the problem |
| 404 | Tool not found |
| 429 | Rate limit exceeded (30 req/min anonymous, 300 req/min free key) |
| 500 | Internal server error — transient; retry with exponential back-off |
OpenAPI spec
The full OpenAPI 3.1 specification for all tools is available at /openapi.json. Import it into Postman, Insomnia, or any OpenAPI-compatible client to get all endpoints with schema validation automatically.