PHPackages                             versium/reach-api-php-sdk - 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. versium/reach-api-php-sdk

ActiveLibrary[API Development](/categories/api)

versium/reach-api-php-sdk
=========================

A PHP client library for accessing the Versium REACH APIs.

v0.4.0(2y ago)1762↑50%BSD-3-ClausePHPPHP >=7.2

Since Dec 28Pushed 2y ago3 watchersCompare

[ Source](https://github.com/VersiumAnalytics/reach-api-php-sdk)[ Packagist](https://packagist.org/packages/versium/reach-api-php-sdk)[ RSS](/packages/versium-reach-api-php-sdk/feed)WikiDiscussions master Synced 1mo ago

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

Versium REACH API Software Development Kit (SDK)
================================================

[](#versium-reach-api-software-development-kit-sdk)

A simplified PHP interface for accessing the [Versium Reach APIs](https://api-documentation.versium.com/docs/start-building-with-versium)

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

[](#installation)

From the root of your project, use composer to install the SDK from [packagist](https://packagist.org/).

```
composer require versium/reach-api-php-sdk
```

Usage
-----

[](#usage)

1. Use `ReachClient`

```
use Versium\Reach\ReachClient;
```

2. Create a `ReachClient` instance, with your [API Key](https://app.versium.com/account/manage-api-keys), an optional callback function for logging, and an optional queries-per-second rate limit.

```
$loggingFunction = function($msg) {
    //print out message for dev
    echo $msg;
};
$client = new ReachClient('you-api-key', $loggingFunction);
```

Note: remember to update the $qps value if Versium customer services increases your rate limit.

3. For adding data to a set of inputs, use the `append` function. This function returns a `Generator` that yields arrays containing API responses. Check the [API documentation](https://api-documentation.versium.com/docs/the-versium-api-landscape) for which data tools and output types are available.

```
//call the contact API to append phones and emails
$inputs = [
    [
        'first' => 'john',
        'last' => 'doe',
        'address' => '123 Trinity St',
        'city' => 'Redmond',
        'state' => 'WA',
        'zip' => '98052',
    ]
];

foreach ($client->append('contact', $inputs, ['email', 'phone']) as $results) {
    //filter out failed queries for processing later
    $failedResults = array_filter($results, function ($result) {
        return !$result->success;
    });

    //merge successful matches with inputs
    foreach ($results as $idx => $result) {
        if ($result->matchFound) {
            $inputs[$idx]['appendResults'] = $result->body->versium->results;
        }
    }
}
```

4. For retrieving a list of records, use the `listgen` function. This function returns a single `APIResponse` object. This object contains the getRecordsFunc property for iterating through the returned records. Check the [API documentation](https://api-documentation.versium.com/docs/the-versium-api-landscape) for which data tools and output types are available.

```
$result = $client->listgen('abm', ['domain' => ['versium.com']], ['abm_email', 'abm_online_audience']);

if ($result->success) {
    foreach (($result->getRecordsFunc)() as $record) {
        var_dump($record);
    }
}
```

Returned Results
----------------

[](#returned-results)

Both the `append` and `listgen` functions return one or more `APIResponse` objects. See the comments in the class for descriptions of its properties.

Things to keep in mind
======================

[](#things-to-keep-in-mind)

- The default rate limit for Reach APIs is 20 queries per second
- You must have a provisioned API key for this function to work. If you are unsure where to find your API key, look at our [API key documentation](https://api-documentation.versium.com/docs/find-your-api-key)

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 Bus Factor1

Top contributor holds 90.5% 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 ~58 days

Total

4

Last Release

1063d ago

### Community

Maintainers

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

---

Top Contributors

[![Bkot](https://avatars.githubusercontent.com/u/277005?v=4)](https://github.com/Bkot "Bkot (19 commits)")[![RyanWatson425](https://avatars.githubusercontent.com/u/77034361?v=4)](https://github.com/RyanWatson425 "RyanWatson425 (2 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/versium-reach-api-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/versium-reach-api-php-sdk/health.svg)](https://phpackages.com/packages/versium-reach-api-php-sdk)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[facebook/php-business-sdk

PHP SDK for Facebook Business

90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

74513.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

265103.1M454](/packages/google-gax)[google/common-protos

Google API Common Protos for PHP

173103.7M50](/packages/google-common-protos)

PHPackages © 2026

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