Global property history reporting and due-diligence API

Calls to the API must be for genuine use and responses from the API must not be stored for the purpose of creating an offline copy of the information stored. Failure to comply with this requirement will infringe the API License.

StockWatch API Calls

Create StockWatch Record

POST /stockwatch/create


To create a new StockWatch record containing one or more items.


All optional parameters must be valid if they are supplied.

Example Request

POST /stockwatch/create HTTP/1.1
Accept: application/json
Content-Type: application/json

    "reference": "IHVREV73287476-4324234",
    "items": [{
        "type": "mobile-phone",
        "itemreference": "SAMTEST",
        "manufacturer": "Samsung",
        "model": "Galaxy",
        "serials": ["7837492049023842"]


A unique StockWatch Reference and a 201 HTTP response code.

Example Response

HTTP/1.1 201 Created
Content-Type: application/json

    "stockwatchref": "4234234-2-3523-3223423523-234234:IHVREV73287476-4324234"