Documentation

Bizday is an operational API for AI agents. It gives agents safe deadlines, send times, receipts, budget checks, readiness audits, and workday calculations for business workflows in 30+ countries.

Agent Operations

Use these endpoints when an agent needs to act safely, explain its reasoning, or check whether a workflow is allowed before taking action.

curl -X POST "https://api.bizday.dev/v1/deadline/calculate" \
  -H "Authorization: Bearer wday_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2026-05-04",
    "country": "GB",
    "days": 5,
    "deadline_type": "sla",
    "timezone": "Europe/London",
    "agent_id": "agent_support_01"
  }'

Authentication

All API requests (except /v1/countries) require an API key. Pass it via the Authorization header:

curl "https://api.bizday.dev/v1/check?date=2026-03-05&country=US" \
  -H "Authorization: Bearer wday_your_api_key"

Making Requests

All endpoints accept GET requests with query parameters. Dates must be in YYYY-MM-DD format. Country codes must be ISO 3166-1 alpha-2 (e.g. GB, US, DE).

Response Format

All responses follow a consistent JSON envelope:

// Success
{
  "success": true,
  "data": { ... },
  "meta": {
    "country": "GB",
    "requested_date": "2026-03-05",
    "cached": false,
    "timestamp": "2026-03-05T10:23:41.000Z"
  }
}

// Error
{
  "success": false,
  "error": {
    "code": "INVALID_DATE",
    "message": "Date must be in YYYY-MM-DD format.",
    "docs": "https://bizday.dev/docs/errors#INVALID_DATE"
  }
}

GET /v1/check

Check if a specific date is a workday in a given country.

Parameters

{
  "success": true,
  "data": {
    "date": "2026-12-25",
    "country": "GB",
    "is_workday": false,
    "reason": "public_holiday",
    "holiday": {
      "name": "Christmas Day",
      "local_name": "Christmas Day",
      "type": "Public"
    }
  }
}

Example

curl "https://api.bizday.dev/v1/check?date=2026-12-25&country=GB" \
  -H "Authorization: Bearer wday_your_api_key"

GET /v1/next

Find the next (or previous) workday from a given date.

Parameters

{
  "success": true,
  "data": {
    "from_date": "2026-12-24",
    "country": "GB",
    "direction": "next",
    "workday": "2026-12-29"
  }
}

Example

curl "https://api.bizday.dev/v1/next?date=2026-12-24&country=GB" \
  -H "Authorization: Bearer wday_your_api_key"

GET /v1/add

Add (or subtract) a number of workdays to a date, skipping weekends and holidays.

Parameters

{
  "success": true,
  "data": {
    "start_date": "2026-03-05",
    "country": "US",
    "workdays_added": 10,
    "result_date": "2026-03-19",
    "weekends_skipped": 4,
    "holidays_skipped": []
  }
}

Example

curl "https://api.bizday.dev/v1/add?date=2026-03-05&country=US&days=10" \
  -H "Authorization: Bearer wday_your_api_key"

GET /v1/between

Count the number of workdays between two dates.

Parameters

{
  "success": true,
  "data": {
    "country": "DE",
    "start_date": "2026-03-01",
    "end_date": "2026-03-31",
    "workdays": 21,
    "weekends": 9,
    "holidays": 1,
    "holiday_list": [
      { "date": "2026-04-03", "name": "Good Friday" }
    ]
  }
}

Example

curl "https://api.bizday.dev/v1/between?start=2026-03-01&end=2026-03-31&country=DE" \
  -H "Authorization: Bearer wday_your_api_key"

GET /v1/countries

List all supported countries. This endpoint does not require authentication.

{
  "success": true,
  "data": {
    "countries": [
      { "code": "AU", "name": "Australia" },
      { "code": "AT", "name": "Austria" },
      ...
    ],
    "count": 30
  }
}

Error Codes

All errors include a machine-readable code and a human-readable message.

Rate Limits

Rate limits are applied per API key on a monthly basis. Every response includes these headers:

Supported Countries

Holiday data is synced weekly from authoritative sources. Currently supported: