POST api/Policy/Landlord/CreatePolicy

API URL: https://api.alpsltd.co.uk/api/Policy/Landlord/CreatePolicy

Create a new landlord legal expenses policy

Request Information

Authorisation Type

Basic Auth

URI Parameters

None.

Body Parameters

AddPolicy_LandlordLegal

Name	Description	Type	Additional information
CorresAddressDetails	Address details where policy correspondence should be sent.	Address	REQUIRED
RiskAddressDetails	Address details of the property being insured.	Address	REQUIRED
ClientDetails	The client's personal details.	Client	REQUIRED
StartDate	Date the policy is due to start.	date	REQUIRED
ExpiryDate	Date the policy is due to expire (policies expire at 23:59:59 on the date provided).	date	REQUIRED
InsComName	The name of the underlying insurer.	string	Max length: 300
InsPolNum	The policy number issued by the underlying insurer.	string	Max length: 200
CustomerType	The type of customer ID (See api/Policy/CustomerTypes for options).	integer	REQUIRED Range: inclusive between 1 and 5
ProductType	The type of product ID (See api/Policy/ProductTypes for options).	integer	REQUIRED Range: inclusive between 1 and 2
CoverLevelID	The level of cover to purchase (See api/Policy/Landlord/CoverLevels for options).	integer	REQUIRED
FeePaidIncIPT	The total amount the customer has paid, including IPT.	decimal number	REQUIRED
MonthlyRent	The monthly rental amount for the insured property. This is only required when purchasing Rent Guarantee cover.	decimal number

Request Formats

application/json, text/json

Sample:

{
  "CorresAddressDetails": {
    "Address1": "sample string 1",
    "Address2": "sample string 2",
    "Address3": "sample string 3",
    "Address4": "sample string 4",
    "Postcode": "sample string 5"
  },
  "RiskAddressDetails": {
    "Address1": "sample string 1",
    "Address2": "sample string 2",
    "Address3": "sample string 3",
    "Address4": "sample string 4",
    "Postcode": "sample string 5"
  },
  "ClientDetails": {
    "Title": "sample string 1",
    "Firstname": "sample string 2",
    "Surname": "sample string 3",
    "VulnerabilityID": 4,
    "DateOfBirth": "2026-11-04T09:28:33.8371494+00:00"
  },
  "StartDate": "2026-11-04T09:28:33.8371494+00:00",
  "ExpiryDate": "2026-11-04T09:28:33.8371494+00:00",
  "InsComName": "sample string 3",
  "InsPolNum": "sample string 4",
  "CustomerType": 5,
  "ProductType": 6,
  "CoverLevelID": 7,
  "FeePaidIncIPT": 8.0,
  "MonthlyRent": 1.0
}

application/xml, text/xml

Sample:

<AddPolicy_LandlordLegal xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
  <ClientDetails>
    <DateOfBirth>2026-11-04T09:28:33.8371494+00:00</DateOfBirth>
    <Firstname>sample string 2</Firstname>
    <Surname>sample string 3</Surname>
    <Title>sample string 1</Title>
    <VulnerabilityID>4</VulnerabilityID>
  </ClientDetails>
  <CorresAddressDetails>
    <Address1>sample string 1</Address1>
    <Address2>sample string 2</Address2>
    <Address3>sample string 3</Address3>
    <Address4>sample string 4</Address4>
    <Postcode>sample string 5</Postcode>
  </CorresAddressDetails>
  <CoverLevelID>7</CoverLevelID>
  <CustomerType>5</CustomerType>
  <ExpiryDate>2026-11-04T09:28:33.8371494+00:00</ExpiryDate>
  <FeePaidIncIPT>8</FeePaidIncIPT>
  <InsComName>sample string 3</InsComName>
  <InsPolNum>sample string 4</InsPolNum>
  <MonthlyRent>1</MonthlyRent>
  <ProductType>6</ProductType>
  <RiskAddressDetails>
    <Address1>sample string 1</Address1>
    <Address2>sample string 2</Address2>
    <Address3>sample string 3</Address3>
    <Address4>sample string 4</Address4>
    <Postcode>sample string 5</Postcode>
  </RiskAddressDetails>
  <StartDate>2026-11-04T09:28:33.8371494+00:00</StartDate>
</AddPolicy_LandlordLegal>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

LandlordPolicy

Name	Description	Type
PolicyID	The policy number.	integer
BrokerName	The broker who sold the policy.	string
CoverLevel	The level of cover purchased.	string
Status	The current policy status.	string
CorresAddressDetails	Address details where policy correspondence should be sent.	Address
RiskAddressDetails	Address details of the insured property.	Address
ClientDetails	The client's personal details.	Client
StartDate	The policy start date.	date
ExpiryDate	The policy expiry date.	date
InsComName	The name of the underlying insurer.	string
InsPolNum	The policy number issued by the underlying insurer.	string
FeePaidIncIPT	The total amount the customer has paid, including IPT.	decimal number
IPT	The IPT amount included within the premium.	decimal number
ALPSChargeExIPT	The ALPS charge excluding IPT.	decimal number
CustomerType	The customer type.	string
ProductType	The product type.	string
Documentation	Documents associated with this policy, including the policy certificate and policy wordings.	Collection of Documents

Response Formats

application/json, text/json

Sample:

{
  "PolicyID": 1,
  "BrokerName": "sample string 2",
  "CoverLevel": "sample string 3",
  "Status": "sample string 4",
  "CorresAddressDetails": {
    "Address1": "sample string 1",
    "Address2": "sample string 2",
    "Address3": "sample string 3",
    "Address4": "sample string 4",
    "Postcode": "sample string 5"
  },
  "RiskAddressDetails": {
    "Address1": "sample string 1",
    "Address2": "sample string 2",
    "Address3": "sample string 3",
    "Address4": "sample string 4",
    "Postcode": "sample string 5"
  },
  "ClientDetails": {
    "Title": "sample string 1",
    "Firstname": "sample string 2",
    "Surname": "sample string 3",
    "VulnerabilityID": 4,
    "DateOfBirth": "2026-11-04T09:28:33.870148+00:00"
  },
  "StartDate": "2026-11-04T09:28:33.870148+00:00",
  "ExpiryDate": "2026-11-04T09:28:33.870148+00:00",
  "InsComName": "sample string 7",
  "InsPolNum": "sample string 8",
  "FeePaidIncIPT": 9.0,
  "IPT": 10.0,
  "ALPSChargeExIPT": 11.0,
  "CustomerType": "sample string 12",
  "ProductType": "sample string 13",
  "Documentation": [
    {
      "DocumentName": "sample string 1",
      "DocumentType": "sample string 2",
      "Bytes": "QEA="
    },
    {
      "DocumentName": "sample string 1",
      "DocumentType": "sample string 2",
      "Bytes": "QEA="
    }
  ]
}

application/xml, text/xml

Sample:

<LandlordPolicy xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
  <ALPSChargeExIPT>11</ALPSChargeExIPT>
  <BrokerName>sample string 2</BrokerName>
  <ClientDetails>
    <DateOfBirth>2026-11-04T09:28:33.870148+00:00</DateOfBirth>
    <Firstname>sample string 2</Firstname>
    <Surname>sample string 3</Surname>
    <Title>sample string 1</Title>
    <VulnerabilityID>4</VulnerabilityID>
  </ClientDetails>
  <CorresAddressDetails>
    <Address1>sample string 1</Address1>
    <Address2>sample string 2</Address2>
    <Address3>sample string 3</Address3>
    <Address4>sample string 4</Address4>
    <Postcode>sample string 5</Postcode>
  </CorresAddressDetails>
  <CoverLevel>sample string 3</CoverLevel>
  <CustomerType>sample string 12</CustomerType>
  <Documentation>
    <Documents>
      <Bytes>QEA=</Bytes>
      <DocumentName>sample string 1</DocumentName>
      <DocumentType>sample string 2</DocumentType>
    </Documents>
    <Documents>
      <Bytes>QEA=</Bytes>
      <DocumentName>sample string 1</DocumentName>
      <DocumentType>sample string 2</DocumentType>
    </Documents>
  </Documentation>
  <ExpiryDate>2026-11-04T09:28:33.870148+00:00</ExpiryDate>
  <FeePaidIncIPT>9</FeePaidIncIPT>
  <IPT>10</IPT>
  <InsComName>sample string 7</InsComName>
  <InsPolNum>sample string 8</InsPolNum>
  <PolicyID>1</PolicyID>
  <ProductType>sample string 13</ProductType>
  <RiskAddressDetails>
    <Address1>sample string 1</Address1>
    <Address2>sample string 2</Address2>
    <Address3>sample string 3</Address3>
    <Address4>sample string 4</Address4>
    <Postcode>sample string 5</Postcode>
  </RiskAddressDetails>
  <StartDate>2026-11-04T09:28:33.870148+00:00</StartDate>
  <Status>sample string 4</Status>
</LandlordPolicy>