Here you can find changes for each of the Bondora API version.
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)CancelItemOnReschedule
Allows auto cancellation of loans on sale if they are rescheduled
POST
api/v1/secondarymarket/sell)CancelItemOnPaymentReceived
Allows 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 Auction
AuctionExtended
,UseOfLoan
MaritalStatus
NrOfDependants
EmploymentStatus
EmploymentPosition
WorkExperience
OccupationArea
IncomeFromPrincipalEmployer
IncomeFromPension
IncomeFromFamilyAllowance
IncomeFromSocialWelfare
IncomeFromLeavePay
IncomeFromChildSupport
IncomeOther
FreeCash
DebtToIncome
GET
api/v1/auction/{id},
Response object Liability
IsRefinanced
TypeOfLiability
Outstanding
CollateralType
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 BidResponse
MinAmount
GET
api/v1/bids and
GET
api/v1/bid/{id},
Response object BidSummary
RequestedBidMinimumLimit
GET
api/v1/account/investments
Added filters:PurchaseDateFrom
When you received the investment Auctions/Secondary market fromPurchaseDateTo
When you received the investment Auctions/Secondary market toSoldDateFrom
When it was sold on Secondary market from(Remember to use SalesStatus=1)SoldDateTo
When it was sold on Secondary market to(Remember to use SalesStatus=1)GET
api/v1/loanpart/{id}, response object DebtManagementEvent
Description
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 MyInvestmentItem
GET
api/v1/secondarymarket, response object SecondMarketItem
GET
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 AuctionExtended
PlannedCloseDate
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 ReportType
8
- InvestmentsV2
2
- 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 AuctionExtended
CreditScore
ScoringDate
EADRate
MaturityFactor
InterestRateAlpha
DateOfBirth
CreditScoreEsMicroL
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 parametersCreditScoreMin
CreditScoreMax
CreditScoresEeMini
GET
api/v1/secondarymarket SecondMarketItem
GET
api/v1/account/investmentsMyInvestmentItem
GET
api/v1/loanpart/{id} LoanPartDetails
PrincipalWriteOffAmount
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
BidStatusCode
POST
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 amountEmploymentPosition
Employment 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 itemsAuctionId
Auction 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/login
POST
/api/v1/logout
GET
/api/v1/userorganizations
Authorization: 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