PHPackages                             generatorlabs/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. [Logging & Monitoring](/categories/logging)
4. /
5. generatorlabs/sdk

ActiveLibrary[Logging & Monitoring](/categories/logging)

generatorlabs/sdk
=================

A PHP wrapper for the Generator Labs API

v2.0.0(2mo ago)00MITPHPPHP >=8.1.0CI passing

Since Mar 27Pushed 1mo agoCompare

[ Source](https://github.com/generator-labs/php-sdk)[ Packagist](https://packagist.org/packages/generatorlabs/sdk)[ Docs](https://generatorlabs.com)[ RSS](/packages/generatorlabs-sdk/feed)WikiDiscussions master Synced 1w ago

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

Generator Labs PHP SDK
======================

[](#generator-labs-php-sdk)

[![Tests](https://github.com/generator-labs/php-sdk/actions/workflows/tests.yml/badge.svg)](https://github.com/generator-labs/php-sdk/actions/workflows/tests.yml)[![codecov](https://camo.githubusercontent.com/44907971ec1fabb32b42fe3a39476ad687ed18235eb28d4157344b2ce7a0ba80/68747470733a2f2f636f6465636f762e696f2f67682f67656e657261746f722d6c6162732f7068702d73646b2f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/generator-labs/php-sdk)[![PHPStan](https://camo.githubusercontent.com/d117944b58da8146f96b4ef7403807610a20eeb3fbcaaaf95157bbcdad1686eb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230382d627269676874677265656e2e737667)](https://phpstan.org/)[![PHP Version](https://camo.githubusercontent.com/04744bae0a61d2ffe29c26f07a9612eae20445fc6feaeb77b3af1f0e9be6447c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e312d3838393242462e737667)](https://www.php.net/)[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE)

The official PHP SDK for the [Generator Labs](https://generatorlabs.com) API v4.0.

Table of Contents
-----------------

[](#table-of-contents)

- [Features](#features)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Quick Start](#quick-start)
- [RBL Monitoring](#rbl-monitoring)
    - [List Hosts](#list-hosts)
    - [Get a Single Host](#get-a-single-host)
    - [Create a New Host](#create-a-new-host)
    - [Update a Host](#update-a-host)
    - [Delete a Host](#delete-a-host)
    - [Pause/Resume a Host](#pauseresume-a-host)
    - [Start a Manual RBL Check](#start-a-manual-rbl-check)
    - [Manage RBL Profiles](#manage-rbl-profiles)
    - [Manage RBL Sources](#manage-rbl-sources)
- [Contact Management](#contact-management)
    - [Manage Contacts](#manage-contacts)
    - [Manage Contact Groups](#manage-contact-groups)
- [Certificate Monitoring](#certificate-monitoring)
    - [List Certificate Errors](#list-certificate-errors)
    - [Manage Certificate Monitors](#manage-certificate-monitors)
    - [Manage Certificate Profiles](#manage-certificate-profiles)
- [Pagination](#pagination)
- [Webhook Verification](#webhook-verification)
- [Rate Limiting](#rate-limiting)
- [API Structure](#api-structure)
- [Development](#development)
- [Release History](#release-history)
- [Contributing](#contributing)
- [Support](#support)
- [License](#license)

Features
--------

[](#features)

- Full support for Generator Labs API v4.0
- Automatic retry logic with exponential backoff and `Retry-After` header support
- Configurable timeouts and retry behavior
- Automatic pagination support for large result sets
- RESTful endpoint design with proper HTTP verbs (GET, POST, PUT, DELETE)
- RBL and DNSBL monitoring
- Contact and contact group management
- Manual RBL checks
- Monitoring profiles and sources
- Type-safe with PHP 8.1+ strict types
- PHPStan level 8 static analysis
- Guzzle HTTP client with connection pooling
- PSR-4 autoloading

Prerequisites
-------------

[](#prerequisites)

Before using this library, you must have:

- A Generator Labs account - [Sign up](https://portal.generatorlabs.com/signup/) or [Login](https://portal.generatorlabs.com/login/)
- Valid API credentials (Account SID and Auth Token) from the [Portal](https://portal.generatorlabs.com/login/)
- PHP >= 8.1
- The PHP JSON extension
- Guzzle HTTP client (automatically installed via Composer)

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

[](#installation)

Install via Composer:

```
composer require generatorlabs/sdk
```

Quick Start
-----------

[](#quick-start)

### Initialize the Client

[](#initialize-the-client)

```