- Send them this link and ask them to click the "Request access" button (they will need use the Google Chrome browser and be logged into a Google account first)
- Send an email to us at firstname.lastname@example.org with your developer's Google account email address so we know which organization they are associated with and can approve the request (they can also email us directly and cc you)
- All Animals
- Gives a list of all animals that were ever “intaked” by the shelter.
- Allows the result set to be filtered based on two types of animal statuses - ‘in custody’ statuses and ‘published’ statuses.
- URL: https://www.shelterluv.com/api/v1/animals
- Animal Details
- Fetches the animal record based on the id passed in request url, and gives all details of the animal.
- URL: https://www.shelterluv.com/api/v1/animals/:id
- All People
- Gives a list of all people records created by the shelter.
- Allows the result set to be filtered to include only those people who have adopted some animal from the shelter.
- URL: https://www.shelterluv.com/api/v1/people
- Person Details
- Fetches the person record based on the id passed in request url, and gives all details of the person.
- URL: https://www.shelterluv.com/api/v1/people/:id
- Gives a list of all intake and outcome events that happened in the shelter.
- URL: https://www.shelterluv.com/api/v1/events
- Events for a Specific Animal
- Gives a list of all intake and outcome events that happened in the shelter for a specific animal.
- URL: api/v1/animals/:id/events
- Gives a list of all vaccines that are scheduled, completed, or overdue by the shelter.
- URL: api/v1/vaccines
- Vaccines for a Specific Animal
- Gives a list of vaccines that are scheduled, completed or overdue by the shelter for a specific animal.
- URL: api/v1/animals/:id/vaccines
- Fetches a partner record based on the id passed in the request url.
- URL: https://www.shelterluv.com/api/v1/partners/:id
In order to use the API, you need to generate an API key. Your API key can be generated via Configuration under Uploads and Integrations. You can include a quick description of what you're using the API key for, just for your reference later. Learn more about generating API keys here.
Before your developers start any type of integration with the API, we suggest that you test the key and URL. This can be done via an app that you can download for Chrome browsers called Postman (please use the updated Postman Native app).
Postman is a tool for testing HTTP API credentials and testing how the API responds to different kinds of requests before you integrate the API into your own website. This helps your developers to get an idea of how to write code that will process the responses given by the API.
For instructions on how to get started with Postman, you can reference Postman's documentation here.
Once you have an account set up and the Postman Native app installed on your Chrome browser, you can test the API this way:
- Use whichever API URL that you're interested in testing in the GET request box.
- In the Headers section:
- Enter "X-Api-Key" in the first column for "key".
- Enter your API key (that you copied from Configuration) in the second column for "value".
- Click "Send".
Commonly Asked Questions
Are there parameters that can be used with the URLs? Can results be filtered via the URL?
Most endpoints of the API support pagination settings as parameters. The API's default is to limit returned results to 100 results. To customize that default pagination, add parameters "&limit=xx&offset=xx". The limit parameter indicates the number of results that will return on one page. The offset parameter is the index of the first record to display on a page. For example, if limit=10 and offset=10, this means your first page will show records 1-10 and your second page will show records 11-20.
The animal endpoint can be filtered by status type (with values "in custody" or "publishable").
The people endpoint can be filtered to display only those who have adopted an animal.
Adding other input values and filters are enhancements we plan to add in the future.
I'm seeing a default photo returned for the photo field and blank results for location. Why is that?
For fields like photos and videos, if the field is returning a generic photo, that means that that animal does not have any photos or videos.
When a location is returned with no result, that means that animal is in a foster location. The location field only returns onsite locations.