Finturest.Holiday 1.0.0

Finturest Holiday API C# SDK

Official C# SDK for the Finturest Holiday API - supports .NET Standard 2.0+ and all modern .NET versions.

Overview

This SDK provides a convenient and efficient way to access the Finturest Holiday API in your .NET applications. It supports .NET Standard 2.0 and later, ensuring compatibility with .NET Core and the latest .NET releases.

Features

• Worldwide Holiday Coverage: Access public, national, bank, and regional holidays across 250+ countries and territories.

• Multi-Year Range: Query holidays for any year or range of years — past, current, or future.

• Region & Subdivision Support: Retrieve holidays based on country, region, state, or province with ISO-compliant codes.

• Date-Based Lookups: Check if a specific date is a holiday, weekend, or working day in a given location.

• Flexible Filters: Filter holidays by type (public, religious, observance), and country.

• Official Sources: Data is aggregated from government declarations and official sources for accuracy and reliability.

Installation

Using the .NET Core command-line interface (CLI) tools:

dotnet add package Finturest.Holiday

Using the NuGet Command Line Interface (CLI):

nuget install Finturest.Holiday

Using the Package Manager Console:

Install-Package Finturest.Holiday

From within Visual Studio:

1. Open the Solution Explorer.
2. Right-click on a project within your solution.
3. Click on Manage NuGet Packages...
4. Click on the Browse tab and search for "Finturest.Holiday".
5. Click on the Finturest.Holiday package, select the appropriate version in the right-tab and click Install.

Usage

Registering

To use the Finturest.Holiday client, register it in your application's dependency injection container using AddFinturestHoliday. This configures the services required to communicate with the Finturest Holiday API.

var services = new ServiceCollection();

services.AddFinturestHoliday(options =>
{
    options.ApiKey = "YOUR_API_KEY";
});

Note
IHolidayServiceClient is registered in the DI container and should be resolved via dependency injection.
In ASP.NET Core applications, it's recommended to inject it through constructor injection.

Note
The abstractions for the Finturest Holiday API client are provided in a separate package named Finturest.Holiday.Abstractions.
You can reference this package in your business layer to avoid a tight dependency on the implementation.
Only the root application or composition root should reference the full Finturest.Holiday package that contains the implementation.

Get upcoming holidays

To get upcoming holidays using the Finturest Holiday API, call the GetUpcomingHolidaysAsync method on the IHolidayServiceClient.

var serviceProvider = services.BuildServiceProvider();

var holidayServiceClient = serviceProvider.GetRequiredService<IHolidayServiceClient>();

var result = await holidayServiceClient.GetUpcomingHolidaysAsync(countryCode: "PL", days: 365, type: HolidayType.Public);

Console.WriteLine($"Holidays: {result.Count}.");

Note
In production applications, avoid using BuildServiceProvider() manually.
Instead, use constructor injection to get IHolidayServiceClient from the framework’s dependency injection system.

Subscription & Pricing

To get access to the Finturest Holiday API or subscribe to a plan, please visit the subscription page. An active subscription is required to access the API in production.

Manage subscriptions

API Key Generation

An API key is required to use the SDK and can be generated on your Finturest dashboard:

Generate API key

Documentation

For full API reference and usage guides, please visit the official Finturest Holiday API documentation:

View API reference

Contact

For support, questions, or inquiries, please contact us at: support@finturest.com