README

PHP SDK for Repull — the unified API for vacation-rental tech (50+ PMS platforms, Airbnb / Booking.com / VRBO / Plumguide channels, AI ops). Generated from OpenAPI. PHP 8.1+.

Status: v0.1.0 — alpha. Not yet on Packagist. API surface may break before v1.0.

Why a PHP SDK?

WordPress is the dominant CMS for direct-booking websites in the vacation-rental industry. If you're building a booking flow, channel-manager dashboard, or guest portal in PHP, the Repull PHP SDK is your on-ramp to:

50+ PMS / channel-manager integrations through one REST API
Airbnb, Booking.com, VRBO, Plumguide as native channels
Built-in AI for guest replies, intent classification, listing generation, dynamic pricing
White-label OAuth Connect flows

Install

Not on Packagist yet — install from git:

{
  "repositories": [
    { "type": "vcs", "url": "https://github.com/ivannikolovbg/repull-php" }
  ],
  "require": {
    "repull/sdk": "dev-main"
  }
}

composer update repull/sdk

Quick start

<?php
require __DIR__ . '/vendor/autoload.php';

use GuzzleHttp\Client;
use Repull\Api\ReservationsApi;
use Repull\Configuration;

$config = Configuration::getDefaultConfiguration()
    ->setAccessToken(getenv('REPULL_API_KEY'));

$api = new ReservationsApi(new Client(), $config);
$response = $api->v1ReservationsGet(limit: 10);

foreach ($response->getData() as $r) {
    printf(
        "%s  %s → %s  %s  %s %s\n",
        $r->getId(),
        $r->getCheckIn()?->format('Y-m-d'),
        $r->getCheckOut()?->format('Y-m-d'),
        $r->getPlatform(),
        $r->getTotalPrice(),
        $r->getCurrency()
    );
}

Run it:

REPULL_API_KEY=sk_test_... php examples/quickstart.php

Authentication

All requests require a Bearer token. Sandbox keys start with sk_test_, production with sk_live_. Get a key at https://repull.dev/dashboard.

$config = Configuration::getDefaultConfiguration()
    ->setAccessToken('sk_test_...');

Examples

File	What it does
`examples/quickstart.php`	List the latest 10 reservations
`examples/connect_airbnb.php`	Mint an Airbnb OAuth Connect session

What's in the box

14 API classes covering every endpoint of the Repull API:

AIApi, AirbnbApi, AvailabilityApi, BillingApi, BookingComApi, ConnectApi, ConversationsApi, GuestsApi, PlumguideApi, PropertiesApi, ReservationsApi, SystemApi, VRBOApi, WebhooksApi.

Plus typed model classes for Property, Reservation, Guest, CalendarDay, Conversation, Message, Connection, WebhookSubscription, etc.

Full reference: https://repull.dev/docs.

Regenerating from OpenAPI

The SDK is generated from the live spec at https://api.repull.dev/openapi.json using the php-nextgen generator:

./scripts/regen.sh
php scripts/relax-enums.php  # forward-compat patch for enum drift
composer phpstan

scripts/relax-enums.php rewrites strict enum validators in generated models so the SDK accepts unknown values gracefully — necessary because the spec occasionally lags what the live API returns.

Versioning

The SDK version tracks the OpenAPI document version. The current snapshot is committed at openapi/v1.json.

License

MIT — see LICENSE.

Other Repull SDKs

repull-sdk — TypeScript SDK + interactive demo
repull-python — Python SDK
repull-go — Go SDK
repull-ruby — Ruby SDK
repull-dotnet — .NET SDK

repull / sdk

Maintainers

Package info

Statistics

Security