Version 5 of the API is currently under development.  On 2/15/18, we released an alpha developer preview of API v5. This is a very early release involving only the Animals endpoint.

On 10/5/19 we released a major update to the v5 API.  Please see the notes below.

On 1/24/20 we released a minor update to the v5 API.  This update involved mostly changes to the backend.  Please see the notes below.

This API will change in the coming months.  We would greatly appreciate your feedback and ideas for improvement.  However, perform development at your own risk.  We would expect changes to be relatively minor, but there's no guarantee.

Full API documentation

Please visit the full API documentation (for the Production environment):

Please visit the full API documentation (for the Test environment):

The Test environment is a copy of production data. However, this copy may be several days or weeks old and should not be considered valid. You are not permitted to use data you retrieve from the Test servers in any production (publicly accessible) service or website.

Changes and improvements of note

Improvements/changes made with the update on 10/5/19

Improvements/changes made with the update on 1/24/20

Swagger definition available soon

Coming soon!  You can download an early draft of our Swagger definition for the public API endpoints.

To open the definition go to the Swagger Editor and click File > Import URL and paste the URL above, once it's available.

Postman collection available

We have a public Postman collection available to help you with examples.

Developer community

Please join our developer community in Google Groups:!forum/apidev

Common questions

Question: When will this version of the API be available in production?

We don't have any ETA for production release yet. Please note, we do have a production environment URL that should be used if you choose to use this API to display data on publicly available websites.

Question: Will the current APIs (v2 and the REST API) be deprecated?

Yes, we expect to discontinue use of the current APIs as some time after v5 goes live.  We will provide plenty of notice beforehand.  We expect to have multiple APIs running in production for a year or more.