POST api/Retailer/EligibilityCheck

Create a new eligibility check

Request Information

URI Parameters

None.

Body Parameters

Name	Type	Additional information
FinanceDetails	FinanceDetailsRequestModel	None.
CustomerDetails	CustomerDetailsRequestModel	None.
EmploymentDetails	EligibilityCheckEmploymentDetailsRequestModel	None.

Request Formats

application/json, text/json

Sample:

{
  "FinanceDetails": {
    "RateCardProductId": "a75525ac-d493-474b-a412-d4b16c33866c",
    "Price": 1.0,
    "Deposit": 1.0
  },
  "CustomerDetails": {
    "CustomerEmail": "sample string 1",
    "TitleId": "5735073a-8a45-499f-a08a-ca93c742cb2d",
    "FirstName": "sample string 2",
    "LastName": "sample string 3",
    "DateOfBirth": "2025-07-02T20:06:48.0636936+01:00",
    "ResidentialStatusId": "c02b3633-b2a8-42b9-8d87-364ccb3294d9",
    "MonthlyRentAmount": 1.0,
    "NumberOfDependants": 1,
    "CurrentAddress": {
      "PostCode": "sample string 1",
      "City": "sample string 2",
      "Flat": "sample string 3",
      "HouseNumber": "sample string 4",
      "HouseName": "sample string 5",
      "Street": "sample string 6"
    }
  },
  "EmploymentDetails": {
    "EmploymentStatusId": "08f95fbd-acd9-40b8-99f2-972007a2890d",
    "GrossAnnualIncome": 1.0
  }
}

text/html

Sample:

{"FinanceDetails":{"RateCardProductId":"a75525ac-d493-474b-a412-d4b16c33866c","Price":1.0,"Deposit":1.0},"CustomerDetails":{"CustomerEmail":"sample string 1","TitleId":"5735073a-8a45-499f-a08a-ca93c742cb2d","FirstName":"sample string 2","LastName":"sample string 3","DateOfBirth":"2025-07-02T20:06:48.0636936+01:00","ResidentialStatusId":"c02b3633-b2a8-42b9-8d87-364ccb3294d9","MonthlyRentAmount":1.0,"NumberOfDependants":1,"CurrentAddress":{"PostCode":"sample string 1","City":"sample string 2","Flat":"sample string 3","HouseNumber":"sample string 4","HouseName":"sample string 5","Street":"sample string 6"}},"EmploymentDetails":{"EmploymentStatusId":"08f95fbd-acd9-40b8-99f2-972007a2890d","GrossAnnualIncome":1.0}}

application/xml, text/xml

Sample:

<EligibilityCheckRequestModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.APIRequests.EligibilityCheckRequestModels">
  <CustomerDetails>
    <CurrentAddress xmlns:d3p1="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels">
      <d3p1:City>sample string 2</d3p1:City>
      <d3p1:Flat>sample string 3</d3p1:Flat>
      <d3p1:HouseName>sample string 5</d3p1:HouseName>
      <d3p1:HouseNumber>sample string 4</d3p1:HouseNumber>
      <d3p1:PostCode>sample string 1</d3p1:PostCode>
      <d3p1:Street>sample string 6</d3p1:Street>
    </CurrentAddress>
    <CustomerEmail>sample string 1</CustomerEmail>
    <DateOfBirth>2025-07-02T20:06:48.0636936+01:00</DateOfBirth>
    <FirstName>sample string 2</FirstName>
    <LastName>sample string 3</LastName>
    <MonthlyRentAmount>1</MonthlyRentAmount>
    <NumberOfDependants>1</NumberOfDependants>
    <ResidentialStatusId>c02b3633-b2a8-42b9-8d87-364ccb3294d9</ResidentialStatusId>
    <TitleId>5735073a-8a45-499f-a08a-ca93c742cb2d</TitleId>
  </CustomerDetails>
  <EmploymentDetails>
    <EmploymentStatusId>08f95fbd-acd9-40b8-99f2-972007a2890d</EmploymentStatusId>
    <GrossAnnualIncome>1</GrossAnnualIncome>
  </EmploymentDetails>
  <FinanceDetails>
    <Deposit>1</Deposit>
    <Price>1</Price>
    <RateCardProductId>a75525ac-d493-474b-a412-d4b16c33866c</RateCardProductId>
  </FinanceDetails>
</EligibilityCheckRequestModel>

Response Information

Resource Description

Returns the eligibility check details.

EligibilityCheckResponseModel

Name	Type	Additional information
EligibilityCheckId	globally unique identifier	None.
Status	string	None.
ActiveUntil	date	None.
UpperLoanValue	decimal number	None.

Response Formats

application/json, text/json

Sample:

{
  "EligibilityCheckId": "4de9850e-3425-430d-8dc7-ce24a3aae872",
  "Status": "sample string 2",
  "ActiveUntil": "2025-07-02T20:06:48.079298+01:00",
  "UpperLoanValue": 1.0
}

text/html

Sample:

{"EligibilityCheckId":"4de9850e-3425-430d-8dc7-ce24a3aae872","Status":"sample string 2","ActiveUntil":"2025-07-02T20:06:48.079298+01:00","UpperLoanValue":1.0}

application/xml, text/xml

Sample:

<EligibilityCheckResponseModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.APIResponses.EligibilityCheckResponseModels">
  <ActiveUntil>2025-07-02T20:06:48.079298+01:00</ActiveUntil>
  <EligibilityCheckId>4de9850e-3425-430d-8dc7-ce24a3aae872</EligibilityCheckId>
  <Status>sample string 2</Status>
  <UpperLoanValue>1</UpperLoanValue>
</EligibilityCheckResponseModel>