PHPackages                             ardent-africa/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. ardent-africa/sdk

ActiveLibrary[API Development](/categories/api)

ardent-africa/sdk
=================

Typed, read-only PHP client for the Ardent Africa public API (/public/v1).

v1.0.0(today)00MITPHPPHP >=7.4

Since Jun 26Pushed todayCompare

[ Source](https://github.com/mdYoungDOer/ardent-africa-sdk-php)[ Packagist](https://packagist.org/packages/ardent-africa/sdk)[ Docs](https://docs.ardent.africa/docs/developers/sdks)[ RSS](/packages/ardent-africa-sdk/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (2)Used By (0)

ardent-africa/sdk (PHP)
=======================

[](#ardent-africasdk-php)

A tiny, **read-only** PHP client for the [Ardent Africa public API](https://docs.ardent.africa/docs/developers) (`/public/v1`). Campaigns, petitions, events, marketplace listings, blog posts, public profiles, and platform stats. No write access, no PII. Depends only on `ext-curl` and `ext-json` — no third-party packages.

Install
-------

[](#install)

```
composer require ardent-africa/sdk
```

Requires PHP 7.4+.

Usage
-----

[](#usage)

```
require 'vendor/autoload.php';

use Ardent\Sdk\Client;
use Ardent\Sdk\ArdentApiException;

// The key is optional (keyless works at a lower rate tier). Create one at
// https://ardent.africa/dashboard/developer
$ardent = new Client(['api_key' => getenv('ARDENT_API_KEY')]);

$page = $ardent->listCampaigns(['limit' => 5, 'category' => 'Education']);
foreach ($page['data'] as $campaign) {
    echo $campaign['title'], "\n";
}

$campaign = $ardent->getCampaign('clean-water-for-tamale');
$stats    = $ardent->getStats();
```

Methods return the decoded JSON as associative arrays. List endpoints return `['data' => [...], 'page' => int, 'limit' => int, 'total' => int]`.

### Methods

[](#methods)

`listCampaigns` · `getCampaign` · `listPetitions` · `getPetition` · `listEvents` · `getEvent` · `listServices` · `getService` · `listCategories` · `listBlog` · `getBlogPost` · `getProfile` · `getStats`.

### Errors

[](#errors)

Non-2xx responses throw an `ArdentApiException` carrying the API error envelope:

```
try {
    $ardent->getCampaign('does-not-exist');
} catch (ArdentApiException $e) {
    $e->apiCode;    // e.g. 'NOT_FOUND'
    $e->httpStatus; // e.g. 404
    $e->ref;        // support reference, or null
    $e->getMessage();
}
```

### Options

[](#options)

```
new Client([
    'api_key'  => 'ardent_pk_…',                          // optional
    'base_url' => 'https://api.ardent.africa/public/v1',  // override for staging
]);
```

Develop
-------

[](#develop)

```
composer test   # runs the dependency-free harness in tests/
# or directly:
php tests/client_test.php
```

The response shapes mirror the published [OpenAPI contract](https://api.ardent.africa/public/v1/openapi.json); the API is additive within `v1`, so treat response arrays as open.

License
-------

[](#license)

MIT

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity33

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

Unknown

Total

1

Last Release

0d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/34683395?v=4)[Mawuli Dzaka](/maintainers/DeYoungDOer)[@DeYoungDOer](https://github.com/DeYoungDOer)

---

Top Contributors

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

---

Tags

apisdkardentfundraisingGhanapetitionsardent-africa

### Embed Badge

![Health badge](/badges/ardent-africa-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/ardent-africa-sdk/health.svg)](https://phpackages.com/packages/ardent-africa-sdk)
```

###  Alternatives

[deepseek-php/deepseek-php-client

deepseek PHP client is a robust and community-driven PHP client library for seamless integration with the Deepseek API, offering efficient access to advanced AI and data processing capabilities.

46784.5k5](/packages/deepseek-php-deepseek-php-client)[jstolpe/instagram-graph-api-php-sdk

Instagram Graph API PHP SDK

138106.8k2](/packages/jstolpe-instagram-graph-api-php-sdk)

PHPackages © 2026

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