Date Calculator API

Overview

To use Date Calculator, you need an API key. You can get one by creating a free account and visiting your dashboard.

GET Endpoint

https://api.apiverve.com/v1/datecalculator

Example

How to call the Date Calculator API in different programming languages.

curl -X GET \
  "https://api.apiverve.com/v1/datecalculator?start=2022-01-01&end=2024-08-31" \
  -H "X-API-Key: your_api_key_here"

const response = await fetch('https://api.apiverve.com/v1/datecalculator?start=2022-01-01&end=2024-08-31', {
  method: 'GET',
  headers: {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

import requests

headers = {
    'X-API-Key': 'your_api_key_here',
    'Content-Type': 'application/json'
}

response = requests.get('https://api.apiverve.com/v1/datecalculator?start=2022-01-01&end=2024-08-31', headers=headers)

data = response.json()
print(data)

package main

import (
    "fmt"
    "io"
    "net/http"

)

func main() {
    req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/datecalculator?start=2022-01-01&end=2024-08-31", nil)

    req.Header.Set("X-API-Key", "your_api_key_here")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

{
  "status": "ok",
  "error": null,
  "data": {
    "minutes": 524160,
    "hours": 8736,
    "days": 364,
    "weeks": 52,
    "months": 11,
    "years": 0,
    "start": {
      "date": "2022-01-01",
      "day": "Saturday",
      "month": "January",
      "year": "2022",
      "words": "Saturday, January 1st 2022"
    },
    "end": {
      "date": "2022-12-31",
      "day": "Saturday",
      "month": "December",
      "year": "2022",
      "words": "Saturday, December 31st 2022"
    }
  }
}

Authentication

The Date Calculator API requires authentication via API key. Include your API key in the request header:

X-API-Key: your_api_key_here

Learn more about authentication →

Interactive API Playground

Test the Date Calculator API directly in your browser with live requests and responses.

Parameters

The following parameters are available for the Date Calculator API:

Response

The Date Calculator API returns responses in JSON, XML, YAML, and CSV formats. The JSON response is shown in the Example section above; alternative formats below.

Other Response Formats

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>ok</status>
  <error xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
  <data>
    <minutes>524160</minutes>
    <hours>8736</hours>
    <days>364</days>
    <weeks>52</weeks>
    <months>11</months>
    <years>0</years>
    <start>
      <date>2022-01-01</date>
      <day>Saturday</day>
      <month>January</month>
      <year>2022</year>
      <words>Saturday, January 1st 2022</words>
    </start>
    <end>
      <date>2022-12-31</date>
      <day>Saturday</day>
      <month>December</month>
      <year>2022</year>
      <words>Saturday, December 31st 2022</words>
    </end>
  </data>
</response>

status: ok
error: null
data:
  minutes: 524160
  hours: 8736
  days: 364
  weeks: 52
  months: 11
  years: 0
  start:
    date: '2022-01-01'
    day: Saturday
    month: January
    year: '2022'
    words: Saturday, January 1st 2022
  end:
    date: '2022-12-31'
    day: Saturday
    month: December
    year: '2022'
    words: Saturday, December 31st 2022

Response Structure

All API responses follow a consistent structure with the following fields:

Learn more about response formats →

Response Data Fields

When the request is successful, the data object contains the following fields:

Headers

Only X-API-Key is required. Optional headers include Accept for response format negotiation (JSON, XML, or YAML), User-Agent, and X-Request-ID for request tracing. See all request headers →

GraphQL AccessALPHA

Access Date Calculator through GraphQL to combine it with other API calls in a single request. Query only the date calculator data you need with precise field selection, and orchestrate complex data fetching workflows.

Credit Cost: Each API called in your GraphQL query consumes its standard credit cost.

POST https://api.apiverve.com/v1/graphql

query {
  datecalculator(
    input: {
      start: "2022-01-01"
      end: "2024-08-31"
    }
  ) {
    minutes
    hours
    days
    weeks
    months
    years
    start {
      date
      day
      month
      year
      words
    }
    end {
      date
      day
      month
      year
      words
    }
  }
}

Note: Authentication is handled via the x-api-key header in your GraphQL request, not as a query parameter.

CORS Support

The Date Calculator API accepts cross-origin requests from any origin, so it can be called directly from browser-based applications without a proxy. See CORS support →

Rate Limiting

Date Calculator requests are throttled per minute on the Free plan and unthrottled on paid plans. Exceeding the limit returns 429 Too Many Requests; rate-limit usage is reported in the X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset response headers. See per-plan limits and best practices →

Error Codes

The Date Calculator API uses standard HTTP status codes — 200 on success, 400 for invalid parameters, 401 for missing or invalid keys, 403 for insufficient credits, 429 for rate-limit exhaustion, and 500/503 for server-side issues. Each error response includes an X-Request-ID header you can quote when contacting support. See full error handling guide →

SDKs for Date Calculator

Official Date Calculator packages on npm, PyPI, NuGet, and JitPack — plus a Postman collection and an OpenAPI spec. See the SDK guide →

JitPack

No-Code Integrations

Date Calculator works with Zapier, Make, Pipedream, n8n, and Power Automate using the same API key. See setup guides →

Zapier

Make

Pipedream

n8n

Power Automate

Frequently Asked Questions

People who used this also used...

Based on your interest in Date Calculator, you might also like these APIs:

World Holidays

World Holidays is a simple tool for getting the holidays of the world. It returns the holidays of the world for each day of the year.

1 credit per call

Working Days

Working Days is a simple tool for getting the number of working days in a month. It returns the number of working days in the given month.

1 credit per call

Liturgical Calendar

Liturgical Calendar is a simple tool for getting the dates of the Liturgical Calendar. It returns the dates of the Liturgical Calendar for a given year.

1 credit per call