GET api/v1/auctions

Gets list of active Auctions

Requires authorization!

Response Codes

  • 200 – Successfully got list of auctions
  • 401 – User is not Authorized

Request Information

URI Parameters

NameDescriptionTypeAdditional information
Countries

Two letter iso code for country of origin: EE, ES, FI

Collection of string

None.

Ratings

Bondora's rating: AA, A, B, C, D, E, F, HR

Collection of string

None.

Gender

Borrower's gender: Male 0, Female 1, Unknown 2

integer

None.

SumMin

Minimal loan amount

integer

None.

SumMax

Maximum loan amount

integer

None.

Terms

Loan length: 3, 9, 12, 18, 24, 36, 48, 60 months

Collection of integer

None.

AgeMin

Minimal age

integer

None.

AgeMax

Maximum age

integer

None.

LoanNumber

Loan number

integer

None.

UserName

Username

string

None.

ApplicationDateFrom

Loan application started date from

date

None.

ApplicationDateTo

Loan application started date to

date

None.

CreditScoreMin

Minimum credit score

integer

Obsolete: Not used actively anymore

CreditScoreMax

Maximum credit score

integer

Obsolete: Not used actively anymore

CreditScoresEeMini

Credit score for EE loans

Collection of string

None.

InterestMin

Minimum interest

decimal number

None.

InterestMax

Maximum interest

decimal number

None.

IncomeTotalMin

Minimal total income

decimal number

None.

IncomeTotalMax

Maximum total income

decimal number

None.

ModelVersion

Model version

integer

None.

ExpectedLossMin

Minimal expected loss

decimal number

None.

ExpectedLossMax

Maximum expected loss

decimal number

None.

ListedOnUTCFrom

Date when auction was published from

date

None.

ListedOnUTCTo

Date when auction was published to

date

None.

PageSize

Max items in result, up to 20000

integer

Range: inclusive between 1 and 20000

PageNr

Result page nr

integer

Range: inclusive between 1 and 2147483647

Body Parameters

None.

Response Information

Resource Description

Gets list of active Auctions
List of active Auctions set to Payload property

ApiResultAuctions
NameDescriptionTypeAdditional information
PageSize

Requested Max items in result

integer

Range: inclusive between 0 and 2147483647

PageNr

Requested page nr

integer

Range: inclusive between 1 and 2147483647

TotalCount

Total number of items found

integer

Required

Range: inclusive between 0 and 2147483647

Count

Number of items returned

integer

Required

Range: inclusive between 0 and 2147483647

Payload

The payload of the response. Type depends on the API request.

Collection of Auction

None.

Success

Indicates if the request was successfull or not. true if the request was handled successfully, false otherwise.

boolean

Required

Errors

Error(s) accociated with the API request.

Collection of ApiError

None.

Response Formats

application/json, text/json

Sample:
{
  "PageSize": 1,
  "PageNr": 2,
  "TotalCount": 3,
  "Count": 4,
  "Payload": [
    {
      "LoanId": "0867d02a-37c6-43ed-9c0e-1478376107bc",
      "AuctionId": "12767425-a850-4385-b173-9b20eb7dfe7d",
      "LoanNumber": 3,
      "UserName": "sample string-4",
      "NewCreditCustomer": 5,
      "LoanApplicationStartedDate": "2024-03-27T23:39:50.0293852+02:00",
      "PlannedCloseDate": "2024-03-27T23:39:50.0293852+02:00",
      "ApplicationSignedHour": 8,
      "ApplicationSignedWeekday": 9,
      "VerificationType": 1,
      "LanguageCode": 1,
      "Age": 10,
      "DateOfBirth": "2024-03-27T23:39:50.0293852+02:00",
      "Gender": 0,
      "Country": "sample string-11",
      "CreditScoreEsMicroL": "sample string-12",
      "CreditScoreEsEquifaxRisk": "sample string-13",
      "CreditScoreFiAsiakasTietoRiskGrade": "sample string-14",
      "CreditScoreEeMini": "sample string-15",
      "AppliedAmount": 16.0,
      "Interest": 17.0,
      "LoanDuration": 18,
      "County": "sample string-19",
      "City": "sample string-20",
      "Education": 1,
      "EmploymentDurationCurrentEmployer": "sample string-21",
      "HomeOwnershipType": 0,
      "IncomeTotal": 22.0,
      "MonthlyPayment": 23.0,
      "MonthlyPaymentDay": 24,
      "ModelVersion": 25,
      "ExpectedLoss": 26.1,
      "Rating": "sample string-27",
      "LossGivenDefault": 28.1,
      "ProbabilityOfDefault": 29.1,
      "ExpectedReturnAlpha": 30.1,
      "LiabilitiesTotal": 31.0,
      "ListedOnUTC": "2024-03-27T23:39:50.0303656+02:00",
      "ActualCloseDate": "2024-03-27T23:39:50.0303656+02:00",
      "WinningBidsAmount": 33.0,
      "RemainingAmount": 34.0,
      "UserBids": 35,
      "UserBidAmount": 36.0,
      "Fullfilled": 37.0,
      "CreditScore": 38,
      "ScoringDate": "2024-03-27T23:39:50.0303656+02:00",
      "UseOfLoan": 0,
      "MaritalStatus": 1,
      "NrOfDependants": "sample string-40",
      "EmploymentStatus": 1,
      "EmploymentPosition": "sample string-41",
      "WorkExperience": "sample string-42",
      "OccupationArea": 1,
      "IncomeFromPrincipalEmployer": 43.0,
      "IncomeFromPension": 44.0,
      "IncomeFromFamilyAllowance": 45.0,
      "IncomeFromSocialWelfare": 46.0,
      "IncomeFromLeavePay": 47.0,
      "IncomeFromChildSupport": 48.0,
      "IncomeOther": 49.0,
      "FreeCash": 50.0,
      "DebtToIncome": 51.0,
      "EADRate": 52.1,
      "MaturityFactor": 53.1,
      "InterestRateAlpha": 54.1
    },
    {
      "LoanId": "0867d02a-37c6-43ed-9c0e-1478376107bc",
      "AuctionId": "12767425-a850-4385-b173-9b20eb7dfe7d",
      "LoanNumber": 3,
      "UserName": "sample string-4",
      "NewCreditCustomer": 5,
      "LoanApplicationStartedDate": "2024-03-27T23:39:50.0293852+02:00",
      "PlannedCloseDate": "2024-03-27T23:39:50.0293852+02:00",
      "ApplicationSignedHour": 8,
      "ApplicationSignedWeekday": 9,
      "VerificationType": 1,
      "LanguageCode": 1,
      "Age": 10,
      "DateOfBirth": "2024-03-27T23:39:50.0293852+02:00",
      "Gender": 0,
      "Country": "sample string-11",
      "CreditScoreEsMicroL": "sample string-12",
      "CreditScoreEsEquifaxRisk": "sample string-13",
      "CreditScoreFiAsiakasTietoRiskGrade": "sample string-14",
      "CreditScoreEeMini": "sample string-15",
      "AppliedAmount": 16.0,
      "Interest": 17.0,
      "LoanDuration": 18,
      "County": "sample string-19",
      "City": "sample string-20",
      "Education": 1,
      "EmploymentDurationCurrentEmployer": "sample string-21",
      "HomeOwnershipType": 0,
      "IncomeTotal": 22.0,
      "MonthlyPayment": 23.0,
      "MonthlyPaymentDay": 24,
      "ModelVersion": 25,
      "ExpectedLoss": 26.1,
      "Rating": "sample string-27",
      "LossGivenDefault": 28.1,
      "ProbabilityOfDefault": 29.1,
      "ExpectedReturnAlpha": 30.1,
      "LiabilitiesTotal": 31.0,
      "ListedOnUTC": "2024-03-27T23:39:50.0303656+02:00",
      "ActualCloseDate": "2024-03-27T23:39:50.0303656+02:00",
      "WinningBidsAmount": 33.0,
      "RemainingAmount": 34.0,
      "UserBids": 35,
      "UserBidAmount": 36.0,
      "Fullfilled": 37.0,
      "CreditScore": 38,
      "ScoringDate": "2024-03-27T23:39:50.0303656+02:00",
      "UseOfLoan": 0,
      "MaritalStatus": 1,
      "NrOfDependants": "sample string-40",
      "EmploymentStatus": 1,
      "EmploymentPosition": "sample string-41",
      "WorkExperience": "sample string-42",
      "OccupationArea": 1,
      "IncomeFromPrincipalEmployer": 43.0,
      "IncomeFromPension": 44.0,
      "IncomeFromFamilyAllowance": 45.0,
      "IncomeFromSocialWelfare": 46.0,
      "IncomeFromLeavePay": 47.0,
      "IncomeFromChildSupport": 48.0,
      "IncomeOther": 49.0,
      "FreeCash": 50.0,
      "DebtToIncome": 51.0,
      "EADRate": 52.1,
      "MaturityFactor": 53.1,
      "InterestRateAlpha": 54.1
    }
  ],
  "Success": true,
  "Errors": [
    {
      "Code": 1,
      "Message": "sample string-2",
      "Details": "sample string-3"
    },
    {
      "Code": 1,
      "Message": "sample string-2",
      "Details": "sample string-3"
    }
  ]
}

application/xml, text/xml

Sample:
<ApiResultAuctions xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Sobralaen.Api.Models">
  <Errors>
    <ApiError>
      <Code>1</Code>
      <Details>sample string-3</Details>
      <Message>sample string-2</Message>
    </ApiError>
    <ApiError>
      <Code>1</Code>
      <Details>sample string-3</Details>
      <Message>sample string-2</Message>
    </ApiError>
  </Errors>
  <Success>true</Success>
  <Payload>
    <Auction>
      <ActualCloseDate>2024-03-27T23:39:50.0303656+02:00</ActualCloseDate>
      <Age>10</Age>
      <ApplicationSignedHour>8</ApplicationSignedHour>
      <ApplicationSignedWeekday>9</ApplicationSignedWeekday>
      <AppliedAmount>16</AppliedAmount>
      <AuctionId>12767425-a850-4385-b173-9b20eb7dfe7d</AuctionId>
      <City>sample string-20</City>
      <Country>sample string-11</Country>
      <County>sample string-19</County>
      <CreditScore>38</CreditScore>
      <CreditScoreEeMini>sample string-15</CreditScoreEeMini>
      <CreditScoreEsEquifaxRisk>sample string-13</CreditScoreEsEquifaxRisk>
      <CreditScoreEsMicroL>sample string-12</CreditScoreEsMicroL>
      <CreditScoreFiAsiakasTietoRiskGrade>sample string-14</CreditScoreFiAsiakasTietoRiskGrade>
      <DateOfBirth>2024-03-27T23:39:50.0293852+02:00</DateOfBirth>
      <DebtToIncome>51</DebtToIncome>
      <EADRate>52.1</EADRate>
      <Education>primary</Education>
      <EmploymentDurationCurrentEmployer>sample string-21</EmploymentDurationCurrentEmployer>
      <EmploymentPosition>sample string-41</EmploymentPosition>
      <EmploymentStatus>unEmployed</EmploymentStatus>
      <ExpectedLoss>26.1</ExpectedLoss>
      <ExpectedReturnAlpha>30.1</ExpectedReturnAlpha>
      <FreeCash>50</FreeCash>
      <Fullfilled>37</Fullfilled>
      <Gender>Male</Gender>
      <HomeOwnershipType>Homeless</HomeOwnershipType>
      <IncomeFromChildSupport>48</IncomeFromChildSupport>
      <IncomeFromFamilyAllowance>45</IncomeFromFamilyAllowance>
      <IncomeFromLeavePay>47</IncomeFromLeavePay>
      <IncomeFromPension>44</IncomeFromPension>
      <IncomeFromPrincipalEmployer>43</IncomeFromPrincipalEmployer>
      <IncomeFromSocialWelfare>46</IncomeFromSocialWelfare>
      <IncomeOther>49</IncomeOther>
      <IncomeTotal>22</IncomeTotal>
      <Interest>17</Interest>
      <InterestRateAlpha>54.1</InterestRateAlpha>
      <LanguageCode>et</LanguageCode>
      <LiabilitiesTotal>31</LiabilitiesTotal>
      <ListedOnUTC>2024-03-27T23:39:50.0303656+02:00</ListedOnUTC>
      <LoanApplicationStartedDate>2024-03-27T23:39:50.0293852+02:00</LoanApplicationStartedDate>
      <LoanDuration>18</LoanDuration>
      <LoanId>0867d02a-37c6-43ed-9c0e-1478376107bc</LoanId>
      <LoanNumber>3</LoanNumber>
      <LossGivenDefault>28.1</LossGivenDefault>
      <MaritalStatus>married</MaritalStatus>
      <MaturityFactor>53.1</MaturityFactor>
      <ModelVersion>25</ModelVersion>
      <MonthlyPayment>23</MonthlyPayment>
      <MonthlyPaymentDay>24</MonthlyPaymentDay>
      <NewCreditCustomer>5</NewCreditCustomer>
      <NrOfDependants>sample string-40</NrOfDependants>
      <OccupationArea>Other</OccupationArea>
      <PlannedCloseDate>2024-03-27T23:39:50.0293852+02:00</PlannedCloseDate>
      <ProbabilityOfDefault>29.1</ProbabilityOfDefault>
      <Rating>sample string-27</Rating>
      <RemainingAmount>34</RemainingAmount>
      <ScoringDate>2024-03-27T23:39:50.0303656+02:00</ScoringDate>
      <UseOfLoan>DebtConsolidation</UseOfLoan>
      <UserBidAmount>36</UserBidAmount>
      <UserBids>35</UserBids>
      <UserName>sample string-4</UserName>
      <VerificationType>NotVerified</VerificationType>
      <WinningBidsAmount>33</WinningBidsAmount>
      <WorkExperience>sample string-42</WorkExperience>
    </Auction>
    <Auction>
      <ActualCloseDate>2024-03-27T23:39:50.0303656+02:00</ActualCloseDate>
      <Age>10</Age>
      <ApplicationSignedHour>8</ApplicationSignedHour>
      <ApplicationSignedWeekday>9</ApplicationSignedWeekday>
      <AppliedAmount>16</AppliedAmount>
      <AuctionId>12767425-a850-4385-b173-9b20eb7dfe7d</AuctionId>
      <City>sample string-20</City>
      <Country>sample string-11</Country>
      <County>sample string-19</County>
      <CreditScore>38</CreditScore>
      <CreditScoreEeMini>sample string-15</CreditScoreEeMini>
      <CreditScoreEsEquifaxRisk>sample string-13</CreditScoreEsEquifaxRisk>
      <CreditScoreEsMicroL>sample string-12</CreditScoreEsMicroL>
      <CreditScoreFiAsiakasTietoRiskGrade>sample string-14</CreditScoreFiAsiakasTietoRiskGrade>
      <DateOfBirth>2024-03-27T23:39:50.0293852+02:00</DateOfBirth>
      <DebtToIncome>51</DebtToIncome>
      <EADRate>52.1</EADRate>
      <Education>primary</Education>
      <EmploymentDurationCurrentEmployer>sample string-21</EmploymentDurationCurrentEmployer>
      <EmploymentPosition>sample string-41</EmploymentPosition>
      <EmploymentStatus>unEmployed</EmploymentStatus>
      <ExpectedLoss>26.1</ExpectedLoss>
      <ExpectedReturnAlpha>30.1</ExpectedReturnAlpha>
      <FreeCash>50</FreeCash>
      <Fullfilled>37</Fullfilled>
      <Gender>Male</Gender>
      <HomeOwnershipType>Homeless</HomeOwnershipType>
      <IncomeFromChildSupport>48</IncomeFromChildSupport>
      <IncomeFromFamilyAllowance>45</IncomeFromFamilyAllowance>
      <IncomeFromLeavePay>47</IncomeFromLeavePay>
      <IncomeFromPension>44</IncomeFromPension>
      <IncomeFromPrincipalEmployer>43</IncomeFromPrincipalEmployer>
      <IncomeFromSocialWelfare>46</IncomeFromSocialWelfare>
      <IncomeOther>49</IncomeOther>
      <IncomeTotal>22</IncomeTotal>
      <Interest>17</Interest>
      <InterestRateAlpha>54.1</InterestRateAlpha>
      <LanguageCode>et</LanguageCode>
      <LiabilitiesTotal>31</LiabilitiesTotal>
      <ListedOnUTC>2024-03-27T23:39:50.0303656+02:00</ListedOnUTC>
      <LoanApplicationStartedDate>2024-03-27T23:39:50.0293852+02:00</LoanApplicationStartedDate>
      <LoanDuration>18</LoanDuration>
      <LoanId>0867d02a-37c6-43ed-9c0e-1478376107bc</LoanId>
      <LoanNumber>3</LoanNumber>
      <LossGivenDefault>28.1</LossGivenDefault>
      <MaritalStatus>married</MaritalStatus>
      <MaturityFactor>53.1</MaturityFactor>
      <ModelVersion>25</ModelVersion>
      <MonthlyPayment>23</MonthlyPayment>
      <MonthlyPaymentDay>24</MonthlyPaymentDay>
      <NewCreditCustomer>5</NewCreditCustomer>
      <NrOfDependants>sample string-40</NrOfDependants>
      <OccupationArea>Other</OccupationArea>
      <PlannedCloseDate>2024-03-27T23:39:50.0293852+02:00</PlannedCloseDate>
      <ProbabilityOfDefault>29.1</ProbabilityOfDefault>
      <Rating>sample string-27</Rating>
      <RemainingAmount>34</RemainingAmount>
      <ScoringDate>2024-03-27T23:39:50.0303656+02:00</ScoringDate>
      <UseOfLoan>DebtConsolidation</UseOfLoan>
      <UserBidAmount>36</UserBidAmount>
      <UserBids>35</UserBids>
      <UserName>sample string-4</UserName>
      <VerificationType>NotVerified</VerificationType>
      <WinningBidsAmount>33</WinningBidsAmount>
      <WorkExperience>sample string-42</WorkExperience>
    </Auction>
  </Payload>
  <Count>4</Count>
  <PageNr>2</PageNr>
  <PageSize>1</PageSize>
  <TotalCount>3</TotalCount>
</ApiResultAuctions>