Time

Business Days Calculator API

POST request to /v1/business-days, returning json in the standard envelope.

POST/v1/business-days2 credits / call Free tier

Authentication

Send your API key as a bearer token. Create one free in the dashboard.

Authorization: Bearer $TOOLSXPO_KEY

Parameters

Sent as fields in the JSON body. The values below are the examples used throughout this page.

Name	Example value
start	2026-08-09
end	2026-12-25
holidays
includeEndDate	true

Example request

curl -X POST "https://api.toolsxpo.com/v1/business-days" \
  -H "Authorization: Bearer $TOOLSXPO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start":"2026-08-09","end":"2026-12-25","holidays":"","includeEndDate":"true"}'

Response

Every endpoint answers with the same envelope. The result is in data (json); meta.credits reports what the call cost.

{
  "ok": true,
  "data": { /* json */ },
  "meta": { "credits": 2 }
}

Errors

Failures use the same envelope with ok: false and a machine-readable code.

Status	Code	Meaning
400	invalid_input	A parameter failed validation. `details` lists which.
401	unauthorized	Missing or invalid API key.
402	quota_exceeded	Out of credits on this workspace.
404	not_found	No such tool.
429	rate_limited	Too many requests. Retry after `Retry-After` seconds.
503	service_unavailable	Temporarily disabled by an administrator.

Try it in the playground Open example URL