Api Endpoint

Agent Time & Place

Business-day arithmetic that respects weekends and a country's public holidays. Either add N business days to a date (SLA due dates, shipping ETAs) or count business days between two dates. Weekend days are configurable (e.g. 'fri,sat').

Open interactive test console

Offering

Provider
time-place.agent-utils.workers.dev
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://time-place.agent-utils.workers.dev/v1/business-days
MIME type
application/json
First seen
2026-10-16T02:01:31.612Z
Last seen
Tags
business-days, calendar, sla, Scheduling, Holidays

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
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "5000",
    "payTo": "0xc42cbF077aF05D1a613d455067c201CA44e9CAFb"
  }
]

Observed health

Status
Healthy
Latest latency
1287 ms
Average latency
998 ms
HTTP status
402
Last checked
Reachability
100% over 14 checks

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

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "country": {
          "type": "string"
        },
        "from": {
          "type": "string",
          "format": "date"
        },
        "add": {
          "type": "integer",
          "description": "Business days to add (negative to subtract). Mutually exclusive with 'to'."
        },
        "to": {
          "type": "string",
          "format": "date",
          "description": "Count business days from 'from' to 'to' inclusive."
        },
        "weekend": {
          "type": "string",
          "default": "sat,sun",
          "description": "Comma list of weekend day names"
        },
        "region": {
          "type": "string",
          "description": "Optional ISO 3166-2 code for regional holidays"
        }
      },
      "required": [
        "country",
        "from"
      ]
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "object",
      "required": [
        "type",
        "method"
      ],
      "properties": {
        "type": {
          "type": "string",
          "const": "http"
        },
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "queryParams": {
          "type": "object",
          "required": [
            "country",
            "from"
          ],
          "properties": {
            "to": {
              "type": "string",
              "format": "date",
              "description": "Count business days from 'from' to 'to' inclusive."
            },
            "add": {
              "type": "integer",
              "description": "Business days to add (negative to subtract). Mutually exclusive with 'to'."
            },
            "from": {
              "type": "string",
              "format": "date"
            },
            "region": {
              "type": "string",
              "description": "Optional ISO 3166-2 code for regional holidays"
            },
            "country": {
              "type": "string"
            },
            "weekend": {
              "type": "string",
              "default": "sat,sun",
              "description": "Comma list of weekend day names"
            }
          }
        }
      },
      "additionalProperties": false
    },
    "output": {
      "type": "object",
      "required": [
        "type"
      ],
      "properties": {
        "type": {
          "type": "string"
        },
        "example": {
          "type": "object",
          "properties": {
            "to": {
              "type": "string"
            },
            "from": {
              "type": "string"
            },
            "mode": {
              "enum": [
                "add",
                "count"
              ],
              "type": "string"
            },
            "start": {
              "type": "string"
            },
            "result": {
              "type": "string"
            },
            "country": {
              "type": "string"
            },
            "holidays": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "date": {
                    "type": "string",
                    "format": "date"
                  },
                  "name": {
                    "type": "string",
                    "description": "English name"
                  },
                  "types": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "regions": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "items": {
                      "type": "string"
                    },
                    "description": "ISO 3166-2 codes when regional"
                  },
                  "localName": {
                    "type": "string"
                  },
                  "nationwide": {
                    "type": "boolean"
                  }
                }
              }
            },
            "weekendDays": {
              "type": "integer"
            },
            "businessDays": {
              "type": "integer"
            },
            "calendarDays": {
              "type": "integer"
            },
            "skippedHolidays": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "date": {
                    "type": "string",
                    "format": "date"
                  },
                  "name": {
                    "type": "string",
                    "description": "English name"
                  },
                  "types": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "regions": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "items": {
                      "type": "string"
                    },
                    "description": "ISO 3166-2 codes when regional"
                  },
                  "localName": {
                    "type": "string"
                  },
                  "nationwide": {
                    "type": "boolean"
                  }
                }
              }
            },
            "skippedWeekendDays": {
              "type": "integer"
            }
          }
        }
      }
    }
  }
}