Start free trial

Approve parsed debt contract and create debt instrument

POST/api/v1/businesses/{business_id}/cfo-portal/debt-schedule/approve-contract

Create a debt instrument from approved parsed contract terms.

Request Body:

  • contract: ParsedDebtContract from the parse endpoint (required).
  • contract_s3_key: S3 key of the original PDF (optional, persisted on the debt instrument for later retrieval).

Returns: The new debt instrument's id, name, and lender.

Operation ID: cfo_portal_approve_debt_contract_api_v1_businesses__business_id__cfo_portal_debt_schedule_approve_contract_post·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Path

business_idstringrequired

Request body

Schema: DebtContractApproveRequest

contractParsedDebtContractrequiredParsedDebtContract

Parsed contract payload returned by the parse endpoint.

16 fields
namestringrequired
lenderstringrequired

Counterparty name. The lender for a loan to us (borrow) or the borrower for a loan we made (lend).

directionstring

DebtDirectionEnum value: 'borrow' (a loan to us — a liability) or 'lend' (a loan from us / note receivable — an asset whose interest is income). Defaults to 'borrow'.

debt_typestringrequired

DebtTypeEnum value: term_loan, line_of_credit, mortgage, equipment_loan, sba_loan, convertible_note, revenue_based, other.

original_principal_centsintegerrequired
current_balance_centsintegerrequired
interest_rate_bpsinteger

Annual interest rate in basis points (e.g. 500 = 5.00%). Set to 0 for revenue-based financing.

term_monthsinteger

Loan term in months. For revenue-based financing this is an estimate of months to cap based on assumed revenue.

start_datestringrequired

Contract start date as ISO-8601 YYYY-MM-DD.

maturity_datestringrequired

Maturity/expected payoff date as ISO-8601 YYYY-MM-DD. For RBF this is an estimate based on the share rate.

payment_frequencystring

PaymentFrequencyEnum value: monthly, quarterly, semi_annual, annual, bullet, or revenue_share.

payment_amount_centsinteger

Scheduled payment per period (fixed) or 0 for RBF.

revenue_share_bpsinteger

Revenue-share rate in basis points; only set for revenue_based debt.

total_repayment_cap_centsinteger

Total dollar cap on cumulative repayments; only set for revenue_based debt.

summarystring

One-paragraph human summary of the contract.

confidencenumber

Parsing confidence in [0, 1] reported by the LLM.

contract_s3_keystring

S3 key of the original uploaded contract; persisted on the debt instrument for later retrieval.

Responses

201Successful Response

Schema: SuccessEnvelope_DebtContractApproveResponse_

successboolean
messagestring
codestring
dataDebtContractApproveResponse

400Bad Request - Invalid input

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

404Not Found - Resource does not exist

422Validation Error

Schema: HTTPValidationError

detailarray · ValidationErrorValidationError
5 fields
locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject