Vetspace API

Welcome to the V2 API.

This section is designed to host an array of useful information, tools and examples on how to use this API

The API is based upon Swagger IO / Open API set of tools, and we have provided the Public YAML Document as well as Documentation

Please use the navigation above to find out more about the API, and please feel free to Provide Feedback!

General API Information

This API is an Applications Programming Interface, and is intended for consumers who wish to automate some aspects of managing their data.

It's a REST API and is based on the popular Swagger Framework.

Encoding: The encoding that's used in the API is UTF-8, and you should ensure that you set this encoding in connections made.

Provided with this kit is the following :-

Next Steps

Access to the API can be provided, please contact support@vetspace.com to arrange for access.

About The APIs

Authentication Service

The authentication service provides methods for acquiring access tokens that give you access to all other services.

The login method must be called with valid api keys before you can call any method on any of the other services. This method will return an access token which must then be submitted on subsequent calls in the ApiToken header to prove you have been successfully authenticated. Access tokens have a limited lifespan and will need to be renewed periodically. This can be done by simply calling the login method again.

Some methods require you to act on behalf of a user and these require an extra level of authentication. For methods that require an ApiUserToken header you will first need to call the verifyUser method with the user's username and password. This method will return a user access token which can then be used to call these methods. User access tokens have a limited lifespan and will need to be renewed periodically.

Global Service

The Mobile Service is a general use service.

The global service allows for managing of global accounts. This service is required if you need to provide seamless functionality across multiple veterinary groups. This service provides methods for creating global accounts, connecting accounts to practices and sites and password management.

Mobile Service

The Mobile Service is a vet-facing service.

Exposes functionality required by the Vetspace mobile application.

Managed Bookings

The managed bookings service is a vet-facing service.

The managed bookings service allows you to create and manage appointments. It provides methods for searching clients, searching availability, creating, updating and cancelling appointments.

Registrations Service

This service is intended to enable Customers to create accounts with a veterinary group.

The registrations service provides the ability to register new clients with a veterinary group. This service provides a number of methods to retrieve data in order to build a registration form, such as lists of allowed titles, cities etc. There is also a method to see if a client with matching details already exists. Finally this service provides a method which will take the data gathered about the client and register that client with the veterinary group.

ClientLink Service

This service is an Customer facing service, providing information as a Customer to a practice.

The ClientLink service has methods for providing a portal experience, using a global registration system it allows customers access to their data at their vet.

This service also provides methods for enhancing a Vets website by providing access to information such as average waiting times and surgeon availability.

Powers the My Vets Diary application.

Clinical Portal Service

The clinical portal service is a vet-facing service.

This service allows retrieval of data in order to provide a portal of key information for the user, including appointments, prescriptions, reminders etc.

Help & Support

Help and support is available via the support team, and you also can try each API call via our Try It Yourself page

Access to the API can be provided, please contact support@vetspace.com to arrange for access.

Release Notes

Latest Release Notes.

November 2017

  • Mobile API Optimised
  • Prospect Bookings API released

March 2017

  • Updated forgotten password call in Auth API to use POST to be more consistent.
  • Added mobile API call retrieveDiariesForDay.
  • Marked two calls in Mobile API as deprecated.
  • Added group health checks and report.
  • Restricted list of groups to only ones your API key has permission to see
  • Logged in calls are restricted to the group your account is a member of
  • Managed Bookings - fixed to show better error messages
  • /v2/mobile/connectUserToPmsGroup - better checking for Vet User
  • /v2/global/updatePMSPassword/ updated error message to be more informative
  • /v2/global/connectNewUserToGroup/ - better error message shown when user is linked to group
  • /v2/global/captureUserInfo/ - better error message
  • /v2/global/captureUserInfo/ - better model for form to submit for API
  • GAPI-220 - Added statusFlag to retrieveFullList call from mobile API
  • GAPI-212 - Take out any raw errors from API

February 2017

  • Added uploadDocument call to Mobile API
  • Updated retrieveTreatmentCodes to be faster via optimisation
  • Added PUT support for call to bridge API
  • Added Uploaded Document Management for Mobile API
  • Added uploadTreatmentItems call to Mobile API
  • Added uploadAppointmentItems call to Mobile API
  • Added uploadPaymentItems call to Mobile API
  • Added Demo Page for Mobile API
  • Added change password call to Auth API
  • Added forgotten password call to Auth API

December 2016

  • Implemented OAuth 2.0 to secure APIs
  • Added Clinical Portal API
  • Added method to see if a client already exists to the registrations API

November 2016

  • Added Mobile API documentation
  • Added Managed Bookings API
  • Added Registrations API
  • Updated examples added to both global and registrations
  • New Registrations Form added

October 2016

  • Added new working examples to the examples tab
  • Added calls to registrations API
  • Added checked exceptions to AvgWaitForSite call
  • Try it yourself examples added and javascript fixed
  • New JMeter Unit tests added for all call types
  • New template created for the generated documentation
  • iframed example screens removed from build
  • New Registrations API created

If you have any questions about the API or usage, please contact support@vetspace.com.