Developer API

Integrate ConveyQuote directly into your CRM or Case Management System.

Request API Access

You can request API access under Dashboard > Developer API.

Introduction

The ConveyQuote API allows you to programmatically generate conveyancing quotes, retrieve lead data, and sync case statuses with your internal systems. It is built around REST principles and returns JSON responses.

Base URL:

http://conveyquote.net/api/index.php

Authentication

Authentication is handled via Bearer Tokens. You must include your API Key in the Authorization header of every request.

Note: Your API Key carries the same privileges as your user account. Keep it secure.

Header Format

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Errors & Status Codes

The API uses standard HTTP status codes to indicate the success or failure of an API request.

200 OKRequest was successful.
400 Bad RequestMissing required parameters or invalid data format.
401 UnauthorizedAPI Key is missing or invalid.
503 Service UnavailableAPI is currently disabled by the administrator.

Create Quote

Generate a new conveyancing quote. This calculates SDLT, HMLR fees, and your professional fees, returning a PDF link.

POST /quote

Request Body (JSON)

FieldTypeDescription
priceFloatPurchase price of the property (Required).
typeString'freehold' or 'leasehold'.
postcodeStringProperty postcode (e.g., SW1A 1AA).
client_nameStringFull name of the client.
is_first_time_buyerBoolean(Optional) Default: false.
is_second_homeBoolean(Optional) Default: false.

Example Request

curl -X POST http://conveyquote.net/api/index.php/quote \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "price": 350000,
    "type": "freehold",
    "client_name": "Jane Doe",
    "postcode": "SW1A 1AA"
  }'

Example Response

{
  "status": "success",
  "data": {
    "quote_ref": "Q-6712AB",
    "total": 1250.00,
    "breakdown": {
      "legal_fee": 850.00,
      "sdlt": 5000.00,
      "hmlr": 135.00
    },
    "pdf_url": "http://conveyquote.net/generate_pdf?ref=Q-6712AB&mode=download",
    "instruct_url": "http://conveyquote.net/instruct?ref=Q-6712AB"
  }
}

List Leads

Retrieve a paginated list of your most recent quotes.

GET /leads

Check Quote Status

Check if a specific quote has been instructed or completed.

GET /lead/{reference}

Example Response

{
  "status": "success",
  "data": {
    "reference": "Q-6712AB",
    "current_status": "instructed",
    "case_stage": "Searches Ordered",
    "created_at": "2025-10-20 14:30:00"
  }
}