PHPackages                             santaklouse/ipqs-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. [API Development](/categories/api)
4. /
5. santaklouse/ipqs-laravel

ActiveLibrary[API Development](/categories/api)

santaklouse/ipqs-laravel
========================

A simple and modern wrapper for the IPQualityScore (IPQS) API, tailored for Laravel.

0.0.3(4mo ago)032MITPHPPHP ^8.0

Since Dec 11Pushed 4mo agoCompare

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

READMEChangelogDependencies (2)Versions (4)Used By (0)

IPQS Laravel Wrapper
====================

[](#ipqs-laravel-wrapper)

A simple and modern wrapper for the [IPQualityScore (IPQS)](https://www.ipqualityscore.com/) API, tailored for Laravel applications.

Installation
============

[](#installation)

Require the package using Composer:

```
composer require santaklouse/ipqs-laravel
```

Laravel Setup
=============

[](#laravel-setup)

1. Publish the configuration file
---------------------------------

[](#1-publish-the-configuration-file)

```
php artisan vendor:publish --provider="IpqsLaravel\\IpqsServiceProvider" --tag="ipqs-config"
```

This will create a `config/ipqs.php` file in your project.

2. Add your API key
-------------------

[](#2-add-your-api-key)

Add your IPQS API key to your `.env` file:

```
IPQS_API_KEY=your_api_key_here

```

You can get an API key from your [IPQS Dashboard](https://www.ipqualityscore.com/user/dashboard).

Usage
=====

[](#usage)

Dependency Injection (Recommended)
----------------------------------

[](#dependency-injection-recommended)

You can type-hint the `IpqsService` in your controllers or other classes resolved by Laravel's service container.

```
use IpqsLaravel\\IpqsService;
use IpqsLaravel\\IpqsException;

class MyController extends Controller
{
    protected IpqsService $ipqs;

    public function __construct(IpqsService $ipqs)
    {
        $this->ipqs = $ipqs;
    }

    public function checkUserIp(Request $request)
    {
        try {
            $ip = $request->ip();
            $result = $this->ipqs->checkIp($ip);

            if ($result['proxy'] || $result['vpn']) {
                // Block or flag the user
                return response()->json(['message' => 'Proxy/VPN detected.'], 403);
            }

            return response()->json(['message' => 'IP is clean.']);

        } catch (IpqsException $e) {
            // Log the error or handle it
            report($e);
            return response()->json(['message' => 'Could not verify IP.'], 500);
        }
    }
}
```

Facade
------

[](#facade)

You can also use the provided `Ipqs` facade for quick access.

```
use IpqsLaravel\\Facades\\Ipqs;
use IpqsLaravel\\IpqsException;

// ...

try {
    $emailResult = Ipqs::verifyEmail('user@example.com');
    if (!$emailResult['valid']) {
        // Handle invalid email
    }
} catch (IpqsException $e) {
    report($e);
}
```

Available Methods
-----------------

[](#available-methods)

### `checkIp(string $ip, array $options = [])`

[](#checkipstring-ip-array-options--)

Detects proxies, VPNs, and tor connections. *See [IPQS Proxy Detection Docs](https://www.ipqualityscore.com/documentation/proxy-detection-api)*

### `verifyEmail(string $email, array $options = [])`

[](#verifyemailstring-email-array-options--)

Validates an email address for deliverability and fraud. *See [IPQS Email Validation Docs](https://www.ipqualityscore.com/documentation/email-validation-api)*

### `validatePhone(string $phone, array $options = [])`

[](#validatephonestring-phone-array-options--)

Validates a phone number to check if it's valid, mobile, and a VOIP. *See [IPQS Phone Validation Docs](https://www.ipqualityscore.com/documentation/phone-validation-api)*

### `bulkValidateCsv($fileContent)`

[](#bulkvalidatecsvfilecontent)

Submits a CSV file for bulk validation of emails, IPs, or phones. *See [IPQS Bulk Validation Docs](https://www.ipqualityscore.com/documentation/bulk-validation-api)*

Configuration
=============

[](#configuration)

The `config/ipqs.php` file allows you to set default options for each API type, which will be merged with any options you pass at runtime.

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance74

Regular maintenance activity

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity32

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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 ~2 days

Total

3

Last Release

149d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9b5ae5544c7e40e4355a229a73196db631b70ac64f592efabac7580a82a276bb?d=identicon)[santaklouse](/maintainers/santaklouse)

---

Top Contributors

[![santaklouse](https://avatars.githubusercontent.com/u/1434629?v=4)](https://github.com/santaklouse "santaklouse (5 commits)")

---

Tags

laravelproxyfraudemail validationipqualityscoreipqsphone-validationvpn

### Embed Badge

![Health badge](/badges/santaklouse-ipqs-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/santaklouse-ipqs-laravel/health.svg)](https://phpackages.com/packages/santaklouse-ipqs-laravel)
```

###  Alternatives

[openai-php/laravel

OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API

3.7k7.6M74](/packages/openai-php-laravel)[statamic/cms

The Statamic CMS Core Package

4.8k3.2M720](/packages/statamic-cms)[scriptdevelop/whatsapp-manager

Paquete para manejo de WhatsApp Business API en Laravel

762.6k](/packages/scriptdevelop-whatsapp-manager)[njoguamos/laravel-plausible

A laravel package for interacting with plausible analytics api.

208.8k](/packages/njoguamos-laravel-plausible)

PHPackages © 2026

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