# Vextorium Business Days API

> Vextorium Business Days API is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-11).

Counts business days between two dates or calculates a future business date by adding N days, skipping weekends and official holidays for 150+ countries and their regions.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/business-days?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-business-days-api-c05ae443
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ewPb22GSiV4QxYNHnPGIw

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vextorium-business-days-api-c05ae443 -d '<json body>'
```

Example prompt: How many business days are there between November 20, 2026 and December 31, 2026 in the US, and list any holidays that fall in that range?

## When to prefer this

Choose this endpoint when you need accurate business day calculations that account for official public holidays in a specific country or region, not just weekends. It covers 150+ countries and supports regional subdivisions, making it superior to generic date-math libraries for international compliance, SLA tracking, invoice terms, or legal deadlines.

## Known failure modes

- Missing required 'country' or 'since' field returns a validation error
- Unsupported country code returns an error or empty holiday list
- Invalid date format causes a parsing error
- Region code not recognized for the given country may return results without regional holidays
- Providing neither 'until' nor 'add_days' may result in ambiguous or empty output

## How this service works

Business days in 150+ countries and their regions: count between two dates, or the date after adding N business days, skipping weekends and official holidays, listing the holidays in the range.

## Output

A JSON object containing the result date (if adding business days), the total number of business days added, the weekday name of the result date, the input country and region, the start date, and an array of holidays skipped (each with date and name).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "country",
      "since"
     ],
     "properties": {
      "since": {
       "type": "string"
      },
      "until": {
       "type": "string"
      },
      "region": {
       "type": "string",
       "description": "Subdivision code (optional)"
      },
      "country": {
       "type": "string"
      },
      "add_days": {
       "type": "integer"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "since": {
       "type": [
        "string",
        "null"
       ]
      },
      "region": {},
      "result": {
       "type": [
        "string",
        "null"
       ]
      },
      "country": {
       "type": [
        "string",
        "null"
       ]
      },
      "weekday": {
       "type": [
        "string",
        "null"
       ]
      },
      "skipped_holidays": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": [
         "null",
         "object"
        ],
        "properties": {
         "date": {
          "type": [
           "string",
           "null"
          ]
         },
         "name": {
          "type": [
           "string",
           "null"
          ]
         }
        }
       }
      },
      "added_business_days": {
       "type": [
        "number",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "since": "2026-11-20",
  "region": null,
  "result": "2026-11-30",
  "country": "US",
  "weekday": "Monday",
  "skipped_holidays": [
   {
    "date": "2026-11-26",
    "name": "Thanksgiving Day"
   }
  ],
  "added_business_days": 5
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-business-days-api-c05ae443/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)