Draw on a facility: an advance, a presentation under a letter of credit, or an item financed
/facilities/{id}/drawsDraw on a facility: an advance, a presentation under a letter of credit, or an item financed. kind is advance (the default), presentation, receivable, unit, note or card. A card draw is the card network's money already paid to a merchant, posted whatever the facility's availability and consuming the reservation the purchase placed, so only the card authorisation service (svc_cards) may post one: bank staff, any other service, a customer and every API key are refused 403 forbidden, and a replay of the same idempotency key with different terms is refused 409. Every other kind is drawn by verified bank staff holding lending:write, or by the accounts service covering an overdraft on a linked line; every other caller is refused 403.
Path parameters
idstringRequiredHeaders
Idempotency-KeystringOptionalSend on every write that creates or changes money or state; a replay with the same key returns the original result with 200.
Body parameters
amountintegerOptionalauthorization_idintegerOptionalThe approved draw authorisation this advance uses
descriptionstringOptionalitemobject or nullOptionalCollateralItem is an invoice, vehicle or mortgage note financed by a draw.
6 child attributes
debtorstringOptionaldescriptionstringOptionaldue_datestringOptionalface_amountintegerRequiredkindstringOptionalreferencestringRequiredkindstringOptionalAdvance, presentation, receivable, unit or note
referencestringOptionalReturns
200 OK
drawobjectRequiredDraw is one advance or financed item.
17 child attributes
amountintegerRequiredbusiness_datestring · dateRequiredA business date, YYYY-MM-DD
created_atstring · date-timeRequiredcurtailment_amountintegerOptionalFloor plan: principal due at each curtailment date
curtailment_daysintegerOptionaldescriptionstringOptionaldue_datestring · date or nullOptionalA business date, YYYY-MM-DD
face_amountintegerOptionalfacility_idstringRequiredidstringRequireditemobject or nullOptionalCollateralItem is an invoice, vehicle or mortgage note financed by a draw.
6 child attributes
debtorstringOptionaldescriptionstringOptionaldue_datestringOptionalface_amountintegerRequiredkindstringOptionalreferencestringRequiredjournal_idstringRequiredExample jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm
kindstringRequiredreferencestringOptionalreserve_amountintegerOptionalsettled_amountintegerRequiredstatusstringRequiredfacilityobjectRequiredFacility is a credit facility and its state.
39 child attributes
accrued_intereststringRequiredaccrued_posted_amountintegerRequiredactivated_atstring · date-time or nullOptionalannual_rate_bpsintegerRequiredavailable_amountintegerRequiredNet of active reservations
beneficiarystringOptionalborrowing_baseobject or nullOptionalBorrowingBase is a borrower's collateral certificate.
6 child attributes
base_amountintegerOptionalcertified_atstring · dateOptionalA business date, YYYY-MM-DD
inventory_advance_bpsintegerOptionalinventory_amountintegerRequiredreceivables_advance_bpsintegerOptionalreceivables_amountintegerRequiredbucketstringRequiredcharged_off_amountintegerRequiredcharged_off_atstring · date-time or nullOptionalconverted_to_loan_idstringOptionalExample loan_2tVh8nqLxq4GbDe0K1F6S9zRcWm
created_atstring · date-timeRequiredcurrency_codestringRequiredcustomer_idstringRequiredExample cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm
days_past_dueintegerRequireddecisionobjectRequired8 child attributes
decided_atstringRequireddecided_bystringOptionalThe credit officer who decided a file in review
dti_bpsintegerRequiredoutcomestringRequiredpayment_amountintegerRequiredrate_bpsintegerRequiredreasonsarray of stringsRequiredreview_reasonsarray of stringsOptionalThe automated triggers that sent it to review
draw_period_endsstring · date or nullOptionalA business date, YYYY-MM-DD
drawn_amountintegerRequireddue_datestring · date or nullOptionalA business date, YYYY-MM-DD
expirystring · date or nullOptionalA business date, YYYY-MM-DD
fees_due_amountintegerRequiredguaranteeobject or nullOptionalGuarantee is a government guarantee on a loan or facility.
3 child attributes
guaranteed_bpsintegerRequirednumberstringOptionalprogramstringRequiredSba_7a, sba_504, usda
idstringRequiredkindstringRequiredRevolving, construction, letter_of_credit, factoring, floor_plan, merchant_cash_advance, warehouse
last_statementstringOptionalledger_account_idstringOptionalExample lacc_2tVh8nqLxq4GbDe0K1F6S9zRcWm
limit_amountintegerRequiredminimum_due_amountintegerRequirednonaccrual_atstring · date-time or nullOptionalowed_amountintegerOptionalproduct_codestringRequiredproduct_versionintegerRequiredpurchased_amountintegerOptionalrepayment_startsstring · date or nullOptionalA business date, YYYY-MM-DD
reserved_amountintegerOptionalActive, unexpired reservations holding room on the line
settlement_account_idstringRequiredExample acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm
statusstringRequiredtermsobjectRequiredFacilityTerms are the product's facility rules as snapshotted on the facility.
21 child attributes
advance_bpsintegerOptionalborrowing_basebooleanOptionalconverts_to_product_codestringOptionalcurtailment_bpsintegerOptionalcurtailment_daysintegerOptionaldraw_period_monthsintegerOptionalexpiry_monthsintegerOptionalfactor_rate_bpsintegerOptionalfee_bpsintegerOptionalholdback_bpsintegerOptionalinterest_onlybooleanOptionalinventory_advance_bpsintegerOptionalmax_days_on_lineintegerOptionalmin_payment_bpsintegerOptionalmin_payment_floor_minorintegerOptionalpayment_due_daysintegerOptionalreceivables_advance_bpsintegerOptionalrecoursebooleanOptionalrepayment_monthsintegerOptionalsecured_bystringOptionaltypestringRequiredupdated_atstring · date-timeRequiredErrors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503