PHPackages                             codeitamarjr/laravel-cro-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. codeitamarjr/laravel-cro-api

ActiveLibrary[API Development](/categories/api)

codeitamarjr/laravel-cro-api
============================

Laravel wrapper for the Irish CRO API with helpers for searching companies and submissions.

0.1.1(6mo ago)01MITPHPPHP ^8.1

Since Nov 17Pushed 3mo agoCompare

[ Source](https://github.com/codeitamarjr/laravel-cro-api)[ Packagist](https://packagist.org/packages/codeitamarjr/laravel-cro-api)[ RSS](/packages/codeitamarjr-laravel-cro-api/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (4)Versions (3)Used By (0)

Laravel CRO API
===============

[](#laravel-cro-api)

A minimal Laravel wrapper for the Irish Company Registration Office (CRO) API. It provides a fluent client, container binding, and a facade for common CRO lookups.

Install
-------

[](#install)

```
composer require codeitamarjr/laravel-cro-api
```

Publish the config if you need to override defaults:

```
php artisan vendor:publish --tag=cro-api-config
```

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

[](#configuration)

Set your credentials (and optionally override the base URL/timeouts) in your `.env`:

```
CRO_API_EMAIL=you@example.com
CRO_API_KEY=your-key
CRO_API_BASE_URL=https://services.cro.ie/cws
CRO_API_HTTP_TIMEOUT=15
CRO_API_MAX_PER_PAGE=100
CRO_API_RATE_LIMIT_SLEEP_SECONDS=10
CRO_API_DELAY_BETWEEN_REQUESTS_MS=750

```

`CRO_EMAIL` will also be read if `CRO_API_EMAIL` is not set, keeping compatibility with existing env names.

Usage
-----

[](#usage)

Resolve the client out of the container (or use the `CroApi` facade):

```
use Codeitamarjr\LaravelCroApi\CroApiClient;
use Codeitamarjr\LaravelCroApi\Facades\CroApi;

// Via dependency injection
public function show(CroApiClient $cro)
{
    $companies = $cro->searchByNumber('123456');
}

// Via facade
$details = CroApi::getCompanyDetails('123456');
$submissions = CroApi::getCompanySubmissions('123456');
$latestByType = CroApi::searchCompanySubmissions('123456'); // paginated + deduped
```

Testing
-------

[](#testing)

Run the package tests locally:

```
composer install
composer test
```

### Available methods

[](#available-methods)

- `searchByNumber(string $number): array` — Filter companies by number.
- `getCompanyDetails(string $number): array` — Fetch company profile data.
- `getCompanySubmissions(string $number): array` — Retrieve submissions for one company.
- `searchCompanySubmissions(string $number, string $busIndicator = 'c'): array` — Paginate through submissions, handling Cloudflare rate limits and returning the latest submission per type.

Testing locally
---------------

[](#testing-locally)

When working in a single repo, you can point Composer to the path:

```
composer config repositories.laravel-cro-api path ./packages/laravel-cro-api
composer require codeitamarjr/laravel-cro-api:*
```

The package is auto-discovered by Laravel; no manual provider registration is needed.

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance76

Regular maintenance activity

Popularity1

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

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

182d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/dea1e9b29f49d63c69e129ab9e08825fd7155c2db0f91824dfd5f165c278b979?d=identicon)[codeitamarjr](/maintainers/codeitamarjr)

---

Tags

apilaravelregisterIrelandcro

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/codeitamarjr-laravel-cro-api/health.svg)

```
[![Health](https://phpackages.com/badges/codeitamarjr-laravel-cro-api/health.svg)](https://phpackages.com/packages/codeitamarjr-laravel-cro-api)
```

###  Alternatives

[essa/api-tool-kit

set of tools to build an api with laravel

52680.5k](/packages/essa-api-tool-kit)[resend/resend-laravel

Resend for Laravel

1191.4M6](/packages/resend-resend-laravel)[mollie/laravel-mollie

Mollie API client wrapper for Laravel & Mollie Connect provider for Laravel Socialite

3624.1M28](/packages/mollie-laravel-mollie)[dragon-code/laravel-json-response

Automatically always return a response in JSON format

1118.6k1](/packages/dragon-code-laravel-json-response)[surface/laravel-webfinger

A Laravel package to create an ActivityPub webfinger.

113.8k](/packages/surface-laravel-webfinger)

PHPackages © 2026

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