The Moving Portal API documentationThe Moving Portal API documentation
Key concepts
API concepts
Services
Key concepts
API concepts
Services
  • Key concepts
  • API concepts
  • GDPR
  • Development
  • Releases
  • Services
  • Authentication
  • Instruction
  • Instruction search
  • Notes
  • Data
  • Referral
  • Quote
  • Quotes search
  • Supplier operations
  • Notifications
  • Testing
  • Email integration
  • Objects
  • Examples
    • Introducer
      • Authentication
      • Data
      • Quote
      • Quotes search
      • Referral
      • Instruction
      • Instructions search
      • Instruction notification
      • Notes
    • Supplier
      • Authentication
      • Data
      • Instruction
      • Instructions search
      • Instruction notification
      • Notes
      • Supplier operations
  • OTHER

Examples - Quote service Introducer

Create a quote

This example

  • Creates a quote
  • Retrieves the quote
  • Updates the fees
  • Updates the property
  • Emails the quote
  • Refers the quote
Quote service
@host=https://api.themovingportal.dev
@auth=BASICAUTHHEADER

### Create a new quote
# @name createquote
POST {{host}}/Quote HTTP/1.1
Authorization: Basic {{auth}}
Content-Type: application/json

{
  "cases": [
    {
      "productCode": "RICSL2SURVEY",
      "yourFeeInclVAT": 100.00
    }
  ],
  "propertyValueOrPurchasePrice": null,
  "propertyValueTierCode": "100K150K",
  "propertyTypeCode": "TERRACED",
  "propertyAgeCode": "LESSTHANTENYEARS",
  "yearBuilt": null,
  "propertyAddress": {
    "addressFormatCode": "DEFAULT",
    "addressLine1": "29 Market Street",
    "addressLine2": "",
    "addressLine3": "Milton Keynes",
    "addressLine4": "",
    "postcode": "MK4 1EB",
    "countryCode": "GB"
  },
  "correspondenceAddress": {
    "addressFormatCode": "DEFAULT",
    "addressLine1": "44 Castle Road",
    "addressLine2": "",
    "addressLine3": "Twickenham",
    "addressLine4": "",
    "postcode": "TW6 7SM",
    "countryCode": "GB"
  },
  "accessDetails": {
    "accessTypeCode": "VENDOR",
    "firmName": "",
    "emailAddress": "vendor@vendor.co.uk",
    "contactName": "John Smith",
    "telephoneNumber": "01234 121212"
  },
  "customers": [
    {
      "emailAddress": "jacob.baker@themovingportal.dev",
      "title": "",
      "firstName": "Jacob",
      "lastName": "Baker",
      "telephoneNumber": "01245 399999",
      "receiveSMS": false
    }
  ]
}

### Retrieve the quote
GET {{host}}/quote/{{createquote.response.body.$.tmpReference}}
Authorization: Basic {{auth}}

### Update fees
PATCH {{host}}/quote/{{createquote.response.body.$.tmpReference}}/fees
Authorization: Basic {{auth}}
Content-Type: application/json
{
  "resultSequence": 1,
  "yourFeeInclVAT": 120
}

### Update property
PATCH {{host}}/quote/{{createquote.response.body.$.tmpReference}}/property
Authorization: Basic {{auth}}
Content-Type: application/json

{
  "propertyTypeCode": "FLAT",
  "propertyAgeCode": "MORETHANONEHUNDREDYEARS",
  "yearBuilt": null,
  "propertyAddress": {
    "addressFormatCode": "DEFAULT",
    "addressLine1": "65 South Avenue",
    "addressLine2": "",
    "addressLine3": "Oxford",
    "addressLine4": "",
    "postcode": "OX3 1HJ",
    "countryCode": "GB"
  },
  "correspondenceAddress": {
    "addressFormatCode": "DEFAULT",
    "addressLine1": "48 Castle Road",
    "addressLine2": "",
    "addressLine3": "Twickenham",
    "addressLine4": "",
    "postcode": "TW6 7SM",
    "countryCode": "GB"
  },
  "accessDetails": {
    "accessTypeCode": "AGENT",
    "firmName": "Pauls Estate Agents",
    "emailAddress": "paul@paulsea.co.uk",
    "contactName": "Paul Jones",
    "telephoneNumber": "01234 772616"
  }
}

### Email
PUT {{host}}/quote/{{createquote.response.body.$.tmpReference}}/email
Authorization: Basic {{auth}}
Content-Type: application/json

{
  "ResultSequences": [ 1 ]
}


### Refer
PUT {{host}}/quote/{{createquote.response.body.$.tmpReference}}/refer
Authorization: Basic {{auth}}
Content-Type: application/json

{
  "ResultSequence": 1
}

Delete a quote

This creates a quote with the minumum information and then removes it. The quote can still be retrieved - it will have a status of REMOVED.

Quote service
@host=https://api.themovingportal.dev
@auth=BASICAUTHHEADER

###
GET {{host}}/auth/whoami
Authorization: Basic {{auth}}

### Create a new quote
# @name createquote
POST {{host}}/Quote HTTP/1.1
Authorization: Basic {{auth}}
Content-Type: application/json

{
  "cases": [
    {
      "productCode": "RICSL2SURVEY",
      "yourFeeInclVAT": 100.00
    }
  ],
  "propertyValueOrPurchasePrice": null,
  "propertyValueTierCode": "100K150K",
  "propertyTypeCode": "UNKNOWN",
  "propertyAgeCode": "UNKNOWN",
  "yearBuilt": null,
  "propertyAddress": {
    "addressFormatCode": "DEFAULT",
    "addressLine1": "29 Market Street",
    "addressLine2": "",
    "addressLine3": "Milton Keynes",
    "addressLine4": "",
    "postcode": "MK4 1EB",
    "countryCode": "GB"
  },
  "customers": [
    {
      "emailAddress": "jacob.baker@themovingportal.dev",
      "title": "",
      "firstName": "Jacob",
      "lastName": "Baker",
      "telephoneNumber": "01245 399999",
      "receiveSMS": false
    }
  ]
}

### Retrieve quote
GET {{host}}/quote/{{createquote.response.body.$.tmpReference}}
Authorization: Basic {{auth}}

### Delete quote
DELETE {{host}}/quote/{{createquote.response.body.$.tmpReference}}
Authorization: Basic {{auth}}
Content-Type: application/json

{
  "ResultSequences": [ 1 ]
}

### Retrieve quote
GET {{host}}/quote/{{createquote.response.body.$.tmpReference}}
Authorization: Basic {{auth}}
Last Updated: 11/4/25, 10:52 AM
Prev
Data
Next
Quotes search