% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/get_colombia_holidays.R
\name{get_colombia_holidays}
\alias{get_colombia_holidays}
\title{Get Official Public Holidays in Colombia for a Given Year}
\source{
Data obtained from the Nager.Date API: \url{https://date.nager.at/}
}
\usage{
get_colombia_holidays(year)
}
\arguments{
\item{year}{An integer indicating the year (e.g., 2024 or 2025).}
}
\value{
A tibble with the following columns:
\itemize{
  \item \code{date}: Date of the holiday (class \code{Date})
  \item \code{local_name}: Holiday name in the local language (Spanish)
  \item \code{name}: Holiday name in English
}
}
\description{
Retrieves the list of official public holidays in Colombia for a specific year
using the Nager.Date public holidays API.
This function returns a tibble containing the date of the holiday, the name
in the local language (Spanish), and the English name.
It is useful for academic, planning, and data analysis purposes.
The information is retrieved directly from the Nager.Date API and reflects
the current status of holidays for the requested year.
The field names returned are consistent with the API structure.
}
\details{
This function sends a GET request to the Nager.Date API.
If the API request fails or returns an error status code,
the function returns \code{NULL} with an informative message.
}
\note{
Requires internet connection.
}
\examples{
if (interactive()) {
  get_colombia_holidays(2024)
}

}
\seealso{
\code{\link[httr]{GET}}, \code{\link[jsonlite]{fromJSON}}, \code{\link[tibble]{tibble}}
}
