Welcome

PetHub is one of the most trusted platforms for managing a companion animal’s data. With millions of pets on the website in the U.S., and 600-800 new pets added daily, the ecosystem is quickly growing to be the one place for pet owners to go when finding solutions to help raise happy and healthy animals.

Apply for Access

To apply for access to the PetHub API, please submit a proposal outlining what kind of application you would like to create that would be used by the PetHub community.

Get An API Key

Available Data

The PetHub API provides access to a pet owner’s data with their explicit permission. A pet owner is able to turn on and off access per application in the event they choose to no longer make use of an integrated website or mobile application. They may also scope what data is available for each application to allow them to fully control their data.

At the end of the day, it is the pet owner’s data and we are merely trusted stewards of that data. We take that responsibility seriously.

Terms of Use

Our Terms of Use ("API Terms") are heavily weighted to protecting PetHub's users and their data. The purpose of exposing these APIs is to enable web and mobile application developers to positively enhance pet owners' lives and experiences through leveraging data they have already entered and maintain at PetHub.com. In most cases we will act as the back-end database for mobile developers. In other cases, we are helping to simplify the user experience when a PetHub user chooses to explicitly share their data with a partner service. At the end of the day, however, it is critical that all involved acknowledge and respect that we are merely stewards of this data. If this is not a canon to which you can subscribe, then please do not submit an application to access our Application Programming Interface.

API Recent Info

Getting Started

It's always fun -- even if a bit daunting -- when starting a new project especially with a variety of APIs and philosophies for creating RESTful web services. We've documented our approach for this PetHub version 1 in, "PetHub Open API v1.0 -- Approach." The purpose of this Getting Started page is to give you a high-level view of how we've organized the documentation, where to find samples to leverage in building your own PetHub-enabled apps & integrations, and community to offer further guidance to one another as we continue to improve this open API. We suggest you start with the API Calls section first.

API Calls

The PetHub API (Application Programming Interface) allows you to access the PetHub database of nearly 1-million pets. You can use the API to build your own mobile applications or dynamic websites where PetHub acts as your back-end database. Our goal is to be the pet owner's "single source of truth" for managing their pet's data and allowing them to share their pet's data outside of PetHub in a safe and secure manner with trusted applications and services.

Authentication

PetHub uses OAuth for secure authentication. To get started you need to: 1) Submit an API Key Request form, 2) Create a PetHub.dev account (invitation only - details provided when API key is assigned), and, 3) Send requests to our servers with proper authentication (e.g. you can use cURL for testing).

API Requests

With a few exceptions, the PetHub API is generally accessed through HTTP request methods (e.g. GET, POST, PUT/PATCH, DELETE) that follow a general pattern:

API Responses

In the case of our favorite original tester, Grizzly, requesting his information would take the following form: curl -H "Authorization: Bearer abc123" GET https://pethub.io/v1/pets/223 -- The above authorized call to PetHub.io's "/v1/pets/{id}" endpoint with Grizzly's unique identifier (where "223" replaces the "{id}") would receive the following response: