PHPackages                             kapersoft/cron-job-api-for-laravel - 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. [Queues & Workers](/categories/queues)
4. /
5. kapersoft/cron-job-api-for-laravel

ActiveLibrary[Queues & Workers](/categories/queues)

kapersoft/cron-job-api-for-laravel
==================================

Laravel package for Cron Job API

0.0.1(9mo ago)11[4 PRs](https://github.com/kapersoft/cron-job-api-for-laravel/pulls)MITPHPCI passing

Since Aug 31Pushed 4d agoCompare

[ Source](https://github.com/kapersoft/cron-job-api-for-laravel)[ Packagist](https://packagist.org/packages/kapersoft/cron-job-api-for-laravel)[ Docs](https://github.com/kapersoft/cron-job-api-for-laravel)[ GitHub Sponsors](https://github.com/kapersoft)[ RSS](/packages/kapersoft-cron-job-api-for-laravel/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (1)Dependencies (18)Versions (18)Used By (0)

cron-job-api-for-laravel
========================

[](#cron-job-api-for-laravel)

First-class Laravel 12+ wrapper around the cron-job.org v1 API using [`kapersoft/cron-job-api`](https://github.com/kapersoft/cron-job-api) under the hood.

What is this repo?
------------------

[](#what-is-this-repo)

This is `kapersoft/cron-job-api-for-laravel`, a lightweight wrapper for Laravel that exposes the public cron-job.org API, providing simple methods to list, create, update, delete, and inspect jobs and their history.

What is cron-job.org?
---------------------

[](#what-is-cron-joborg)

[cron-job.org](https://cron-job.org) is a hosted scheduler. It executes HTTP(S) requests on schedules (minutes to months), great for pinging endpoints, running webhooks, and health checks without maintaining your own cron infrastructure.

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

[](#installation)

```
composer require kapersoft/cron-job-api-for-laravel
```

Requirements:

- PHP ^8.4
- Laravel ^12.0

Configuration
-------------

[](#configuration)

You can use environment variables without publishing config:

```
# .env
CRON_JOB_API_KEY=your-api-token
```

Or publish the config file if you prefer a file under `config/`:

```
php artisan vendor:publish --provider="Kapersoft\\CronJobApiForLaravel\\CronJobApiServiceProvider"
```

This writes `config/cron-job-api-for-laravel.php` with keys `api_key` and `base_url`.

Usage
-----

[](#usage)

You can resolve the client from the container or use the Facade.

Controller/job example (dependency injection):

```
use Kapersoft\CronJobApi\Client;

final readonly class JobsController
{
    public function __construct(private Client $client) {}

    public function index() {
        $list = $client->list();
        // ...
    }
}
```

Using the Facade:

```
use Kapersoft\CronJobApiForLaravel\Facades\CronJobApi;

$jobs = CronJobApi::list();
```

List jobs:

```
use Kapersoft\CronJobApi\Job;

$jobList = $client->list();
foreach ($jobList->jobs as $job) {
    /** @var Job $job */
    echo $job->jobId.' '.$job->title.PHP_EOL;
}
```

Get one job (with full details):

```
$detailed = $client->get(123); // returns DetailedJob
echo $detailed->title;
```

Create a job:

```
use Kapersoft\CronJobApi\{Job, Schedule, RequestMethodEnum};

$newJobId = $client->create(new Job(
    enabled: true,
    title: 'Ping production',
    url: 'https://example.com/health',
    requestTimeout: 30,
    redirectSuccess: true,
    schedule: new Schedule(
        timezone: 'UTC',
        expiresAt: 0,        // 0 = never expires
        hours: [-1],         // every hour
        mdays: [-1],         // every day of month
        minutes: [0, 30],    // on minute 0 and 30
        months: [-1],        // every month
        wdays: [-1],         // every day of week
    ),
    requestMethod: RequestMethodEnum::GET,
));
```

Update a job (partial fields):

```
$client->update($newJobId, new Job(title: 'Ping prod (renamed)'));
```

Delete a job:

```
$client->delete($newJobId);
```

List history and fetch a specific run:

```
$history = $client->history(123);
$firstRun = $history->history[0];
$details = $client->historyItem(123, $firstRun->identifier);
```

How to report issues
--------------------

[](#how-to-report-issues)

- Open an issue: [GitHub Issues](https://github.com/kapersoft/cron-job-api-for-laravel/issues)
- Please include minimal repro code, expected vs. actual behavior, and versions.

License information
-------------------

[](#license-information)

This library is MIT licensed. See [LICENSE.md](LICENSE.md).

Security information
--------------------

[](#security-information)

Do not post vulnerabilities in public issues. See [SECURITY.md](SECURITY.md).

How to contribute
-----------------

[](#how-to-contribute)

Read [CONTRIBUTING.md](CONTRIBUTING.md) for setup, coding standards, and workflow. PRs with focused changes and tests are welcome.

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance80

Actively maintained with recent releases

Popularity3

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 Bus Factor2

2 contributors hold 50%+ of commits

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

Unknown

Total

1

Last Release

299d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2b282b144777d8ee6a9f1d468dd4fd44e549e337fee20857af65252fa505aeca?d=identicon)[kapersoft](/maintainers/kapersoft)

---

Top Contributors

[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (120 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (120 commits)")[![kapersoft](https://avatars.githubusercontent.com/u/13007854?v=4)](https://github.com/kapersoft "kapersoft (1 commits)")

---

Tags

apilaraveljobcron

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/kapersoft-cron-job-api-for-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/kapersoft-cron-job-api-for-laravel/health.svg)](https://phpackages.com/packages/kapersoft-cron-job-api-for-laravel)
```

###  Alternatives

[anourvalar/eloquent-serialize

Laravel Query Builder (Eloquent) serialization

11222.5M32](/packages/anourvalar-eloquent-serialize)[mxl/laravel-job

Laravel job tools

661.4M](/packages/mxl-laravel-job)[mpbarlow/laravel-queue-debouncer

A wrapper job for debouncing other queue jobs.

63792.6k1](/packages/mpbarlow-laravel-queue-debouncer)[api-platform/laravel

API Platform support for Laravel

59156.3k11](/packages/api-platform-laravel)[convenia/pigeon

3234.2k](/packages/convenia-pigeon)[pmatseykanets/artisan-beans

Easily manage your Beanstalkd job queues right from the Laravel artisan command

4282.3k](/packages/pmatseykanets-artisan-beans)

PHPackages © 2026

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