The Landmark API is a RESTful API based on HTTPS requests and JSON responses.

The API is accessed by making HTTPS requests to an endpoint URL. Each endpoint will use one of the methods; GET, POST, PUT, PATCH, and DELETE to dictate how you interact with the information available. Every endpoint is accessed only via the SSL-enabled HTTPS (port 443) protocol. The API uses semantic versioning, and the current release is v1.0.0

The API is available in two environments, both are identical in that they have the same specification infrastructure and functionality.

The 2 environments are:

• User Acceptance Testing (UAT)
• Production (PRD)

The UAT environment should be used during development, and interfaces with the Landmark UAT environments. You should use this whilst implementing and testing your integration.

The URLs for the UAT APIs are:

• Base URL: https://uat-api.landmarkcloudservices.com/valuation-spn/milestones/callbacks
• Auth: https://lmkmaster-uat.eu.auth0.com/oauth/token

The PRD environment is a live instance, and this talks to the live Landmark environments. This should only be used once the integration is considered production ready and all testing has been completed on the UAT environment. Any actions performed on PRD will result in the creation and syncing of real data that may be seen by users.

The URLs for the production APIs are:

• Base URL: https://api.landmarkcloudservices.com/valuation-spn/milestones/callbacks
• Auth: https://lmkmaster.eu.auth0.com/oauth/token

Requests must be sent over HTTPS with any payload formatted in JSON. To authenticate against the API a Bearer Token Header must be provided.

The API allows a maximum of 250 requests per customer per minute.

• 1.0.0 (2024-02-15)
  • Added valuation callback milestone notification definitions.
• 0.9.0 (2024-02-14)
  • First issued.

Operations to manage callback configurations for transaction milestone notifications