Developer Resources

Abenity Perks API

The Abenity Perks API is a RESTful interface that allows you access your discount offers as JSON-formatted data, suitable for integration into your existing software.

API Usage is governed by the API Terms.

Contents:

Introduction

Getting Started

To get started developing with the Abenity Perks API you will need to meet the following requirements:

  1. Have an active account that supports Perks API integration. Sign Up Now.
  2. Have Perks API credentials. These can be obtained from your Client Executive.

Security

In order to provide our clients and their members with the most secure system, the latest encryption technology must be used in order to interact with our API. Currently, this means using TLS v1.1 or higher to encrypt your HTTPS connection to the API. If your system uses outdated encryption technology you will receive a HTTP "426 Upgrade Required" error response.

Authentication

API requests are authenticated using HTTP Basic Authentication. The username, which is essentially an API key, must be requested from your Client Executive (This will be different than any other usernames within your program). The password will always be clientapp.

Rate Limit

There is currently no rate limit. However, if Abenity believes that an IP address is abusing the API, then the offending address may be blocked.

Sample Application

Below is an example of how the Perks API can be used to display category navigation and offers featuring the vendor's name and logo. Offers are linked to the Perks program and can even be integrated with Single Sign-On and deep linking to authenticate your members and take them directly to the offer redemption instructions.

View Full Screen

Methods

All API requests should originate from your Perks Program's domain, i.e. if you access your Abenity Perks at https://acme.abenity.com, then all API requests should also be sent to acme.abenity.com over HTTPS.

Each of these endpoints will return a Last-Modified and Expires HTTP header to indicate the currency of the data.

Categories

GET /perks/api/v1/feed/categories.json

This endpoint will return an object containing all of the offer categories in your Discount Program.

Example
# Request
curl -X GET -u X3dh4BdWpzny9Vm65ZnwIsRTkdMX5UAw:clientapp \
    https://acme.abenity.com/perks/api/v2/feed/categories.json

# Response
HTTP/1.1 200 OK
[
    {
        "id": "322",
        "key": "Attractions_and_Tours",
        "title": "Attractions & Tours",
        "offer_count": 406,
        "children": [
            {
                "id": "339",
                "key": "Attractions_and_Tours/Dinner_Theaters",
                "title": "Dinner Theaters",
                "offer_count": 9,
                "children": null
            },
            {
                "id": "347",
                "key": "Attractions_and_Tours/Experiences",
                "title": "Experiences",
                "offer_count": 21,
                "children": null
            },
            {
                "id": "340",
                "key": "Attractions_and_Tours/Museums",
                "title": "Museums",
                "offer_count": 60,
                "children": null
            },
            {
                "id": "397",
                "key": "Attractions_and_Tours/Ski_Resorts",
                "title": "Ski Resorts",
                "offer_count": 8,
                "children": null
            },
            {
                "id": "341",
                "key": "Attractions_and_Tours/Tours_and_Sightseeing",
                "title": "Tours & Sightseeing",
                "offer_count": 152,
                "children": null
            },
            {
                "id": "342",
                "key": "Attractions_and_Tours/Water_Parks_and_Theme_Parks",
                "title": "Water Parks & Theme Parks",
                "offer_count": 116,
                "children": null
            },
            {
                "id": "343",
                "key": "Attractions_and_Tours/Zoos_and_Aquariums",
                "title": "Zoos & Aquariums",
                "offer_count": 40,
                "children": null
            }
        ]
    },
    {
        "id": "4",
        "key": "Automotive",
        "title": "Automotive",
        "offer_count": 13251,
        "children": [
            {
                "id": "98",
                "key": "Automotive/Accessories",
                "title": "Accessories",
                "offer_count": 1644,
                "children": null
            },
            {
                "id": "412",
                "key": "Automotive/Auto_Loans",
                "title": "Auto Loans",
                "offer_count": 1,
                "children": null
            },
            {
                "id": "165",
                "key": "Automotive/Gas_Stations",
                "title": "Gas Stations",
                "offer_count": 163,
                "children": null
            },
            {
                "id": "50",
                "key": "Automotive/Maintenance_and_Repair",
                "title": "Maintenance & Repair",
                "offer_count": 10732,
                "children": null
            },
            {
                "id": "51",
                "key": "Automotive/New_and_Used_Cars",
                "title": "New & Used Cars",
                "offer_count": 561,
                "children": null
            },
            {
                "id": "108",
                "key": "Automotive/Roadside_Assistance",
                "title": "Roadside Assistance",
                "offer_count": 46,
                "children": null
            },
            {
                "id": "105",
                "key": "Automotive/Services",
                "title": "Services",
                "offer_count": 104,
                "children": null
            }
        ]
    }
    ...
]

Offers within a Category

GET /perks/api/v1/feed/offers.json

Get the discount offer listings within a specific category. You may use this information to advertise discount listings on your site. Use the "link" parameter in the response to direct your members to the full offer listing with redemption instructions within your program.

Parameter Definition Example
category_id or category_key

Use the id or key returned from the Categories endpoint in order to get the offers within that category.

105 or Automotive/Services
Example
# Request
curl -X GET -u X3dh4BdWpzny9Vm65ZnwIsRTkdMX5UAw:clientapp \
    https://acme.abenity.com/perks/api/v2/feed/offers.json?category_id=4

# Response
HTTP/1.1 200 OK
[
    {
        "vendor": {
            "name": "Windshield Replacers",
            "id": 123
        },
        "offers": [
            {
                "category_id": "50",
                "exp_date": "2017-07-03",
                "locations": [
                    {
                        "name": "",
                        "address": "495 1st Street",
                        "city": "Idaho Falls",
                        "state": "ID",
                        "zip": "83401",
                        "country": "US",
                        "latitude": "43.497135",
                        "longitude": "-112.024162",
                        "coordinate_accuracy": "address",
                        "arcgis_score": null,
                        "phone": "208-525-3230",
                        "fax": "",
                        "id": "107508475"
                    }
                ],
                "days_old": 65,
                "id": "106398676",
                "title": "FREE Chip Repair with your comprehensive insurance",
                "link": "https://acme.abenity.com/perks/offer/10:1662479"
            },
            {
                "category_id": "50",
                "exp_date": "2017-07-03",
                "locations": [
                    {
                        "name": "",
                        "address": "495 1st Street",
                        "city": "Idaho Falls",
                        "state": "ID",
                        "zip": "83401",
                        "country": "US",
                        "latitude": "43.497135",
                        "longitude": "-112.024162",
                        "coordinate_accuracy": "address",
                        "arcgis_score": null,
                        "phone": "208-525-3230",
                        "fax": "",
                        "id": "107508475"
                    }
                ],
                "days_old": 65,
                "id": "106398677",
                "title": "$24.95 Cash Chip Repair",
                "link": "https://acme.abenity.com/perks/offer/10:1662480"
            },
            {
                "category_id": "50",
                "exp_date": "2017-07-03",
                "locations": [
                    {
                        "name": "",
                        "address": "495 1st Street",
                        "city": "Idaho Falls",
                        "state": "ID",
                        "zip": "83401",
                        "country": "US",
                        "latitude": "43.497135",
                        "longitude": "-112.024162",
                        "coordinate_accuracy": "address",
                        "arcgis_score": null,
                        "phone": "208-525-3230",
                        "fax": "",
                        "id": "107508475"
                    }
                ],
                "days_old": 65,
                "id": "106398678",
                "title": "Up to $150 Cash Back on your Windshield Replacement",
                "link": "https://acme.abenity.com/perks/offer/10:1852274"
            }
        ]
    }
    ...
]
Abenity A

Request a Live Demo

I’m Missy Dunn, our V.P. of Client Sales here at Abenity. I’d love to know more about your organization and discuss how we can help with your member, alumni, or employee perks. Let’s talk!

Missy Dunn, Director of Sales
Powered by:
GoToMeeting Logo

Take a Self-Guided Tour of Abenity

With these short videos led by Brian Roland, Abenity’s Co-Founder and CEO, you’ll learn more about how we do things here at Abenity and why we care so much about perks. After viewing, you’ll have free access to tour our program, download our mobile apps, and check out our perks.

INTRO (1:07)

SIMPLE (1:08)

TRANSPARENT (1:58)

SAVINGS (2:22)


Start Your Tour

Select Topics of Interest:

Enjoy a side-by-side comparison of our discounts against other providers in our industry, including AAA and AARP.

Optucorp USA
Quiznos
Grocery Coupons
HSAstore.com
Collette: 150 Tours, 7 Continents
Abenity Cruises
Avis Car Rental
Member Auto Buying Program - Powered by TrueCar
TrueCar
Budget Rent A Car

Log In

Watch Our Story Video

Loading video…