find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/calcbright-com:calcbright-com-datetime-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: CalcBright Calculator Date Time API
  version: 1.0.0
  description: 'Free, keyless JSON API for 167 calculators and converters. Every response includes a human-readable summary and a link to the full calculation on calcbright.com. MCP endpoint: https://calcbright.com/mcp'
  contact:
    email: contact@calcbright.com
    url: https://calcbright.com/developers
servers:
- url: https://calcbright.com
tags:
- name: DateTime
paths:
  /api/calc/age-calculator:
    get:
      operationId: ageCalculator
      summary: Age Calculator
      description: Your exact age in years, months and days from your date of birth, plus total weeks and days, the weekday you were born and how long until your next birthday.
      tags:
      - DateTime
      parameters:
      - name: birth
        in: query
        required: false
        schema:
          type: string
          format: date
          description: Date of birth (YYYY-MM-DD)
          default: '1990-01-01'
      - name: asOf
        in: query
        required: false
        schema:
          type: string
          format: date
          description: Age on date Leave empty to use today's date. (YYYY-MM-DD)
      responses:
        '200':
          description: Calculation result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CalcOutput'
        '400':
          description: Invalid input (see errors)
  /api/calc/time-zone-converter:
    get:
      operationId: timeZoneConverter
      summary: Time Zone Converter
      description: 9:00 AM in New York is 2:00 PM in London in summer. Convert any date and time between two cities with daylight saving applied for that date, plus a world clock.
      tags:
      - DateTime
      parameters:
      - name: when
        in: query
        required: false
        schema:
          type: string
          description: Date & time Leave empty to use the current time. (YYYY-MM-DDTHH:MM)
      - name: from
        in: query
        required: false
        schema:
          type: string
          description: From
          enum:
          - Pacific/Honolulu
          - America/Anchorage
          - America/Los_Angeles
          - America/Denver
          - America/Phoenix
          - America/Chicago
          - America/New_York
          - America/Toronto
          - America/Mexico_City
          - America/Bogota
          - America/Sao_Paulo
          - America/Argentina/Buenos_Aires
          - UTC
          - Europe/London
          - Europe/Dublin
          - Europe/Lisbon
          - Europe/Paris
          - Europe/Berlin
          - Europe/Madrid
          - Europe/Rome
          - Europe/Amsterdam
          - Europe/Stockholm
          - Europe/Athens
          - Europe/Istanbul
          - Europe/Moscow
          - Africa/Cairo
          - Africa/Lagos
          - Africa/Johannesburg
          - Africa/Nairobi
          - Asia/Riyadh
          - Asia/Dubai
          - Asia/Tehran
          - Asia/Karachi
          - Asia/Kolkata
          - Asia/Kathmandu
          - Asia/Dhaka
          - Asia/Bangkok
          - Asia/Jakarta
          - Asia/Singapore
          - Asia/Hong_Kong
          - Asia/Shanghai
          - Asia/Manila
          - Asia/Seoul
          - Asia/Tokyo
          - Australia/Perth
          - Australia/Adelaide
          - Australia/Sydney
          - Pacific/Auckland
          default: America/New_York
      - name: to
        in: query
        required: false
        schema:
          type: string
          description: To
          enum:
          - Pacific/Honolulu
          - America/Anchorage
          - America/Los_Angeles
          - America/Denver
          - America/Phoenix
          - America/Chicago
          - America/New_York
          - America/Toronto
          - America/Mexico_City
          - America/Bogota
          - America/Sao_Paulo
          - America/Argentina/Buenos_Aires
          - UTC
          - Europe/London
          - Europe/Dublin
          - Europe/Lisbon
          - Europe/Paris
          - Europe/Berlin
          - Europe/Madrid
          - Europe/Rome
          - Europe/Amsterdam
          - Europe/Stockholm
          - Europe/Athens
          - Europe/Istanbul
          - Europe/Moscow
          - Africa/Cairo
          - Africa/Lagos
          - Africa/Johannesburg
          - Africa/Nairobi
          - Asia/Riyadh
          - Asia/Dubai
          - Asia/Tehran
          - Asia/Karachi
          - Asia/Kolkata
          - Asia/Kathmandu
          - Asia/Dhaka
          - Asia/Bangkok
          - Asia/Jakarta
          - Asia/Singapore
          - Asia/Hong_Kong
          - Asia/Shanghai
          - Asia/Manila
          - Asia/Seoul
          - Asia/Tokyo
          - Australia/Perth
          - Australia/Adelaide
          - Australia/Sydney
          - Pacific/Auckland
          default: Europe/London
      responses:
        '200':
          description: Calculation result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CalcOutput'
        '400':
          description: Invalid input (see errors)
  /api/calc/business-days-calculator:
    get:
      operationId: businessDaysCalculator
      summary: Business Days Calculator
      description: Count Monday–Friday working days between two dates (January 2026 has 22), or add business days to a start date to find a shipping or contract deadline.
      tags:
      - DateTime
      parameters:
      - name: mode
        in: query
        required: false
        schema:
          type: string
          description: What do you want to do?
          enum:
          - count
          - add
          default: count
      - name: start
        in: query
        required: false
        schema:
          type: string
          format: date
          description: Start date (YYYY-MM-DD)
          default: '2026-01-01'
      - name: end
        in: query
        required: false
        schema:
          type: string
          format: date
          description: End date (YYYY-MM-DD)
          default: '2026-01-31'
      - name: days
        in: query
        required: false
        schema:
          type: number
          description: Business days to add Use a negative number to go back in time.
          minimum: -10000
          maximum: 10000
          default: 10
      responses:
        '200':
          description: Calculation result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CalcOutput'
        '400':
          description: Invalid input (see errors)
  /api/calc/countdown-calculator:
    get:
      operationId: countdownCalculator
      summary: Countdown Calculator
      description: How many days until Christmas, New Year or your own date? See the days, weeks, months and hours left – or the days since a date that has already passed.
      tags:
      - DateTime
      parameters:
      - name: preset
        in: query
        required: false
        schema:
          type: string
          description: Count down to
          enum:
          - christmas
          - newyear
          - valentines
          - july4
          - halloween
          - newyearseve
          - custom
          default: christmas
      - name: target
        in: query
        required: false
        schema:
          type: string
          format: date
          description: Target date (YYYY-MM-DD)
          default: '2027-01-01'
      - name: label
        in: query
        required: false
        schema:
          type: string
          description: Event name (optional)
          maxLength: 40
      - name: from
        in: query
        required: false
        schema:
          type: string
          format: date
          description: Count from Leave empty to count from today. (YYYY-MM-DD)
      responses:
        '200':
          description: Calculation result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CalcOutput'
        '400':
          description: Invalid input (see errors)
  /api/calc/date-calculator:
    get:
      operationId: dateCalculator
      summary: Date Calculator
      description: Add or subtract days, weeks, months or years from any date to get the exact date and weekday – like 90 days from today. Leap years and month ends handled.
      tags:
      - DateTime
      parameters:
      - name: start
        in: query
        required: false
        schema:
          type: string
          format: date
          description: Start date Leave empty to start from today. (YYYY-MM-DD)
      - name: op
        in: query
        required: false
        schema:
          type: string
          description: Operation
          enum:
          - add
          - subtract
          default: add
      - name: years
        in: query
        required: false
        schema:
          type: number
          description: Years
          minimum: 0
          maximum: 100000
          default: 0
      - name: months
        in: query
        required: false
        schema:
          type: number
          description: Months
          minimum: 0
          maximum: 100000
          default: 0
      - name: weeks
        in: query
        required: false
        schema:
          type: number
          description: Weeks
          minimum: 0
          maximum: 100000
          default: 0
      - name: days
        in: query
        required: false
        schema:
          type: number
          description: Days
          minimum: 0
          maximum: 100000
          default: 90
      responses:
        '200':
          description: Calculation result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CalcOutput'
        '400':
          description: Invalid input (see errors)
  /api/calc/date-difference-calculator:
    get:
      operationId: dateDifferenceCalculator
      summary: Date Difference Calculator
      description: Days between two dates, also shown in weeks, months and years, with weekday and weekend counts. Choose whether to include the end date for event lengths.
      tags:
      - DateTime
      parameters:
      - name: start
        in: query
        required: false
        schema:
          type: string
          format: date
          description: Start date (YYYY-MM-DD)
          default: '2026-01-01'
      - name: end
        in: query
        required: false
        schema:
          type: string
          format: date
          description: End date Leave empty to use today's date. (YYYY-MM-DD)
      - name: includeEnd
        in: query
        required: false
        schema:
          type: string
          description: Include the end date?
          enum:
          - 'no'
          - 'yes'
          default: 'no'
      responses:
        '200':
          description: Calculation result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CalcOutput'
        '400':
          description: Invalid input (see errors)
  /api/calc/day-of-week-calculator:
    get:
      operationId: dayOfWeekCalculator
      summary: Day of the Week Calculator
      description: What day of the week was it? Get the weekday for any date from 1000 to 9999 – birthdays, historic events, future plans – with Zeller’s working shown.
      tags:
      - DateTime
      parameters:
      - name: date
        in: query
        required: false
        schema:
          type: string
          format: date
          description: Date Leave empty to use today's date. (YYYY-MM-DD)
          default: '1969-07-20'
      responses:
        '200':
          description: Calculation result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CalcOutput'
        '400':
          description: Invalid input (see errors)
  /api/calc/hijri-date-converter:
    get:
      operationId: hijriDateConverter
      summary: Hijri Date Converter
      description: 1 Ramadan 1448 AH is Monday, 8 February 2027. Convert dates Hijri ↔ Gregorian on Saudi Arabia’s official Umm al-Qura calendar, with the weekday and Eid dates.
      tags:
      - DateTime
      parameters:
      - name: mode
        in: query
        required: false
        schema:
          type: string
          description: Convert
          enum:
          - g2h
          - h2g
          default: g2h
      - name: gdate
        in: query
        required: false
        schema:
          type: string
          format: date
          description: Gregorian date Years 1902–2076 (Umm al-Qura calendar). (YYYY-MM-DD)
          default: '2026-10-11'
      - name: hd
        in: query
        required: false
        schema:
          type: number
          description: Hijri day
          minimum: 1
          maximum: 30
          default: 1
      - name: hm
        in: query
        required: false
        schema:
          type: string
          description: Hijri month
          enum:
          - '1'
          - '2'
          - '3'
          - '4'
          - '5'
          - '6'
          - '7'
          - '8'
          - '9'
          - '10'
          - '11'
          - '12'
          default: '9'
      - name: hy
        in: query
        required: false
        schema:
          type: number
          description: Hijri year (AH)
          minimum: 1320
          maximum: 1499
          default: 1448
      responses:
        '200':
          description: Calculation result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CalcOutput'
        '400':
          description: Invalid input (see errors)
  /api/calc/hours-calculator:
    get:
      operationId: hoursCalculator
      summary: Hours Calculator
      description: 'An hours calculator laid out as a weekly time card: start, end and unpaid break per day, totalled as h:mm and decimal hours, with hours over 40 flagged.'
      tags:
      - DateTime
      parameters:
      - name: monStart
        in: query
        required: false
        schema:
          type: string
          description: Monday start (HH:MM, 24-hour)
          default: 09:00
      - name: monEnd
        in: query
        required: false
        schema:
          type: string
          description: End (HH:MM, 24-hour)
          default: '17:30'
      - name: monBreak
        in: query
        required: false
        schema:
          type: number
          description: Break (min)
          minimum: 0
          maximum: 1440
          default: 30
      - name: tueStart
        in: query
        required: false
        schema:
          type: string
          description: Tuesday start (HH:MM, 24-hour)
          default: 09:00
      - name: tueEnd
        in: query
        required: false
        schema:
          type: string
          description: End (HH:MM, 24-hour)
          default: '17:30'
      - name: tueBreak
        in: query
        required: false
        schema:
          type: number
          description: Break (min)
          minimum: 0
          maximum: 1440
          default: 30
      - name: wedStart
        in: query
        required: false
        schema:
          type: string
          description: Wednesday start (HH:MM, 24-hour)
          default: 09:00
      - name: wedEnd
        in: query
        required: false
        schema:
          type: string
          description: End (HH:MM, 24-hour)
          default: '17:30'
      - name: wedBreak
        in: query
        required: false
        schema:
          type: number
          description: Break (min)
          minimum: 0
          maximum: 1440
          default: 30
      - name: thuStart
        in: query
        required: false
        schema:
          type: string
          description: Thursday start (HH:MM, 24-hour)
          default: 09:00
      - name: thuEnd
        in: query
        required: false
        schema:
          type: string
          description: End (HH:MM, 24-hour)
          default: '17:30'
      - name: thuBreak
        in: query
        required: false
        schema:
          type: number
          description: Break (min)
          minimum: 0
          maximum: 1440
          default: 30
      - name: friStart
        in: query
        required: false
        schema:
          type: string
          description: Friday start (HH:MM, 24-hour)
          default: 09:00
      - name: friEnd
        in: query
        required: false
        schema:
          type: string
          description: End (HH:MM, 24-hour)
          default: '17:30'
      - name: friBreak
        in: query
        required: false
        schema:
          type: number
          description: Break (min)
          minimum: 0
          maximum: 1440
          default: 30
      - name: satStart
        in: query
        required: false
        schema:
          type: string
          description: Saturday start (HH:MM, 24-hour)
      - name: satEnd
        in: query
        required: false
        schema:
          type: string
          description: End (HH:MM, 24-hour)
      - name: satBreak
        in: query
        required: false
        schema:
          type: number
          description: Break (min)
          minimum: 0
          maximum: 1440
      - name: sunStart
        in: query
        required: false
        schema:
          type: string
          description: Sunday start (HH:MM, 24-hour)
      - name: sunEnd
        in: query
        required: false
        schema:
          type: string
          description: End (HH:MM, 24-hour)
      - name: sunBreak
        in: query
        required: false
        schema:
          type: number
          description: Break (min)
          minimum: 0
          maximum: 1440
      - name: rate
        in: query
        required: false
        schema:
          type: number
          description: Hourly rate (optional)
          minimum: 0
          maximum: 100000
          default: 20
      - name: currency
        in: query
        required: false
        schema:
          type: string
          description: Currency
          enum:
          - USD
          - EUR
          - GBP
          - JPY
          - CAD
          - AUD
          - CHF
          - CNY
          - INR
          - PKR
          - AED
          - SAR
          - NZD
          - SGD
          - HKD
          - SEK
          - NOK
          - DKK
          - PLN
          - TRY
          - ZAR
          - BRL
          - MXN
          - KRW
          - THB
          - MYR
          - IDR
          - PHP
          - BDT
          - EGP
          - NGN
          - KWD
          - QAR
          - BHD
          - OMR
          - RUB
          default: USD
      responses:
        '200':
          description: Calculation result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CalcOutput'
        '400':
          description: Invalid input (see errors)
  /api/calc/ramadan-countdown-calculator:
    get:
      operationId: ramadanCountdownCalculator
      summary: Ramadan Countdown
      description: Ramadan 2027 (1448 AH) is expected on Monday 8 February on the Umm al-Qura calendar. Live count of the days to Ramadan, Eid al-Fitr and Eid al-Adha.
      tags:
      - DateTime
      parameters:
      - name: event
        in: query
        required: false
        schema:
          type: string
          description: Count down to
          enum:
          - ramadan
          - fitr
          - arafah
          - adha
          - newyear
          - mawlid
          default: ramadan
      - name: from
        in: query
        required: false
        schema:
          type: string
          format: date
          description: From date Leave empty to count from today. (YYYY-MM-DD)
      responses:
        '200':
          description: Calculation result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CalcOutput'
        '400':
          description: Invalid input (see errors)
  /api/calc/time-duration-calculator:
    get:
      operationId: timeDurationCalculator
      summary: Time Duration Calculator
      description: 9:15 AM to 5:45 PM is 8 h 30 min, or 8.5 hours. Get the time between any two clock times, overnight shifts included, in hours and minutes, decimal and minutes.
      tags:
      - DateTime
      parameters:
      - name: start
        in: query
        required: false
        schema:
          type: string
          description: Start time (HH:MM, 24-hour)
          default: 09:15
      - name: end
        in: query
        required: false
        schema:
          type: string
          description: End time An end time earlier than the start is treated as the next day. (HH:MM, 24-hour)
          default: '17:45'
      responses:
        '200':
          description: Calculation result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CalcOutput'
        '400':
          description: Invalid input (see errors)
  /api/calc/time-to-decimal-converter:
    get:
      operationId: timeToDecimalConverter
      summary: Time to Decimal Converter
      description: 2 h 45 min is 2.75 hours, not 2.45. Turn hours, minutes and seconds into decimal hours for timesheets and payroll, or turn 7.8 h back into 7 h 48 min.
      tags:
      - DateTime
      parameters:
      - name: mode
        in: query
        required: false
        schema:
          type: string
          description: Convert
          enum:
          - toDecimal
          - toHms
          default: toDecimal
      - name: hours
        in: query
        required: false
        schema:
          type: number
          description: Hours
          minimum: 0
          maximum: 1000000
          default: 2
      - name: minutes
        in: query
        required: false
        schema:
          type: number
          description: Minutes
          minimum: 0
          maximum: 59
          default: 45
      - name: seconds
        in: query
        required: false
        schema:
          type: number
          description: Seconds
          minimum: 0
          maximum: 59.999
          default: 0
      - name: decimal
        in: query
        required: false
        schema:
          type: number
          description: Decimal hours (h)
          minimum: 0
          maximum: 1000000
          default: 7.8
      responses:
        '200':
          description: Calculation result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CalcOutput'
        '400':
          description: Invalid input (see errors)
  /api/calc/unix-timestamp-converter:
    get:
      operationId: unixTimestampConverter
      summary: Unix Timestamp Converter
      description: 1700000000 is 2023-11-14T22:13:20Z. Paste an epoch value in seconds or milliseconds to get a readable UTC and ISO 8601 date, or turn a date into a timestamp.
      tags:
      - DateTime
      parameters:
      - name: mode
        in: query
        required: false
        schema:
          type: string
          description: Convert
          enum:
          - toDate
          - toTs
          default: toDate
      - name: ts
        in: query
        required: false
        schema:
          type: number
          description: Unix timestamp Seconds or milliseconds – detected automatically. Empty = now.
          minimum: -8640000000000000
          maximum: 8640000000000000
      - name: dt
        in: query
        required: false
        schema:
          type: string
          description: Date and time (UTC) Empty = now. (YYYY-MM-DDTHH:MM)
      responses:
        '200':
          description: Calculation result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CalcOutput'
        '400':
          description: Invalid input (see errors)
  /api/calc/week-number-calculator:
    get:
      operationId: weekNumberCalculator
      summary: Week Number Calculator
      description: January 1, 2026 is in ISO week 1, which began on December 29, 2025. Get the week number of any date, its Monday and Sunday, the day of the year and days left.
      tags:
      - DateTime
      parameters:
      - name: date
        in: query
        required: false
        schema:
          type: string
          format: date
          description: Date Leave empty to use today's date. (YYYY-MM-DD)
      responses:
        '200':
          description: Calculation result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CalcOutput'
        '400':
          description: Invalid input (see errors)
components:
  schemas:
    CalcOutput:
      type: object
      properties:
        ok:
          type: boolean
        tool:
          type: string
        name:
          type: string
        url:
          type: string
          description: Open this link to see the full calculation
        inputs:
          type: object
        summary:
          type: string
          description: Plain-text answer
        details:
          type: string
        result:
          type: object
        errors:
          type: object
          additionalProperties:
            type: string