POST api/Retailer/EligibilityCheck/CreditCheck

Create a new credit check from eligibility check

Request Information

URI Parameters

None.

Body Parameters

Name	Description	Type	Additional information
EligibilityCheckId		globally unique identifier	None.
FinanceDetails	This model should be used to populate all the finance details requested by the system to create a Credit Check.	FinanceDetailsOptionalModel	None.
CustomerDetails		CustomerInfoOptionalModel	None.
EmploymentDetails		EmploymentInfoOptionalModel	None.
BankDetails		BankDetailsModel	None.
SuppressCustomerEmails		boolean	None.
IpAddress		string	None.
Source		string	None.
MarketingPreferences		MarketingPreferencesModel	None.
AcceptAllTermsAndConditions		boolean	None.
CustomerRedirectURL		string	None.
ReturnDocumentsForSign	This model can be used to specify whether you want the documents or just the signing link or neither.	ReturnDocumentsEnum	None.

Request Formats

application/json, text/json

Sample:

{
  "EligibilityCheckId": "bec48372-31a7-45c4-b8fb-9fd36c4b3b47",
  "FinanceDetails": {
    "RateCardProductId": "dcc9947a-ffc8-4388-9c6a-df52ea00fc4d",
    "RateCardProductCode": "sample string 1",
    "CommissionConsent": true,
    "DescriptionOfGoods": "sample string 2",
    "RetailersReference": "sample string 3",
    "Price": 1.0,
    "Deposit": 1.0
  },
  "CustomerDetails": {
    "MiddleName": "sample string 1",
    "MaidenName": "sample string 2",
    "BlackBoxString": "sample string 3",
    "TitleId": "7bb9a6e1-a006-48b6-90ad-38d5755d589f",
    "GenderId": "964f91cf-6144-4d38-ac66-c0cd755819e1",
    "MaritalStatusId": "e908f50c-d697-4918-8677-adb45530e81f",
    "ResidentialStatusId": "41f9f512-441e-414a-b2d6-a140dad5c4df",
    "NumberOfDependants": 1,
    "Vulnerability": true,
    "CurrentAddress": {
      "YearsAtAddressId": "634fe7c6-c010-4da3-9d7a-524dcfdf35cd",
      "PostCode": "sample string 1",
      "City": "sample string 2",
      "Flat": "sample string 3",
      "HouseNumber": "sample string 4",
      "HouseName": "sample string 5",
      "Street": "sample string 6"
    },
    "PreviousAddress1": {
      "YearsAtAddressId": "634fe7c6-c010-4da3-9d7a-524dcfdf35cd",
      "PostCode": "sample string 1",
      "City": "sample string 2",
      "Flat": "sample string 3",
      "HouseNumber": "sample string 4",
      "HouseName": "sample string 5",
      "Street": "sample string 6"
    },
    "PreviousAddress2": {
      "YearsAtAddressId": "634fe7c6-c010-4da3-9d7a-524dcfdf35cd",
      "PostCode": "sample string 1",
      "City": "sample string 2",
      "Flat": "sample string 3",
      "HouseNumber": "sample string 4",
      "HouseName": "sample string 5",
      "Street": "sample string 6"
    },
    "GoodsDeliveryAddress": {
      "YearsAtAddressId": "634fe7c6-c010-4da3-9d7a-524dcfdf35cd",
      "PostCode": "sample string 1",
      "City": "sample string 2",
      "Flat": "sample string 3",
      "HouseNumber": "sample string 4",
      "HouseName": "sample string 5",
      "Street": "sample string 6"
    },
    "CustomerEmail": "sample string 5",
    "FirstName": "sample string 6",
    "LastName": "sample string 7",
    "Telephone": "sample string 8",
    "MobileNumber": "sample string 9",
    "DateOfBirth": "2026-05-14T16:09:33.4594195+01:00",
    "MonthlyRentAmount": 1.0,
    "GoodsDeliveryAddressIsTheSameAsCurrentAddress": true
  },
  "EmploymentDetails": {
    "EmploymentStatusId": "9ebc3deb-17e6-43fa-9431-f4172b9033c3",
    "YearsSelfEmployedId": "bbfa39b3-486c-41ae-bd9b-45837bae85a2",
    "YearsWithEmployerId": "49dc6bc1-6c84-4821-967e-0af5c34e8b38",
    "SourceOfIncomeId": "0aa59218-1b8d-4dd7-ab5f-f7ce994fb745",
    "TypeOfBusiness": "sample string 1",
    "BusinessName": "sample string 2",
    "MainOccupation": "sample string 3",
    "EmployerName": "sample string 4",
    "GrossAnnualIncome": 1.0,
    "HouseholdAnnualIncome": 1
  },
  "BankDetails": {
    "BankAccountNumber": "sample string 1",
    "BankSortCode": "sample string 2"
  },
  "SuppressCustomerEmails": true,
  "IpAddress": "sample string 1",
  "Source": "sample string 2",
  "MarketingPreferences": {
    "ReceiveInformationViaPost": true,
    "ReceiveInformationViaEmail": true,
    "ReceiveInformationViaSMS": true,
    "ReceiveInformationViaPhone": true,
    "AgreePersonalDetailsToBeDisclosed": true
  },
  "AcceptAllTermsAndConditions": true,
  "CustomerRedirectURL": "sample string 3",
  "ReturnDocumentsForSign": 1
}

text/html

Sample:

{"EligibilityCheckId":"bec48372-31a7-45c4-b8fb-9fd36c4b3b47","FinanceDetails":{"RateCardProductId":"dcc9947a-ffc8-4388-9c6a-df52ea00fc4d","RateCardProductCode":"sample string 1","CommissionConsent":true,"DescriptionOfGoods":"sample string 2","RetailersReference":"sample string 3","Price":1.0,"Deposit":1.0},"CustomerDetails":{"MiddleName":"sample string 1","MaidenName":"sample string 2","BlackBoxString":"sample string 3","TitleId":"7bb9a6e1-a006-48b6-90ad-38d5755d589f","GenderId":"964f91cf-6144-4d38-ac66-c0cd755819e1","MaritalStatusId":"e908f50c-d697-4918-8677-adb45530e81f","ResidentialStatusId":"41f9f512-441e-414a-b2d6-a140dad5c4df","NumberOfDependants":1,"Vulnerability":true,"CurrentAddress":{"YearsAtAddressId":"634fe7c6-c010-4da3-9d7a-524dcfdf35cd","PostCode":"sample string 1","City":"sample string 2","Flat":"sample string 3","HouseNumber":"sample string 4","HouseName":"sample string 5","Street":"sample string 6"},"PreviousAddress1":{"YearsAtAddressId":"634fe7c6-c010-4da3-9d7a-524dcfdf35cd","PostCode":"sample string 1","City":"sample string 2","Flat":"sample string 3","HouseNumber":"sample string 4","HouseName":"sample string 5","Street":"sample string 6"},"PreviousAddress2":{"YearsAtAddressId":"634fe7c6-c010-4da3-9d7a-524dcfdf35cd","PostCode":"sample string 1","City":"sample string 2","Flat":"sample string 3","HouseNumber":"sample string 4","HouseName":"sample string 5","Street":"sample string 6"},"GoodsDeliveryAddress":{"YearsAtAddressId":"634fe7c6-c010-4da3-9d7a-524dcfdf35cd","PostCode":"sample string 1","City":"sample string 2","Flat":"sample string 3","HouseNumber":"sample string 4","HouseName":"sample string 5","Street":"sample string 6"},"CustomerEmail":"sample string 5","FirstName":"sample string 6","LastName":"sample string 7","Telephone":"sample string 8","MobileNumber":"sample string 9","DateOfBirth":"2026-05-14T16:09:33.4594195+01:00","MonthlyRentAmount":1.0,"GoodsDeliveryAddressIsTheSameAsCurrentAddress":true},"EmploymentDetails":{"EmploymentStatusId":"9ebc3deb-17e6-43fa-9431-f4172b9033c3","YearsSelfEmployedId":"bbfa39b3-486c-41ae-bd9b-45837bae85a2","YearsWithEmployerId":"49dc6bc1-6c84-4821-967e-0af5c34e8b38","SourceOfIncomeId":"0aa59218-1b8d-4dd7-ab5f-f7ce994fb745","TypeOfBusiness":"sample string 1","BusinessName":"sample string 2","MainOccupation":"sample string 3","EmployerName":"sample string 4","GrossAnnualIncome":1.0,"HouseholdAnnualIncome":1},"BankDetails":{"BankAccountNumber":"sample string 1","BankSortCode":"sample string 2"},"SuppressCustomerEmails":true,"IpAddress":"sample string 1","Source":"sample string 2","MarketingPreferences":{"ReceiveInformationViaPost":true,"ReceiveInformationViaEmail":true,"ReceiveInformationViaSMS":true,"ReceiveInformationViaPhone":true,"AgreePersonalDetailsToBeDisclosed":true},"AcceptAllTermsAndConditions":true,"CustomerRedirectURL":"sample string 3","ReturnDocumentsForSign":1}

application/xml, text/xml

Sample:

<CreditCheckFromEligibilityRequestModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.APIRequests.CreditCheckRequestModels">
  <AcceptAllTermsAndConditions xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels">true</AcceptAllTermsAndConditions>
  <CustomerRedirectURL xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels">sample string 3</CustomerRedirectURL>
  <MarketingPreferences xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels">
    <AgreePersonalDetailsToBeDisclosed>true</AgreePersonalDetailsToBeDisclosed>
    <ReceiveInformationViaEmail>true</ReceiveInformationViaEmail>
    <ReceiveInformationViaPhone>true</ReceiveInformationViaPhone>
    <ReceiveInformationViaPost>true</ReceiveInformationViaPost>
    <ReceiveInformationViaSMS>true</ReceiveInformationViaSMS>
  </MarketingPreferences>
  <ReturnDocumentsForSign xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels">NoDocuments</ReturnDocumentsForSign>
  <BankDetails xmlns:d2p1="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels">
    <d2p1:BankAccountNumber>sample string 1</d2p1:BankAccountNumber>
    <d2p1:BankSortCode>sample string 2</d2p1:BankSortCode>
  </BankDetails>
  <CustomerDetails xmlns:d2p1="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels">
    <d2p1:CustomerEmail>sample string 5</d2p1:CustomerEmail>
    <d2p1:DateOfBirth>2026-05-14T16:09:33.4594195+01:00</d2p1:DateOfBirth>
    <d2p1:FirstName>sample string 6</d2p1:FirstName>
    <d2p1:GoodsDeliveryAddressIsTheSameAsCurrentAddress>true</d2p1:GoodsDeliveryAddressIsTheSameAsCurrentAddress>
    <d2p1:LastName>sample string 7</d2p1:LastName>
    <d2p1:MobileNumber>sample string 9</d2p1:MobileNumber>
    <d2p1:MonthlyRentAmount>1</d2p1:MonthlyRentAmount>
    <d2p1:Telephone>sample string 8</d2p1:Telephone>
    <d2p1:BlackBoxString>sample string 3</d2p1:BlackBoxString>
    <d2p1:CurrentAddress>
      <d2p1:City>sample string 2</d2p1:City>
      <d2p1:Flat>sample string 3</d2p1:Flat>
      <d2p1:HouseName>sample string 5</d2p1:HouseName>
      <d2p1:HouseNumber>sample string 4</d2p1:HouseNumber>
      <d2p1:PostCode>sample string 1</d2p1:PostCode>
      <d2p1:Street>sample string 6</d2p1:Street>
      <d2p1:YearsAtAddressId>634fe7c6-c010-4da3-9d7a-524dcfdf35cd</d2p1:YearsAtAddressId>
    </d2p1:CurrentAddress>
    <d2p1:GenderId>964f91cf-6144-4d38-ac66-c0cd755819e1</d2p1:GenderId>
    <d2p1:GoodsDeliveryAddress>
      <d2p1:City>sample string 2</d2p1:City>
      <d2p1:Flat>sample string 3</d2p1:Flat>
      <d2p1:HouseName>sample string 5</d2p1:HouseName>
      <d2p1:HouseNumber>sample string 4</d2p1:HouseNumber>
      <d2p1:PostCode>sample string 1</d2p1:PostCode>
      <d2p1:Street>sample string 6</d2p1:Street>
      <d2p1:YearsAtAddressId>634fe7c6-c010-4da3-9d7a-524dcfdf35cd</d2p1:YearsAtAddressId>
    </d2p1:GoodsDeliveryAddress>
    <d2p1:MaidenName>sample string 2</d2p1:MaidenName>
    <d2p1:MaritalStatusId>e908f50c-d697-4918-8677-adb45530e81f</d2p1:MaritalStatusId>
    <d2p1:MiddleName>sample string 1</d2p1:MiddleName>
    <d2p1:NumberOfDependants>1</d2p1:NumberOfDependants>
    <d2p1:PreviousAddress1>
      <d2p1:City>sample string 2</d2p1:City>
      <d2p1:Flat>sample string 3</d2p1:Flat>
      <d2p1:HouseName>sample string 5</d2p1:HouseName>
      <d2p1:HouseNumber>sample string 4</d2p1:HouseNumber>
      <d2p1:PostCode>sample string 1</d2p1:PostCode>
      <d2p1:Street>sample string 6</d2p1:Street>
      <d2p1:YearsAtAddressId>634fe7c6-c010-4da3-9d7a-524dcfdf35cd</d2p1:YearsAtAddressId>
    </d2p1:PreviousAddress1>
    <d2p1:PreviousAddress2>
      <d2p1:City>sample string 2</d2p1:City>
      <d2p1:Flat>sample string 3</d2p1:Flat>
      <d2p1:HouseName>sample string 5</d2p1:HouseName>
      <d2p1:HouseNumber>sample string 4</d2p1:HouseNumber>
      <d2p1:PostCode>sample string 1</d2p1:PostCode>
      <d2p1:Street>sample string 6</d2p1:Street>
      <d2p1:YearsAtAddressId>634fe7c6-c010-4da3-9d7a-524dcfdf35cd</d2p1:YearsAtAddressId>
    </d2p1:PreviousAddress2>
    <d2p1:ResidentialStatusId>41f9f512-441e-414a-b2d6-a140dad5c4df</d2p1:ResidentialStatusId>
    <d2p1:TitleId>7bb9a6e1-a006-48b6-90ad-38d5755d589f</d2p1:TitleId>
    <d2p1:Vulnerability>true</d2p1:Vulnerability>
  </CustomerDetails>
  <EligibilityCheckId>bec48372-31a7-45c4-b8fb-9fd36c4b3b47</EligibilityCheckId>
  <EmploymentDetails xmlns:d2p1="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels">
    <d2p1:BusinessName>sample string 2</d2p1:BusinessName>
    <d2p1:EmployerName>sample string 4</d2p1:EmployerName>
    <d2p1:GrossAnnualIncome>1</d2p1:GrossAnnualIncome>
    <d2p1:HouseholdAnnualIncome>1</d2p1:HouseholdAnnualIncome>
    <d2p1:MainOccupation>sample string 3</d2p1:MainOccupation>
    <d2p1:TypeOfBusiness>sample string 1</d2p1:TypeOfBusiness>
    <d2p1:EmploymentStatusId>9ebc3deb-17e6-43fa-9431-f4172b9033c3</d2p1:EmploymentStatusId>
    <d2p1:SourceOfIncomeId>0aa59218-1b8d-4dd7-ab5f-f7ce994fb745</d2p1:SourceOfIncomeId>
    <d2p1:YearsSelfEmployedId>bbfa39b3-486c-41ae-bd9b-45837bae85a2</d2p1:YearsSelfEmployedId>
    <d2p1:YearsWithEmployerId>49dc6bc1-6c84-4821-967e-0af5c34e8b38</d2p1:YearsWithEmployerId>
  </EmploymentDetails>
  <FinanceDetails xmlns:d2p1="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels">
    <d2p1:Deposit>1</d2p1:Deposit>
    <d2p1:DescriptionOfGoods>sample string 2</d2p1:DescriptionOfGoods>
    <d2p1:Price>1</d2p1:Price>
    <d2p1:RetailersReference>sample string 3</d2p1:RetailersReference>
    <d2p1:CommissionConsent>true</d2p1:CommissionConsent>
    <d2p1:RateCardProductCode>sample string 1</d2p1:RateCardProductCode>
    <d2p1:RateCardProductId>dcc9947a-ffc8-4388-9c6a-df52ea00fc4d</d2p1:RateCardProductId>
  </FinanceDetails>
  <IpAddress>sample string 1</IpAddress>
  <Source>sample string 2</Source>
  <SuppressCustomerEmails>true</SuppressCustomerEmails>
</CreditCheckFromEligibilityRequestModel>

Response Information

Resource Description

Returns the credit check details.

UpdateCustomerBankDetailsResponse

Name	Type	Additional information
LoanApplicationId	globally unique identifier	None.
CreditCheckId	globally unique identifier	None.
Status	string	None.
StatusNumber	integer	None.
Documents	Dictionary of string [key] and string [value]	None.
DocumentsFormat	DocumentFormatEnum	None.
SignDocumentsUrl	string	None.
LoanReferenceNumber	string	None.
CreditCheckStatus	string	None.
CreditCheckStatusNumber	integer	None.
Info	string	None.
UpperAmendValue	decimal number	None.
InitialFinanceOfferDetails	FinanceOfferDetails	None.
NewFinanceOfferDetails	FinanceOfferDetails	None.

Response Formats

application/json, text/json

Sample:

{
  "LoanApplicationId": "5282044a-614f-4578-9e78-e86abeffb306",
  "CreditCheckId": "c62ff3cb-cc57-4c7f-8a8e-a81346354e5b",
  "Status": "sample string 2",
  "StatusNumber": 3,
  "Documents": {
    "sample string 1": "sample string 2",
    "sample string 3": "sample string 4"
  },
  "DocumentsFormat": 1,
  "SignDocumentsUrl": "sample string 4",
  "LoanReferenceNumber": "sample string 5",
  "CreditCheckStatus": "sample string 6",
  "CreditCheckStatusNumber": 7,
  "Info": "sample string 8",
  "UpperAmendValue": 1.0,
  "InitialFinanceOfferDetails": {
    "FirstPayment": 1.0,
    "MonthlyPayment": 2.0,
    "MonthlyInterestRate": 3.1,
    "APR": 4.1,
    "TotalInterestPayable": 5.0,
    "ProductCode": "sample string 6"
  },
  "NewFinanceOfferDetails": {
    "FirstPayment": 1.0,
    "MonthlyPayment": 2.0,
    "MonthlyInterestRate": 3.1,
    "APR": 4.1,
    "TotalInterestPayable": 5.0,
    "ProductCode": "sample string 6"
  }
}

text/html

Sample:

{"LoanApplicationId":"5282044a-614f-4578-9e78-e86abeffb306","CreditCheckId":"c62ff3cb-cc57-4c7f-8a8e-a81346354e5b","Status":"sample string 2","StatusNumber":3,"Documents":{"sample string 1":"sample string 2","sample string 3":"sample string 4"},"DocumentsFormat":1,"SignDocumentsUrl":"sample string 4","LoanReferenceNumber":"sample string 5","CreditCheckStatus":"sample string 6","CreditCheckStatusNumber":7,"Info":"sample string 8","UpperAmendValue":1.0,"InitialFinanceOfferDetails":{"FirstPayment":1.0,"MonthlyPayment":2.0,"MonthlyInterestRate":3.1,"APR":4.1,"TotalInterestPayable":5.0,"ProductCode":"sample string 6"},"NewFinanceOfferDetails":{"FirstPayment":1.0,"MonthlyPayment":2.0,"MonthlyInterestRate":3.1,"APR":4.1,"TotalInterestPayable":5.0,"ProductCode":"sample string 6"}}

application/xml, text/xml

Sample:

<UpdateCustomerBankDetailsResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.APIResponses.CreditCheckResponses">
  <CreditCheckId>c62ff3cb-cc57-4c7f-8a8e-a81346354e5b</CreditCheckId>
  <CreditCheckStatus>sample string 6</CreditCheckStatus>
  <CreditCheckStatusNumber>7</CreditCheckStatusNumber>
  <Documents xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:KeyValueOfstringstring>
      <d2p1:Key>sample string 1</d2p1:Key>
      <d2p1:Value>sample string 2</d2p1:Value>
    </d2p1:KeyValueOfstringstring>
    <d2p1:KeyValueOfstringstring>
      <d2p1:Key>sample string 3</d2p1:Key>
      <d2p1:Value>sample string 4</d2p1:Value>
    </d2p1:KeyValueOfstringstring>
  </Documents>
  <DocumentsFormat>PDF</DocumentsFormat>
  <Info>sample string 8</Info>
  <InitialFinanceOfferDetails xmlns:d2p1="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels">
    <d2p1:APR>4.1</d2p1:APR>
    <d2p1:FirstPayment>1</d2p1:FirstPayment>
    <d2p1:MonthlyInterestRate>3.1</d2p1:MonthlyInterestRate>
    <d2p1:MonthlyPayment>2</d2p1:MonthlyPayment>
    <d2p1:ProductCode>sample string 6</d2p1:ProductCode>
    <d2p1:TotalInterestPayable>5</d2p1:TotalInterestPayable>
  </InitialFinanceOfferDetails>
  <LoanApplicationId>5282044a-614f-4578-9e78-e86abeffb306</LoanApplicationId>
  <LoanReferenceNumber>sample string 5</LoanReferenceNumber>
  <NewFinanceOfferDetails xmlns:d2p1="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels">
    <d2p1:APR>4.1</d2p1:APR>
    <d2p1:FirstPayment>1</d2p1:FirstPayment>
    <d2p1:MonthlyInterestRate>3.1</d2p1:MonthlyInterestRate>
    <d2p1:MonthlyPayment>2</d2p1:MonthlyPayment>
    <d2p1:ProductCode>sample string 6</d2p1:ProductCode>
    <d2p1:TotalInterestPayable>5</d2p1:TotalInterestPayable>
  </NewFinanceOfferDetails>
  <SignDocumentsUrl>sample string 4</SignDocumentsUrl>
  <Status>sample string 2</Status>
  <StatusNumber>3</StatusNumber>
  <UpperAmendValue>1</UpperAmendValue>
</UpdateCustomerBankDetailsResponse>