PHPackages                             westy92/holiday-event-api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. westy92/holiday-event-api

ActiveLibrary[API Development](/categories/api)

westy92/holiday-event-api
=========================

The Official Holiday and Event API for PHP

v1.0.1(3y ago)25[2 PRs](https://github.com/westy92/holiday-event-api-php/pulls)MITPHPPHP ^8.0

Since Dec 29Pushed 1y ago1 watchersCompare

[ Source](https://github.com/westy92/holiday-event-api-php)[ Packagist](https://packagist.org/packages/westy92/holiday-event-api)[ Docs](https://github.com/westy92/holiday-event-api-php)[ GitHub Sponsors](https://github.com/westy92)[ RSS](/packages/westy92-holiday-event-api/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (7)Versions (6)Used By (0)

The Official Holiday and Event API for PHP
==========================================

[](#the-official-holiday-and-event-api-for-php)

[![Packagist Version](https://camo.githubusercontent.com/fb600b65670cee44a505f2792f6863ac570330fb2bcd6851c7b38b790222c517/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f776573747939322f686f6c696461792d6576656e742d617069)](https://packagist.org/packages/westy92/holiday-event-api)[![Packagist PHP Version](https://camo.githubusercontent.com/bf2bce0523b1adf44ff582218e1404aca209c83f3be6026b47cd53c5b9c90eba/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f776573747939322f686f6c696461792d6576656e742d6170692f706870)](https://php.net/)[![Build Status](https://github.com/westy92/holiday-event-api-php/actions/workflows/ci.yml/badge.svg)](https://github.com/westy92/holiday-event-api-php/actions)[![Code Coverage](https://camo.githubusercontent.com/a0bbcb891c7c01005930f7f9e7b6a2fa0791e101d1676c5a552bc1a421c53551/68747470733a2f2f636f6465636f762e696f2f67682f776573747939322f686f6c696461792d6576656e742d6170692d7068702f6272616e63682f6d61696e2f67726170682f62616467652e737667)](https://codecov.io/gh/westy92/holiday-event-api-php)[![Type Coverage](https://camo.githubusercontent.com/8323f77753572894be4b84af5017812224defbb58fb9b8fa7f76f1ac28dea9d9/68747470733a2f2f73686570686572642e6465762f6769746875622f776573747939322f686f6c696461792d6576656e742d6170692d7068702f636f7665726167652e737667)](https://shepherd.dev/github/westy92/holiday-event-api-php)[![Funding Status](https://camo.githubusercontent.com/6baad25d3107edcdafe7cf2996a879f3355ba3ddb2fa3a2f22d3466b45bc659b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73706f6e736f72732f77657374793932)](https://github.com/sponsors/westy92)

Industry-leading Holiday and Event API for PHP. Over 5,000 holidays and thousands of descriptions. Trusted by the World’s leading companies. Built by developers for developers since 2011.

Supported PHP Versions
----------------------

[](#supported-php-versions)

The latest version of the the Holiday and Event API is compatible with all currently-supported PHP [releases](https://endoflife.date/php).

Authentication
--------------

[](#authentication)

Access to the Holiday and Event API requires an API Key. You can get for one for FREE [here](https://apilayer.com/marketplace/checkiday-api#pricing), no credit card required! Note that free plans are limited. To access more data and have more requests, a paid plan is required.

Installation
------------

[](#installation)

The recommended way to install the Holiday and Event API is through [Composer](https://getcomposer.org/).

```
composer require westy92/holiday-event-api

```

Example
-------

[](#example)

```
try {
    // Get a FREE API key from https://apilayer.com/marketplace/checkiday-api#pricing
    $client = new Westy92\HolidayEventApi\Client('');

    // Get Events for a given Date
    $events = $client->getEvents(
        // These parameters are the defaults but can be specified:
        // date: 'today',
        // timezone: 'America/Chicago',
        // adult: false,
    );

    $event = $events->events[0];
    echo "Today is {$event->name}! Find more information at: {$event->url}." . PHP_EOL;
    echo "Rate limit remaining: {$events->rateLimit?->remainingMonth}/{$events->rateLimit?->limitMonth} (month)." . PHP_EOL;

    // Get Event Information
    $eventInfo = $client->getEventInfo(
        id: $event->id,
        // These parameters can be specified to calculate the range of eventInfo->Event->Occurrences
        // start: 2020,
        // end: 2030,
    );

    $hashtags = implode(', ', $eventInfo->event->hashtags);
    echo "The Event's hashtags are {$hashtags}." . PHP_EOL;

    // Search for Events
    $query = "zucchini";
    $search = $client->search(
        query: $query,
        // These parameters are the defaults but can be specified:
        // adult: false,
    );

    $count = count($search->events);
    echo "Found {$count} events, including '{$search->events[0]->name}', that match the query '{$query}'." . PHP_EOL;
} catch (\Exception $e) {
    echo $e;
}
```

License
-------

[](#license)

The Holiday and Event API is made available under the MIT License (MIT). Please see the [License File](LICENSE) for more information.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance32

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 68.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

1226d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4c99f61b0526be6f022bbd536657426e36766508aeecd8487620505c3d7ec952?d=identicon)[westy92](/maintainers/westy92)

---

Top Contributors

[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (83 commits)")[![westy92](https://avatars.githubusercontent.com/u/290167?v=4)](https://github.com/westy92 "westy92 (38 commits)")

---

Tags

accurateapibestcalendarcelebratecheckidaydatedescriptioneventfederalfreeholiday-apiholiday-calculationholidayapiholidays-apinationalobservephppopulartrustedphpeventapidatelistcalendarholidayholidayscelebrationnationaldescriptionaccurateinternationalfreeworldpublicunofficialMonthYearholidayapidayofficialpopulardetailstrustedoccurrencebestfederalcheckiday

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Type Coverage Yes

### Embed Badge

![Health badge](/badges/westy92-holiday-event-api/health.svg)

```
[![Health](https://phpackages.com/badges/westy92-holiday-event-api/health.svg)](https://phpackages.com/packages/westy92-holiday-event-api)
```

###  Alternatives

[azuyalabs/yasumi

The easy PHP Library for calculating holidays

1.1k11.4M25](/packages/azuyalabs-yasumi)[kunalvarma05/dropbox-php-sdk

Dropbox PHP API V2 SDK (Unofficial)

3633.0M18](/packages/kunalvarma05-dropbox-php-sdk)[jeffreyhyer/bamboohr

PHP SDK for the BambooHR API

1077.3k1](/packages/jeffreyhyer-bamboohr)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)