Nth weekday of a month API

Resolves the date of the Nth occurrence of a given weekday in a month (e.g. 3rd Monday), accepting weekday names or 0-6 and erroring when that occurrence doesn't exist. Answers 'When is the 3rd Monday of March 2026?', 'Date of the 2nd Tuesday this month?'.

Price$0.04per request

MethodPOST

Route/v1/datetime/nth-weekday-of-month

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

datetimerecurrencenth-weekdayweekdaymonthlycalendarthird-mondayschedule

API URLhttps://x402.hexl.dev/v1/datetime/nth-weekday-of-month

Integration docs

Example request

{
  "year": 2026,
  "month": 3,
  "weekday": "Monday",
  "n": 3
}

Example response

{
  "year": 2026,
  "month": 3,
  "weekday": "Monday",
  "n": 3,
  "date": "2026-03-16",
  "interpretation": "The third Monday of 2026-03 is 2026-03-16."
}

Input schema

{
  "type": "object",
  "required": [
    "year",
    "month",
    "weekday",
    "n"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "examples": [
        2026
      ]
    },
    "month": {
      "type": "integer",
      "examples": [
        3
      ]
    },
    "weekday": {
      "type": [
        "string",
        "integer"
      ],
      "examples": [
        "Monday"
      ]
    },
    "n": {
      "type": "integer",
      "examples": [
        3
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}