Api Endpoint

Holiday Calendar API

Business-day count excluding weekends and full-day Public or Bank holidays; Optional and HalfDay observances remain business days.

Open interactive test console

Offering

Provider: holidays.use.x402atlas.com
Method: GET
Offering type: Api Endpoint
Transport type: http
Category: General Utilities
Delivery: Not provided
Pricing model: Not provided
x402 version: 2

Endpoint context

URL: https://holidays.use.x402atlas.com/business-days
MIME type: application/json
First seen: 2026-10-16T01:50:06.715Z
Last seen: 2026-11-04T11:56:38.524Z
Tags: business-days, working-days, public-holidays, date-range, payroll, sla-deadlines, Scheduling

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1: 0.005 USDC
Atomic price: 5000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2: 0.005 USDC
Atomic price: 5000 · Network: eip155:137 · Asset: USDC · Scheme: exact
Payment option 3: 0.005 USDC
Atomic price: 5000 · Network: eip155:42161 · Asset: USDC · Scheme: exact
Payment option 4: 0.005 USDC
Atomic price: 5000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact

Raw x402 terms

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "5000",
    "payTo": "0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2"
  },
  {
    "scheme": "exact",
    "network": "eip155:137",
    "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "amount": "5000",
    "payTo": "0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2"
  },
  {
    "scheme": "exact",
    "network": "eip155:42161",
    "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "amount": "5000",
    "payTo": "0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "5000",
    "payTo": "3nXsChcZGke6xebDPmndNMCt8L3yi6xyN4Pd6q5cQrgv"
  }
]

Observed health

Status: Healthy
Latest latency: 12 ms
Average latency: 17 ms
HTTP status: 402
Last checked: 2026-11-04T11:56:38.519Z
Reachability: 100% over 13 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "method": {
      "enum": [
        "GET"
      ],
      "type": "string"
    },
    "queryParams": {
      "properties": {
        "country": {
          "description": "Supported ISO 3166-1 alpha-2 country code: AD Andorra; AL Albania; AT Austria; BE Belgium; BG Bulgaria; BR Brazil; BY Belarus; CH Switzerland; CZ Czechia; DE Germany; EE Estonia; ES Spain; FR France; HR Croatia; HU Hungary; IE Ireland; IT Italy; LI Liechtenstein; LT Lithuania; LU Luxembourg; LV Latvia; MC Monaco; MD Moldova; MT Malta; MX Mexico; NL Netherlands; PL Poland; PT Portugal; RO Romania; RS Serbia; SE Sweden; SI Slovenia; SK Slovakia; SM San Marino; VA Vatican City; ZA South Africa.",
          "enum": [
            "AD",
            "AL",
            "AT",
            "BE",
            "BG",
            "BR",
            "BY",
            "CH",
            "CZ",
            "DE",
            "EE",
            "ES",
            "FR",
            "HR",
            "HU",
            "IE",
            "IT",
            "LI",
            "LT",
            "LU",
            "LV",
            "MC",
            "MD",
            "MT",
            "MX",
            "NL",
            "PL",
            "PT",
            "RO",
            "RS",
            "SE",
            "SI",
            "SK",
            "SM",
            "VA",
            "ZA"
          ],
          "type": "string"
        },
        "from": {
          "description": "Inclusive range start; defaults to January 1 of the current UTC year",
          "format": "date",
          "type": "string"
        },
        "language": {
          "description": "Optional two-letter ISO 639-1 result language. Defaults to English when available.",
          "pattern": "^[A-Z]{2}$",
          "type": "string"
        },
        "subdivision": {
          "description": "Optional regional subdivision code beginning with the selected country code, for example DE-BE.",
          "maxLength": 20,
          "pattern": "^[A-Z]{2}-.+$",
          "type": "string"
        },
        "to": {
          "description": "Inclusive range end, at most 365 days after from; defaults to December 31 of from's year",
          "format": "date",
          "type": "string"
        }
      },
      "required": [
        "country",
        "from",
        "to"
      ],
      "type": "object"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method"
  ],
  "type": "object"
}

Output schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "properties": {
            "country": {
              "description": "Supported ISO 3166-1 alpha-2 country code: AD Andorra; AL Albania; AT Austria; BE Belgium; BG Bulgaria; BR Brazil; BY Belarus; CH Switzerland; CZ Czechia; DE Germany; EE Estonia; ES Spain; FR France; HR Croatia; HU Hungary; IE Ireland; IT Italy; LI Liechtenstein; LT Lithuania; LU Luxembourg; LV Latvia; MC Monaco; MD Moldova; MT Malta; MX Mexico; NL Netherlands; PL Poland; PT Portugal; RO Romania; RS Serbia; SE Sweden; SI Slovenia; SK Slovakia; SM San Marino; VA Vatican City; ZA South Africa.",
              "enum": [
                "AD",
                "AL",
                "AT",
                "BE",
                "BG",
                "BR",
                "BY",
                "CH",
                "CZ",
                "DE",
                "EE",
                "ES",
                "FR",
                "HR",
                "HU",
                "IE",
                "IT",
                "LI",
                "LT",
                "LU",
                "LV",
                "MC",
                "MD",
                "MT",
                "MX",
                "NL",
                "PL",
                "PT",
                "RO",
                "RS",
                "SE",
                "SI",
                "SK",
                "SM",
                "VA",
                "ZA"
              ],
              "type": "string"
            },
            "from": {
              "description": "Inclusive range start; defaults to January 1 of the current UTC year",
              "format": "date",
              "type": "string"
            },
            "language": {
              "description": "Optional two-letter ISO 639-1 result language. Defaults to English when available.",
              "pattern": "^[A-Z]{2}$",
              "type": "string"
            },
            "subdivision": {
              "description": "Optional regional subdivision code beginning with the selected country code, for example DE-BE.",
              "maxLength": 20,
              "pattern": "^[A-Z]{2}-.+$",
              "type": "string"
            },
            "to": {
              "description": "Inclusive range end, at most 365 days after from; defaults to December 31 of from's year",
              "format": "date",
              "type": "string"
            }
          },
          "required": [
            "country",
            "from",
            "to"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "properties": {
            "business_days": {
              "type": "integer"
            },
            "country": {
              "type": "string"
            },
            "from": {
              "format": "date",
              "type": "string"
            },
            "holiday_weekdays": {
              "description": "Weekdays closed by full-day Public or Bank holidays",
              "type": "integer"
            },
            "queried_at": {
              "format": "date-time",
              "type": "string"
            },
            "subdivision": {
              "type": "string"
            },
            "to": {
              "format": "date",
              "type": "string"
            },
            "total_days": {
              "type": "integer"
            },
            "weekend_days": {
              "type": "integer"
            }
          },
          "required": [
            "country",
            "from",
            "to",
            "total_days",
            "business_days",
            "weekend_days",
            "holiday_weekdays",
            "queried_at"
          ],
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}