Welcome to the RescueGroups.org HTTP API!

The RescueGroups.org HTTP API is the only one of its kind – a powerful platform for data management and public data searches.

The RescueGroups.org HTTP API is the ONLY updatable animal data API available.  In fact, there are a lot of reasons that the RescueGroups.org is the best API to use for your project.

For additional information about the API, or to request your own public API key, please visit our API service page: http://www.rescuegroups.org/services/adoptable-pet-data-api/

If you plan to use public data you should request a RescueGroups.org API key. It is not recommended to use your RescueGroups.org user name to query public data!

Overview

The HTTP API receives and responds with data in JSON format via an HTTP POST.  Most programming languages have built-in JSON encoding and decoding functions.

Please see below for additional information and examples on how to query for public and private data using the API.

Here are the major components of the RescueGroups.org HTTP API:

API requests for public information

See the examples page for additional information on public searches.

Public access is granted to some data in the RescueGroups.org system.  This includes public animal information and public organization information.

To use the HTTP API for animal and organization queries you need only an API Key.  You do not need to login to the HTTP API or create a token to access public data if you have an API Key.  You can request an API Key from theAdoptable Pet Data API page.

A lot of public information is available from the RescueGroups.org API including:

API requests for private information (and data updates)

See the examples page for additional information on private searches.

Access to non-public information requires a valid RescueGroups.org account, as well as a valid user name and password and permission to the object/information you are requesting.

Before you can request non-public information you will need to authenticate.  Authentication is done with the login action, and then the token and token hash values you receive must be sent with each request that requires authentication.

See the login page for more information on the login request and response.

Using your RescueGroups.org account number, user name and password, you can gain access to the RescueGroups.org platform, including:

Sending an HTTP API request

Sending a response to the HTTP API is very simple.  In your favorite programming language, create an array of the data you want to send.  Encode that data in JSON format, and POST the data via HTTPS.

The HTTP API uses only HTTP POST requests (the API will not respond to GET requests).

See the appropriate User Guide pages for the format of the data to submit for the object or action you are trying to perform.  The required data is different between most actions and objects.

With PHP you could create an array and encode the array into JSON format using the json_encode() function. 

To perform the HTTP POST with PHP you can use the curl libraries.

The URL for the HTTP API is:
https://api.rescuegroups.org/http/v2.json

Handling an HTTP API response

Responses from the HTTP API will be in JSON format.  Decode the response and handle the data as appropriate with your favorite programming language.

See the appropriate User Guide pages for the format of the response data action you are trying to perform.  The response is different between most actions.

With PHP you could decode the JSON response using the json_decode() function.