PHPackages                             skiddle/skiddle-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. skiddle/skiddle-php-sdk

ActiveLibrary[API Development](/categories/api)

skiddle/skiddle-php-sdk
=======================

PHP Wrapper for Skiddle API

v3.0.3(2y ago)224.6k↓38.6%[1 issues](https://github.com/Skiddle/skiddle-php-sdk/issues)MITPHPPHP &gt;=5.4.0 || ^7.0

Since Nov 24Pushed 2y ago2 watchersCompare

[ Source](https://github.com/Skiddle/skiddle-php-sdk)[ Packagist](https://packagist.org/packages/skiddle/skiddle-php-sdk)[ Docs](https://github.com/Skiddle/skiddle-php-sdk)[ RSS](/packages/skiddle-skiddle-php-sdk/feed)WikiDiscussions master Synced 1mo ago

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

Skiddle PHP SDK
===============

[](#skiddle-php-sdk)

---

The purpose of the SDK is to allow for easy access to the Skiddle API. This will allow developers to easily communicate with the Skiddle API to pull through information about events, artists and venues

---

Table of contents
-----------------

[](#table-of-contents)

1. [Requirements](#requirements)
2. [Installation](#installation)
    1. [Download the SDK](#download)
    2. [Get an API Key](#apikey)
    3. [Integrate](#integrate)
3. [Examples](#examples)
    1. [Authenticate Yourself](#authenticate)
    2. [Get the class Ready](#getready)
    3. [Add and Remove conditions](#addremove)
    4. [Get results](#results)
    5. [Get a single result](#resultsingle)
4. [Things to note](#notes)
5. [License](#license)
6. [Contact](#contact)

---

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

[](#requirements)

The API requires PHP &gt; 5.4.0, due to using autoloading and new array constructs. It also requires cURL to be enabled, which is normally done by default in PHP, but best to double check.

To connect to the API, TLS v1.2 or above is required. This has been supported by Curl using OpenSSL since version 1.0.1

---

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

[](#installation)

### Download the SDK

[](#download-the-sdk)

There are a couple of ways to get the SDK integrated to your project, the easiest way is probably via composer:

```
"require": {
    "skiddle/skiddle-php-sdk": "1.0.0"
}

```

You can also clone the git repository

```
git clone https://github.com/Skiddle/skiddle-php-sdk

```

Or, simply download the zip [here](https://github.com/Skiddle/skiddle-php-sdk/archive/master.zip) and unzip to your project.

If using either of the last two methods, you will need to include the `autoloader.php` file in your project to load everything up

### Get an API Key

[](#get-an-api-key)

Getting an API key is simple and free, simply go to  to get one now

### Integrate

[](#integrate)

Once you have the code and an API key, you are ready to get started!!

---

Examples
--------------------------------------------

[](#examples)

You can view code samples in the `/demo/` directory included in the repo

### Authenticate yourself

[](#authenticate-yourself)

The first step is to simply authenticate yourself - just tell the SDK what your API Key is

```
try {
    $session = new SkiddleSDK\SkiddleSession(['api_key'=>'APIKEYGOESHERE']);
} catch (SkiddleSDK\SkiddleException $e) {
    echo $e->getMessage();
    exit();
}
```

If you don't want to store this in your code, you can add it to your server environment as `SKIDDLE_API_KEY` and the SDK will read from there.

---

### Get the class Ready

[](#get-the-class-ready)

After you have successfully authenticated yourself, you then need to pass your credentials to the revelant class that you want to use. This combines your authentication info with the endpoint necessary to make the calls.

To do this, simply call the setSession() method of the class you wish to use:

```
$events = new SkiddleSDK\Events;
try {
    $events->setSession($session);
} catch (SkiddleSDK\SkiddleException $e) {
    echo $e->getMessage();
    exit();
}
```

---

### Add and Remove conditions

[](#add-and-remove-conditions)

You are now ready to make calls to the API. You can now technically make a call to return listings, however the Skiddle SDK allows you to easily add or remove conditions to make your query specific to your needs.

To add a condition, you just need to pass the field and value in the `addCond()` method:

```
$events->addCond('eventcode','CLUB');
$events->addCond('ticketsavailable','1);
```

Likewise, to remove conditions, just use the `delCond()` method, using only the field name:

```
$events->delCond('ticketsavailable');
```

### Get Results

[](#get-results)

Once you have built up your filter list, you can then get your listings!

```
$listings = $events->getListings();

foreach($listings->results as $result) {...}
```

For a full list of arguments you can filter by, [have a look here](https://github.com/Skiddle/web-api/)

### Get a single result

[](#get-a-single-result)

If you need to get a single result, you can call `getListing()`, without having to build an array of arguments - just pass the relevant ID

For example:

```
$listing = $events->getListing(12345);

var_dump($listing);
```

Things to note
===============================================

[](#things-to-note)

1. When querying eventcodes, try to keeo values uppercase. Passing CLUB will work, whereas passing club may return an error
2. When using the minDate and maxDate conditions, timestamps need to be in either `Y-m-d` or `Y-m-dTH:i:s` format.
3. Don't like objects? You can get results in array format by passing a boolean in `getListings()`: ```
    $listings = $events->getListings(true);

    foreach($listings['results'] as $result) {...}
    ```
4. Check back for more

---

License
==========================================

[](#license)

This SDK is licensed under the GNU General Public License v3.0. [View the license here](LICENSE)

---

Contact
==========================================

[](#contact)

Got any questions, or ways to improve the SDK? Feel free to log an issue, or pull and fork as much as you want!

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance10

Infrequent updates — may be unmaintained

Popularity29

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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

Recently: every ~371 days

Total

11

Last Release

852d ago

Major Versions

v1.1.6 → v3.0.12024-01-17

### Community

Maintainers

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

---

Top Contributors

[![michaelsmedley](https://avatars.githubusercontent.com/u/2039847?v=4)](https://github.com/michaelsmedley "michaelsmedley (7 commits)")[![mikeskiddle](https://avatars.githubusercontent.com/u/23717582?v=4)](https://github.com/mikeskiddle "mikeskiddle (6 commits)")[![JasonButler79](https://avatars.githubusercontent.com/u/115630308?v=4)](https://github.com/JasonButler79 "JasonButler79 (5 commits)")[![bensebborn](https://avatars.githubusercontent.com/u/160988?v=4)](https://github.com/bensebborn "bensebborn (4 commits)")[![daparky](https://avatars.githubusercontent.com/u/1004912?v=4)](https://github.com/daparky "daparky (1 commits)")

---

Tags

phpsdkskiddle

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/skiddle-skiddle-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/skiddle-skiddle-php-sdk/health.svg)](https://phpackages.com/packages/skiddle-skiddle-php-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.

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

Instagram Graph API PHP SDK

13998.4k2](/packages/jstolpe-instagram-graph-api-php-sdk)[octw/aramex

A Library to integrate with Aramex APIs

2925.2k](/packages/octw-aramex)[jeffreyhyer/bamboohr

PHP SDK for the BambooHR API

1077.3k1](/packages/jeffreyhyer-bamboohr)

PHPackages © 2026

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