What the response contains
Try BR, US, and JP and use the returned fields to identify the right record.
Fields worth checking
- Date
- Local name
- Coverage
- Holiday type
Nager.Date Holidays
Date · Local name · Coverage · Holiday type
Live lookup
Type a real query, scan the cards and confirm the key details before opening the full source.
Quick examples
Country and year define the calendar being queried
A holiday request uses a country code and, on the annual endpoint, a year. Each returned item includes date, localName, name, and countryCode. date uses the YYYY-MM-DD format; localName preserves the name used in that country, while name may provide another presentation. Choose country and year before comparing dates, since the same celebration can have different names or dates by place.
- Use two-letter country codes such as BR, US, or JP.
- Keep countryCode with the date when building an international calendar.
- Show localName when local context matters to the reader.
Scope and type need careful reading
global, counties, and types help interpret the scope of an item. A holiday may not apply to an entire country or may have territorial limits indicated in counties. types classifies the record in the source, but does not replace checking a law, employment agreement, school calendar, or notice from a local authority. Use this information to organise a lookup, not to state an obligation.
- Check counties before treating a date as national.
- Display types as a classification supplied by the source.
- For official decisions, confirm the calendar of the relevant place or institution.
Future dates should be queried again
The API provides annual lists and a next-holidays route. fixed and launchYear appear as metadata in some results, but the returned set remains tied to the requested country and period. If a schedule depends on a future date, query again close to use and record when the data was collected. That prevents an old list being reused for another year or location.
- Use the annual list to plan a defined period.
- Use next holidays for a short, current view.
- Record year, country, and query time when publishing a calendar.
