jord-jd/github-status-api

Programmatically determine if GitHub is working well, or experiencing issues

v2.0.2 2026-07-18 00:22 UTC

Requires

• php: ^7.1 || ^8.0
• nesbot/carbon: ^2.7

Requires (Dev)

• phpunit/phpunit: ^7.5 || ^9.6

Replaces

• divineomega/github-status-api: v2.0.2

LGPL-3.0-only

• Jordan Hall

Published on Packagist.org on 2026-07-18 00:22 UTC

README

This package provides a way to programmatically determine if GitHub is working well, or experiencing issues. It uses GitHub's current Statuspage API.

The replacement API does not provide the historical feed used by older package versions. Passing a past date therefore returns GitHubStatus::UNKNOWN.

Installation

To install PHP GitHub Status API, just run the following composer command.

composer require jord-jd/github-status-api

Remember to include the vendor/autoload.php file if your framework does not do this for you.

Usage

To check the state of GitHub currently, simply create a new Client object, and call its status method. You can optionally pass a Carbon date object to the status method to retrieve a historical status.

use Carbon\Carbon;
use JordJD\GitHubStatusApi\Client;
use JordJD\GitHubStatusApi\Enums\GitHubStatus;

require_once 'vendor/autoload.php';

$status    = (new Client())->status();
// $status = (new Client())->status(Carbon::parse('2018-12-06 17:00'));

switch ($status) {
    case GitHubStatus::GOOD:
        echo 'GitHub is up! No issues reported.';
        break;

    case GitHubStatus::MINOR:
        echo 'GitHub is experiencing minor issues.';
        break;

    case GitHubStatus::MAJOR:
        echo 'GitHub is experiencing major issues.';
        break;

    case GitHubStatus::UNKNOWN:
        echo 'Unable to determine GitHub\'s status.';
        break;
}

echo PHP_EOL;