Skip to content
English - United Kingdom
  • There are no suggestions because the search field is empty.

How do I use the V4 Valuations API to create property valuations?

The V4 Valuations API supports the creation of both lettings and sales property valuations, with integrated landlord management and configurable service types. All endpoints are at https://live-api.letmc.com/v4/valuations/.

Company structure

  • All branches: GET /v4/valuations/{shortName}/company/branches/{offset}/{count}
  • Specific branch: GET /company/branches/{branchID}

Lettings valuations

  • Create a lettings valuation — POST /lettings/valuation Requires comprehensive property details, rental market analysis, and valuation parameters. Returns a valuation work item ID for tracking.

Landlord management for valuations:

  • Create a landlord for valuation purposes: POST /landlords/{branchID}/valuation Creates a landlord record within a specific branch context.
  • Get landlords for a branch: GET /landlords/{branchID}/valuation/{offset}/{count}

Sales valuations

  • Create a sales valuation — POST /sales/valuation Requires detailed property information, market analysis parameters, and a service type selection.
  • Get sales service types — GET /sales/servicetype/{offset}/{count} Returns all available valuation service types — e.g. desktop valuations, full inspections, RICS Red Book valuations — with pricing structures and delivery timescales.

Custom fields

  • Get definition: /company/object/{objectID}/customfield
  • Get value: /company/objects/{objectID}/{fieldID}/value
  • Set value: POST /company/objects/{objectID}/{fieldID}/customfield

Lettings valuation: required data

  • Property address, type, size, bedrooms, bathrooms, and features
  • Landlord contact details and rental objectives
  • Local rental yields and comparable properties
  • Property condition and lettability factors
  • Valuation urgency and reporting format

Sales valuation: required data

  • Full property description, age, construction type, and extensions
  • Selected service type
  • Comparable sales data and local market trends
  • Planning permissions, development potential, or restrictive covenants
  • Valuation purpose (mortgage, insurance, sale) and timescale

Test with Swagger: Select "V4.Valuations" from the tier dropdown. Start with service types and branch endpoints before testing valuation creation.