Skip to the content

Nationale feestdagen API Europa

Reinder.eu publiceert al 12 jaar de feestdagen van Nederland en België in Excel. Met de nieuwe Nationale feestdagen API Europa is van ieder land een feestdagen tabel beschikbaar.

Reinder.eu biedt een eenvoudige JSON-gebaseerde REST API-service die is ontwikkeld om Nationale feestdagen in Europa van het opgevraagde jaar te retourneren.

Naast een opsomming van de feestdagen van het land wordt ook de datum informatie meegegeven.

Probeer het eens uit :

https://address.whacky.nl/api/date/holiday?api_key=8ADD9919-E715-414C-B592-137253CE85AA&iso_alpha_2_country=NL&iso_alpha_2_language=NL&year=2019&output_format=yyyy-MM-dd'T'HH:mm:ss

Gratis te gebruiken

Wil je de Nationale feestdagen Europa API gaan gebruiken in je applicatie vraag dan een API_KEY aan door onderstaande formulier in te vullen. De API is gratis in gebruik tot 1000 verzoeken per maand. Wil je meer verzoeken per maand uitvoeren dan zijn de kosten € 25,- per jaar tot 100.000 verzoeken per maand.

Vraag voor grotere volumes een offerte.

Api_key en authenticatie

Na registratie ontvang je een, persoonlijke, toegangssleutel. Met deze sleutel heb je toegang tot alle API endpoints waar je op bent geabonneerd. Alle API endpoints benader je met de http GET methode.

https://address.whacky.nl/api/date/holiday?api_key=8ADD9919-E715-414C-B592-137253CE85AA

Met de API_KEY 8ADD9919-E715-414C-B592-137253CE85AA kan je 10 gast verzoeken per maand uitvoeren.

API Endpoints

Voor de Feestdagen Europa API is het endpoint adres : https://address.whacky.nl/api/date/holiday

API Error codes

In alle API endpoints wordt de validatiestatus geretourneerd. De validatiestatus bevat de volgende gegevens:

Validatiecode : Unieke identificatie van de status

Validationinfo : Systeemnaam van de validatie melding

Validationdescription : Detailbeschrijving van de validatie melding

 

De volgende validatie meldingen kunnen worden geretourneerd:

1001 : ok : Validatie succesvol zonder fouten

1002 : ok_with_warnings : Validatie niet volledig maar wel herkend

1003 : not_valid : Validatie met fouten niet herkend adres

2001 : missing_access_key : De API key ontbreekt in je request

2002 : invalid_access_key : De API key is onjuist

2003 : invalid_api_function : De functie die je aanroept is onjuist. Raadpleeg de documentatie

2004 : usage_limit_reached : Het limiet van je abonnement is bereikt.

2005 : function_access_restricted : Je abonnement staat het verzoek niet toe

4004 : 404_not_found : Je hebt een ongeldig verzoek verzonden dat niet gevonden kan worden

Parameters

Api_key (verplicht) : De persoonlijke toegangssleutel waarmee je toegang krijgt tot de database.

iso_alpha_2_country (verplicht) : De ISO Alpha 2 landcode van het land waar je de feestdagentabel van op wilt vragen. (zie ook lijst onder aan dit document)

iso_alpha_2_language (verplicht) : De ISO Alpha 2 taalcode van het land waar je de feestdagentabel van op wilt vragen. (zie ook lijst onder aan dit document)

year (verplicht) : Het jaar, in format jjjj, waarvan je de feestdagen tabel op wilt vragen.

output_format (Optioneel) : Het formaat waarin je de datum terug wilt kunnen lezen. Standaard is dat het Nederlandse datum en tijd formaat.

Response feestdagen API

public class Holiday

{

    // Aantal dagen gerekend vanaf 01-01-1753 

    public int date_id { get; set; }

    //Datum in formaat van land

    public string date { get; set; }

    // Unmanaged code cultuur informatie 

    public string culture_info { get; set; }

    // Jaar van verzoek

    public string year { get; set; }

    // kwartaal waarin de feestdag valt

    public string quarter { get; set; }

    // De maand waarin de feestdag valt

    public string month { get; set; }

    // De Engelse benaming voor de maand

    public string month_name { get; set; }

    // De benaming van de maand in de gevraagde taal

    public string month_name_local { get; set; }

    // De dag van het jaar

    public string year_day { get; set; }

   // De dag van de maand

    public string month_day { get; set; }

    // Dag van de week waarbij maandag dag 1 is

    public string week_day { get; set; }

    // De Engelse benaming van de dag

    public string day_name { get; set; }

    // De benaming van de dag in de gevraagde taal

    public string day_name_local { get; set; }

    // Datum in het ISO formaat

    public string iso_date { get; set; }

    // ISO weeknummer

    public string iso_week { get; set; }

    // Valt de feestdag in het weekend

    public bool is_weekend { get; set; }

    // Valt de feestdag ieder jaar op dezelfde dag

    public bool every_year_on_same_date { get; set; }

    // Betreft het een wereldwijde feestdag

    public bool global { get; set; }

    // De Engelse benaming van de feestdag

    public string name { get; set; }

    // De naam van de feestdag in de gevraagde taal

    public string name_local { get; set; }

    // Type feestdag Openbaar, Bank, School, Autoriteiten, Optioneel

    public string type { get; set; }

    // De datum in het optionele formaat

    public string formated_date { get; set; }

}

 

public class RootObject

{

    public string year { get; set; }

    public string country_iso_alpha_2 { get; set; }

    public List<Holiday> holidays { get; set; }

    public string result { get; set; }

    public object exception { get; set; }

}

 

Ondersteunde landen en talen

Land

Taal

Landcode

Taalcode

België

French

BE

FR

België

Nederlands; Flemish

BE

NL

Bulgarije

Bulgarian

BG

BG

Denemarken

Danish

DK

DA

Duitsland

German

DE

DE

Estland

Estonian

EE

ET

Finland

Finnish

FI

FI

Finland

Northern Sami

FI

SE

Finland

Swedish

FI

SV

Frankrijk

Breton

FR

BR

Frankrijk

Corsican

FR

CO

Frankrijk

French

FR

FR

Frankrijk

Occitan

FR

OC

Griekenland

Greek

GR

EL

Groot-Brittannië

English

GB

EN

Groot-Brittannië

Gaelic

GB

GD

Groot-Brittannië

Welsh

GB

CY

Hongarije

Hungarian

HU

HU

Ierland

English

IE

EN

Ierland

Irish

IE

GA

Italië

Italian

IT

IT

Letland

Latvian

LV

LV

Litouwen

Lithuanian

LT

LT

Luxemburg

French

LU

FR

Luxemburg

German

LU

DE

Luxemburg

Luxembourgish

LU

LB

Malta

Maltese

MT

MT

Nederland

Nederlands; Flemish

NL

NL

Nederland

Western Frisian

NL

FY

Oostenrijk

German

AT

DE

Polen

Polish

PL

PL

Portugal

Portuguese

PT

PT

Roemenië

Moldovan

RO

RO

Slovenië

Slovenian

SI

SL

Slowakije

Slovak

SK

SK

Spanje

Basque

ES

EU

Spanje

Catalan

ES

CA

Spanje

Galician

ES

GL

Spanje

Spanish

ES

ES

Tsjechië

Czech

CZ

CS

Zweden

Northern Sami

SE

SE

Zweden

Swedish

SE

SV

 

Reinder.eu

De Marne 118

8701 MC Bolsward

E-mail: [email protected]

Telefoon: +31 (0)515-227027

KvK nr.: 670 82 130

 

Route

Adres conversie

Adressen splitsen en controleren.

We hebben een handige tool ontwikkeld waarmee je adressen kunt splitsen of je Excel data kunt converteren voor allerlei doeleinden. Probeer het gratis uit!

Data conversie Excel