PHPackages                             reason-digital/virgin-money-giving-api - 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. reason-digital/virgin-money-giving-api

ActiveLibrary[API Development](/categories/api)

reason-digital/virgin-money-giving-api
======================================

Provides a PHP library for interacting with the Virgin Money Giving API.

1.0.2(7y ago)0323[5 issues](https://github.com/reason-digital/virgin-money-giving-api/issues)MITPHPCI failing

Since Jun 1Pushed 6y ago1 watchersCompare

[ Source](https://github.com/reason-digital/virgin-money-giving-api)[ Packagist](https://packagist.org/packages/reason-digital/virgin-money-giving-api)[ Docs](https://github.com/reason-digital/virgin-money-giving-api)[ RSS](/packages/reason-digital-virgin-money-giving-api/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (5)Versions (4)Used By (0)

[![Build Status](https://camo.githubusercontent.com/99a27a317e307346ab909d9fd00aee141abf6f0e4981d5e72273387f8b25bba0/68747470733a2f2f7472617669732d63692e6f72672f726561736f6e2d6469676974616c2f76697267696e2d6d6f6e65792d676976696e672d6170692e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/reason-digital/virgin-money-giving-api)

[![Coverage Status](https://camo.githubusercontent.com/d844a253469c7369fd2ee6ead6d1821852154e7d58bc0920b11e6b7e37094dab/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f726561736f6e2d6469676974616c2f76697267696e2d6d6f6e65792d676976696e672d6170692f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/reason-digital/virgin-money-giving-api?branch=master)

README
======

[](#readme)

Provides a PHP library for interacting with the Virgin Money Giving API.

This library will help with pushing and pulling data from the API. Unfortunately the API has quite a few undocumented quirks that this library hopes to stop developers falling into.

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

[](#prerequisites)

### API Keys

[](#api-keys)

To interact with the VGM API you will need to get API keys. To do this you'll need to register on the site ().

You will need to create an application here on the Apps overview page: /apps/myapps.

Then on your keys overview page you can grab your API key: /apps/mykeys.

For some reason you will need different API keys for different API calls. The list can be found here:

[https://developer.virginmoneygiving.com/our\_apis](https://developer.virginmoneygiving.com/our_apis)

### Test data

[](#test-data)

When testing against the Sandbox there are a few bits of test data already setup:

#### Charities

[](#charities)

NameResource IDCharity26a5880c9-13e4-4cf4-987e-931f3899b9d5Cancer Charity8da32779-1c1b-4d20-8714-df3219836618#### Fundraisers

[](#fundraisers)

@todo - If there are any

#### Events

[](#events)

@todo - Grab some default ones

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

[](#installation)

Install the latest version with:

```
$ composer require reason-digital/virgin-money-giving-api
```

Usage
-----

[](#usage)

### Fundraiser search

[](#fundraiser-search)

To use the fundraiser search you'll need to use your fundraiser developer API key. Any other key will return a 403 response.

```