Overview


Welcome to the ProofHQ API

The ProofHQ API is a simple HTTP service that is secured using SSL. The API aims to provide you with all the functionality that used in our own application.

If you require help on the application functionality, please refer to the ProofHQ help pages.

Supported formats

The public interface is SOAP 1.1 compliant with WSDL support. All requests are therefore executed using XML over HTTPS.

API versioning

In order to preserve compatibility with existing client integration's we have introduced API versioning as from our 12.1 release. Please see the API updates page for more information. If a method or parameter has no version information it means that you'll find this as part of our standard API, please see the "Getting started with the API" section below.

Getting started with the API

The API entry point:
https://soap.proofhq.com/soap
(please note the use of HTTPS) 


The WSDL can be found here:


Note: This WSDL contains all the changes up until the 12.1 release, after which we introduced API versioning. Please see the API Updates page for more information about the various WSDL versions and upcoming changes


Every API request requires a session key. This session key identifies the ProofHQ user performing the action(s) and is obtained by calling the doLogin() method and passing in the user's email address and password. The doLogin() method only needs to be called once before a sequence of API requests. The session key remains active for a short period of time and is renewed on every method call. We will be adding support for token based authentication very soon.

All requests use the following envelope, header and body format:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:proofhqapi">
    <soapenv:Header/>
    <soapenv:Body>
        ... API function and data inserted here ...
    </soapenv:Body>
</soapenv:Envelope>

FAQ's

For a collection of frequently asked questions, please visit this page.