PHPackages                             petfinder-com/petfinder-php - 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. petfinder-com/petfinder-php

ActiveLibrary[API Development](/categories/api)

petfinder-com/petfinder-php
===========================

Petfinder API client

v1.0.2(7y ago)83544[1 issues](https://github.com/petfinder-com/petfinder-php-sdk/issues)BSD-3-ClausePHPPHP ^7.1CI failing

Since Mar 19Pushed 6y ago1 watchersCompare

[ Source](https://github.com/petfinder-com/petfinder-php-sdk)[ Packagist](https://packagist.org/packages/petfinder-com/petfinder-php)[ Docs](https://www.petfinder.com/developers/)[ RSS](/packages/petfinder-com-petfinder-php/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (2)Dependencies (15)Versions (4)Used By (0)

Petfinder PHP SDK
=================

[](#petfinder-php-sdk)

[![CircleCI](https://camo.githubusercontent.com/7f730e6e62f47daa0cf14365baabe06b0474bea65d59544bb3912fb1b0928bdc/68747470733a2f2f636972636c6563692e636f6d2f67682f70657466696e6465722d636f6d2f70657466696e6465722d7068702d73646b2e7376673f7374796c653d736869656c64)](https://circleci.com/gh/petfinder-com/petfinder-php-sdk)[![packagist version](https://camo.githubusercontent.com/f58e5f0344cb3efeb983beb76a3fcd72da6005eef901699ddfeef79d62be4485/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f70657466696e6465722d636f6d2f70657466696e6465722d7068702e737667)](https://packagist.org/packages/petfinder-com/petfinder-php)[![Coverage Status](https://camo.githubusercontent.com/16c6b46da4ef20b8278530ae9d4ddae94ef86e34e529af860df7dceae028de2f/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f70657466696e6465722d636f6d2f70657466696e6465722d7068702d73646b2f62616467652e7376673f6272616e63683d66656174757265253246636f766572616c6c73)](https://coveralls.io/github/petfinder-com/petfinder-php-sdk?branch=feature%2Fcoveralls)

A simple wrapper for the Petfinder API, written in PHP.

Uses [Petfinder API v2](https://www.petfinder.com/developers/v2/docs/).

Features
--------

[](#features)

- Uses HTTPlug
- Supports Async requests
- Well tested

Requirements
------------

[](#requirements)

- PHP >= 7.1
- A [HTTPlug Async client](https://packagist.org/providers/php-http/async-client-implementation)
- A [PSR-7 implementation](https://packagist.org/providers/psr/http-message-implementation)

Install
-------

[](#install)

In addition to the Petfinder package, you'll need an [HTTPlug](http://docs.php-http.org/en/latest/httplug/users.html)client that support async requests. We recommend using `php-http/guzzle6-adapter`, but you are free to use whatever one works for you.

```
composer require petfinder-com/petfinder-php php-http/guzzle6-adapter

```

Usage
-----

[](#usage)

Basic usage

```
$client = new \Petfinder\Client('my-api-key', 'my-api-secret');

$client->animal->search(['type' => 'Dog']);
```

Using async requests

```
$client = new \Petfinder\Client('my-api-key', 'my-api-secret');

$client->organization->searchAsync()->then(function (\Petfinder\Result $result) {
    // Do something with $result
})->catch(function (\Petfinder\Exception\ProblemDetailsException $exception) {
    // Do something with $exception
});
```

Using a custom Httplug client

```
$builder = new \Petfinder\Http\Builder($myHttpClient);
$client = new \Petfinder\Client('my-api-key', 'my-api-secret', $builder);
```

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 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 ~3 days

Total

3

Last Release

2653d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6b7bb02bd7aebd8ca0d722ceb4162a00dc9b0e523ce9b5eb7b88d8fef6bff43f?d=identicon)[mloberg](/maintainers/mloberg)

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

---

Top Contributors

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

---

Tags

petfinderpetfinder-apianimalsPetfinderpets

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/petfinder-com-petfinder-php/health.svg)

```
[![Health](https://phpackages.com/badges/petfinder-com-petfinder-php/health.svg)](https://phpackages.com/packages/petfinder-com-petfinder-php)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.2k532.1M2.5k](/packages/aws-aws-sdk-php)[brd6/notion-sdk-php

Notion SDK for PHP

6021.6k](/packages/brd6-notion-sdk-php)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.8M712](/packages/sylius-sylius)[telnyx/telnyx-php

Official Telnyx PHP SDK — APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network.

35729.6k2](/packages/telnyx-telnyx-php)[m4tthumphrey/php-gitlab-api

GitLab API v4 client for PHP

9515.7M72](/packages/m4tthumphrey-php-gitlab-api)[phpro/http-tools

HTTP tools for developing more consistent HTTP implementations.

28146.3k](/packages/phpro-http-tools)

PHPackages © 2026

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