Here you can find changes for each of the Bondora API version.
POST api/v1/report maximum days that can be retrieved within a single report to 731 days.
Balance endpoint:
Expect: 100-continue that was creating issues for some HTTP tunnels/proxies.SecondMarketItem:
GET api/v1/loanpart/list,
POST api/v1/loanpart/list,
GET api/v1/secondarymarket/list,
POST api/v1/secondarymarket/list
limits to 12 per hour.GET api/v1/secondarymarket,
GET api/v1/secondarymarket/{id},
GET api/v1/secondarymarket/list
limits to 5 per hour.GET api/v1/account/balance,
which is the same as one request every 5 minutes, on average.Maximum page sizes on the following endpoints:
GET api/v1/account/investments to 50,000GET api/v1/secondarymarket to 100,000The default page size on all endpoints that have paging is 10,000 items.
Throttling limit on
GET api/v1/account/investments
to 5 requests per hour.
POST /api/v1/secondarymarket/buy succeeds or fails.
The posted payload data is a SecondMarketBuyResult object.GET and POST to the existing bulk ID endpoints:
There are now two new API endpoints that support requesting more data than a single item at a time. This should help make your apps faster and also to reduce the load to our backend systems. The new endpoints accept a list of up to 1000 ID's in a request body object.
GET api/v1/loanpart/list
As a replacement for GET api/v1/loanpart/{id}
GET api/v1/secondarymarket/list
As a replacement for GET api/v1/secondarymarket/{id}
Some changes regarding webhooks error handling:
Read more about error handling.
SecondMarketItem
SecondMarketItem
SecondMarketItemSummary
SecondMarketItemSummary
AuctionExtended
AuctionSummary
POST oauth/access_token non expiring OAuth token implemented, to specify that the generated token should not expire.(non_expiring=true).
GET api/v1/account/investments):PageSize:PageSize Maximum results is now 10000
POST api/v1/secondarymarket/sell)CancelItemOnRescheduleAllows auto cancellation of loans on sale if they are rescheduled
POST api/v1/secondarymarket/sell)CancelItemOnPaymentReceivedAllows auto cancellation of loans on sale if they receive new repayments
Changes to Auctions (GET api/v1/auctions), the auctions will be open for 30 seconds now and we expect to reduce the time in the future when the system becomes more effective.
GET api/v1/auctions and
GET api/v1/auction/{id},
Response object AuctionAuctionExtended,UseOfLoanMaritalStatusNrOfDependantsEmploymentStatusEmploymentPositionWorkExperienceOccupationAreaIncomeFromPrincipalEmployerIncomeFromPensionIncomeFromFamilyAllowanceIncomeFromSocialWelfareIncomeFromLeavePayIncomeFromChildSupportIncomeOtherFreeCashDebtToIncomeGET api/v1/auction/{id},
Response object LiabilityIsRefinancedTypeOfLiabilityOutstandingCollateralType
Changes to Auction bidding because of the new funding algorithm where the bid amount is automatically lowered for all bids proportionally when auction is overbidded.
The minimum bid amount (MinAmount) now does not have any effect and is ignored. Also, the bid amount can be reduced as low as 1 eur.
POST api/v1/bid,
Request object Bid and
Response object BidResponseMinAmountGET api/v1/bids and
GET api/v1/bid/{id},
Response object BidSummaryRequestedBidMinimumLimit
GET api/v1/account/investments
Added filters:PurchaseDateFromWhen you received the investment Auctions/Secondary market fromPurchaseDateToWhen you received the investment Auctions/Secondary market toSoldDateFromWhen it was sold on Secondary market from(Remember to use SalesStatus=1)SoldDateToWhen it was sold on Secondary market to(Remember to use SalesStatus=1)GET api/v1/loanpart/{id}, response object DebtManagementEventDescription
GET api/v1/publicdataset This is the same output as you get from the Public Reports page -> Loan Dataset. Use this endpoint instead of GET api/v1/loandataset
GET api/v1/account/investments
MyInvestmentItem Fixed NoteLoanTransfersMainAmount value, which was same as PrincipalRepaid
GET api/v1/account/investments, response object MyInvestmentItemGET api/v1/secondarymarket, response object SecondMarketItemGET api/v1/loanpart/{id}, response object LoanPartDetails
Added new fields:
DebtServicingCostMainAmount Debt servicing cost (former partial write off) value for principal amountDebtServicingCostInterestAmount Debt servicing cost (former partial write off) value for interest amountDebtServicingCostPenaltyAmount Debt servicing cost (former partial write off) value for penalty amountDebtServicingCostTotal Total Debt servicing cost (former partial write off) amount (*only for MyInvestmentItem)PrincipalWriteOffAmount Final write off value for principal amountInterestWriteOffAmount Final write off value for interest amountPenaltyWriteOffAmount Final write off value for penalty amountWriteOffTotal Total Final write off amount (*only for MyInvestmentItem)GET api/v1/report/{id} With response type ReportType 8 - InvestmentsV2, response object InvestmentsListReportLineV2
Added new fields:
PrincipalDebtServicingCost Debt servicing cost (formaer partial write off) value for principal amountInterestAndPenaltyDebtServicingCost Debt servicing cost (formaer partial write off) value for interest and principal amountPrincipalWriteOffs Final write off value for principal amountInterestAndPenaltyWriteOffs Final write off value for interest and penalty amount
GET api/v1/auctions and GET api/v1/auction/{id} Changes to return type Auction and AuctionExtendedPlannedCloseDate Date and time when the auction is closed, if it's not funded 100% before that. Auction will be closed before that, if auction is funded 100%.ActualCloseDate Date and time when the auction was actually closed. Is null, if auction is active.WinningBidsAmount The amount that auction is fulfilled, taken amount only bids where investors have enough funds.RemainingAmount The amount that is remaining to be funded (AppliedAmount - WinningBidsAmount).UserBids How many bids current user has bidden into the auctionUserBidAmount How much current user has bidden into the auctionFullfilled Precentage, how much the auction is fulfilled. Can be more than 100%, if overfunded.
POST api/v1/report Changed ReportType8 - InvestmentsV22 - Investments is obsolete and not allowed anymore for creating new reports. Please use the InvestmentsV2 from now on.GET api/v1/report/{id} New response type InvestmentsListReportLineV2 added for ReportType 8 - InvestmentsV2
GET api/v1/auctions and GET api/v1/auction/{id} Changes to return type Auction and AuctionExtendedCreditScoreScoringDateEADRateMaturityFactorInterestRateAlphaDateOfBirthCreditScoreEsMicroL Credit scoring for ES loansCreditScoreEsEquifaxRisk Credit scoring for ES loans from EquifaxCreditScoreFiAsiakasTietoRiskGrade Credit scoring for FI loansCreditScoreEeMini Credit scoring for EE loansGET api/v1/auctions Changed request parametersCreditScoreMinCreditScoreMaxCreditScoresEeMini
GET api/v1/secondarymarket SecondMarketItemGET api/v1/account/investmentsMyInvestmentItemGET api/v1/loanpart/{id} LoanPartDetailsPrincipalWriteOffAmount Total amount of principal written offInterestWriteOffAmount Total amount of interest written offPenaltyWriteOffAmount Total amount of penalty written off
GET api/v1/loandataset
LoanDatasetItem[Deprecated] Fixed CurrentDebtDays property type (changed from boolean to integer)
GET api/v1/bids
BidSummary Added Accepted BidStatusCodePOST api/v1/bid/{id}/cancel
Pending and Accepted BidStatusCode
GET api/v1/auction/{id}
BorrowerHistory object for Borrower's historical data.GET api/v1/secondarymarket and GET api/v1/account/investmentsLastPaymentDate Last payment dateLoanStatusActiveFrom Loan status active from date and timeDebtOccuredOnFrom Principal debt started date fromDebtOccuredOnTo Principal debt started date toDebtOccuredOnForSecondaryFrom Interest debt started date fromDebtOccuredOnForSecondaryTo Interest debt started date toDefaultedDateFrom Defaulted date fromDefaultedDateTo Defaulted date toRescheduledFrom Rescheduled date fromRescheduledTo Rescheduled date toLastPaymentDateFrom Last payment date fromLastPaymentDateTo Last payment date toAdded Reporting:
GET api/v1/reports List of all reportsGET api/v1/report/{id} Get report data by report idPOST api/v1/report Request to generate specified report type for set period
Added fields (additional to TotalCount) to all responses for lists that use paging:
PageSize Requested Max items in resultPageNr Requested page nrCount Number of items returned
GET api/v1/loandataset Provides daily dataset of all loan data that is not covered by the data protection lawsGET api/v1/auctions and GET api/v1/auction/{id} Added new fields:
FreeCash Discretionary incomeDebtToIncome Debt to income ratioMonthlyPayment Loan monthly payment amountEmploymentPositionEmployment positionOPTION requests don't enable throttling on actual API request.POST api/v1/secondarymarket/cancel For removing multiple loans from secondary marketGET api/v1/eventlog Gets events that have been made with the application related to current access token (EventDate, EventType, IpAddress and Data).POST oauth/access_token OAuth Refresh Token flow implemented (grant_type=refresh_token).GET api/v1/secondarymarket Added new filters:
PriceMin Price amount minPriceMax Price amount maxLoanStatusCode Loan status code, you can specify multiple itemsAuctionIdAuction identifier to find specific auction in marketPOST oauth/access_token/revoke Revoke the Access Token (The Access Token must be provided in the header as Authorization: Bearer {access_token}).404 and correct JSON result is returned.GET api/v1/account/balance Gets your account balance information (Balance, Reserved, BidRequestAmount and TotalAvailable).Access-Control-Allow-Origin: * header also when throttling is triggered and request limit header and response is returned.GET api/v1/auction/{id} endpoint error when no auction with given id was not found. Now returns correct status code 404 and error data.POST api/v1/bid bidding returned error that the amount should be divisible by 5 if no MinAmount was specified.Main version for API is v1 - /api/v1/endpoint
POST oauth/access_token Requesting OAuth 2.0 Authorization tokenGET api/v1/secondarymarket Get the secondary market item summaryGET api/v1/secondarymarket/{id} endpointPOST api/v1/secondarymarket/buy Buy loans from secondary marketPOST api/v1/secondarymarket/sell Sell your loans to secondary marketPOST api/v1/secondarymarket/{id}/cancel Remove your loan from secondary marketGET api/v1/loanpart/{id} Gets LoanPartDetails info by identifierPOST api/v1/bid/{id}/cancel Cancel the BidGET api/v1/bid/{id} Now returns bid detailsGET api/v1/account/investments Gets list of your investmentsGET api/v1/auctions Fixed not working filtersGET api/v1/auction/{id} Mode detailed info addedGET api/v1/bids Parameter names changed, paging added (PageSize and PageNr prameters)POST api/v1/bid Now returns Bid(s) id and bid(s) details that were submited with the requests.POST /api/v1/loginPOST /api/v1/logoutGET /api/v1/userorganizationsAuthorization: Token <token> headerPOST api/v1/bid Makes bid(s) into specified auction(s).GET api/v1/bids Gets list of bids the investor has madeGET api/v1/auctions Gets list of active AuctionsGET api/v1/auction/{id} Gets Auction info by auction identifierPOST api/v1/login Authenticate and get the API TokenPOST api/v1/logout Revoke the API TokenGET api/v1/userorganizations Get User's represented Organizations