Utilities

The Utilities API provides supporting data endpoints that can be used by workflow applications and integrations.

Public Holidays

Use the public holidays endpoint when you need to:

• Display holiday-aware schedules
• Exclude public holidays from date calculations
• Drive workflow deadlines or SLAs with local holiday information

Endpoint

The public holidays endpoint is:

GET /tenant/{tenantId}/v1/Utilities/PublicHolidays

Query Parameters

• country – Required country code, for example GB or US
• region – Optional region name or code
• from – Required start date, inclusive
• to – Required end date, inclusive

Example Request

GET /tenant/{tenantId}/v1/Utilities/PublicHolidays?country=GB&region=England&from=2026-01-01&to=2026-12-31
Authorization: Bearer {token}

const response = await fetch(
  `https://workflow.agglestone.com/tenant/${tenantId}/v1/Utilities/PublicHolidays?country=GB&region=England&from=2026-01-01&to=2026-12-31`,
  {
    headers: {
      'Authorization': `Bearer ${token}`
    }
  }
);

const holidays = await response.json();

{
  "holidays": [
    {
      "date": "2026-01-01",
      "reason": "New Year's Day"
    },
    {
      "date": "2026-12-25",
      "reason": "Christmas Day"
    }
  ]
}

Typical Status Codes

• 200 OK when the holiday list is returned successfully
• 400 Bad Request when required query parameters are missing or invalid
• 401 Unauthorized when authentication is missing or invalid

Notes

• from and to must both be valid dates
• to must be on or after from
• If region is omitted, the response contains country-level holidays only

📚 API Documentation: For the exact contract and supported response schema, visit https://workflow.agglestone.com/swagger.