200Successful Response
Schema: SuccessEnvelope_CreditLineResponse_
successbooleanmessagestringcodestringdataCreditLineResponse
/api/v1/credit/lines/{credit_line_id}Change the repayment account, AutoPay, the credit limit, or the status.
Supplying credit_limit_cents re-approves the line: it emits
credit.line.limit_changed and pushes the new available credit to
the issuer. This is the write behind Request More Funding.
Supplying status needs reason and emits
credit.line.suspended, credit.line.reinstated or
credit.line.closed. Activating a pending line whose disclosure
awaits the merchant's acknowledgement needs acknowledgement_override
from an operator.
Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.
credit_line_idstringrequiredSchema: CreditLineUpdateRequest
linked_account_namestringDisplay name of the merchant's repayment account.
linked_account_maskstringLast digits of the repayment account.
plaid_account_idstringThe merchant's Plaid account the repayments leave from.
autopay_enabledbooleanSwitch AutoPay due events on or off for the line.
merchant_emailstringWhere statements and borrower notices go.
merchant_business_idstringThe borrower's own DayZero business, when it keeps its books here. An underwriting assessment for the line measures this business. Must be a business the caller can access.
merchant_legal_namestringThe merchant's legal entity name, as printed on disclosures. Cannot be cleared while the program's compliance.enabled is true.
merchant_statestringTwo-letter US state, DC or territory code of the merchant. Selects the disclosure template. Cannot be cleared while the program's compliance.enabled is true.
merchant_addressMerchantAddressThe merchant's registered address. Cannot be cleared while the program's compliance.enabled is true.
statusCreditLineStatusEnumMove the line between pending, active, suspended and closed. A change needs reason. Suspending, reinstating (suspended back to active) and closing emit credit.line.suspended, credit.line.reinstated and credit.line.closed. Closing is refused for an API token when the program's limit_change_policy is console_only. Sending the status the line already has changes nothing. Activating a pending line pushes its available credit to the issuer (or emits credit.line.limit_changed for partner-managed cards); while its disclosure awaits the merchant's acknowledgement it is refused (CREDIT_617) unless an operator sends acknowledgement_override.
reasonstringWhy the status changed. Required with a status change; carried on the event and returned as status_reason on the line.
acknowledgement_overrideAcknowledgementOverrideActivate a pending line whose disclosure awaits the merchant's acknowledgement without it. Operators in the console only: an API token sending it is 403 (CREDIT_618). The disclosure becomes overridden with who, when and reason, and credit.disclosure.overridden is emitted. Ignored on any other status change, or when nothing awaits acknowledgement.
reason_codestringOptional category of a suspension or closure: credit_risk, delinquency, fraud, merchant_request or administrative. On a program with adverse-action notices on, the first three record an adverse action.
credit_limit_centsintegerRe-approved limit, in cents. This is the write behind Request More Funding (§6.1) and behind a risk-led reduction. Changing it emits credit.line.limit_changed and pushes the new available credit to the issuer, so the card starts declining at the new limit. A reduction below the current balance is allowed — available credit floors at zero and existing loans keep their own terms. Follows the program's limit_change_policy: under approval_required every caller gets 409 (submit a limit-change request instead); under console_only an API token gets 403.
limit_change_reasonstringWhy the limit moved. Carried on the event and the ledger so an increase can be traced to the decision behind it.
Schema: SuccessEnvelope_CreditLineResponse_
successbooleanmessagestringcodestringdataCreditLineResponseSchema: ErrorResponse
errorstringrequiredError category: validation_error, unauthorized, forbidden, not_found, conflict, rate_limited, server_error, or service_unavailable.
messagestringrequiredHuman-readable explanation, safe to show to end users.
codestringrequiredStable machine-readable code in CATEGORY_NNN form (e.g. NOT_FOUND_006, AUTH_010, GEN_002).
request_idstringCorrelation id for support requests. Echoes the x-request-id request header when one was supplied.
errorsobjectField-level validation messages keyed by field name. Present on 400/422 validation failures only.
Schema: ErrorResponse
errorstringrequiredError category: validation_error, unauthorized, forbidden, not_found, conflict, rate_limited, server_error, or service_unavailable.
messagestringrequiredHuman-readable explanation, safe to show to end users.
codestringrequiredStable machine-readable code in CATEGORY_NNN form (e.g. NOT_FOUND_006, AUTH_010, GEN_002).
request_idstringCorrelation id for support requests. Echoes the x-request-id request header when one was supplied.
errorsobjectField-level validation messages keyed by field name. Present on 400/422 validation failures only.
Schema: ErrorResponse
errorstringrequiredError category: validation_error, unauthorized, forbidden, not_found, conflict, rate_limited, server_error, or service_unavailable.
messagestringrequiredHuman-readable explanation, safe to show to end users.
codestringrequiredStable machine-readable code in CATEGORY_NNN form (e.g. NOT_FOUND_006, AUTH_010, GEN_002).
request_idstringCorrelation id for support requests. Echoes the x-request-id request header when one was supplied.
errorsobjectField-level validation messages keyed by field name. Present on 400/422 validation failures only.
Schema: ErrorResponse
errorstringrequiredError category: validation_error, unauthorized, forbidden, not_found, conflict, rate_limited, server_error, or service_unavailable.
messagestringrequiredHuman-readable explanation, safe to show to end users.
codestringrequiredStable machine-readable code in CATEGORY_NNN form (e.g. NOT_FOUND_006, AUTH_010, GEN_002).
request_idstringCorrelation id for support requests. Echoes the x-request-id request header when one was supplied.
errorsobjectField-level validation messages keyed by field name. Present on 400/422 validation failures only.
Schema: ErrorResponse
errorstringrequiredError category: validation_error, unauthorized, forbidden, not_found, conflict, rate_limited, server_error, or service_unavailable.
messagestringrequiredHuman-readable explanation, safe to show to end users.
codestringrequiredStable machine-readable code in CATEGORY_NNN form (e.g. NOT_FOUND_006, AUTH_010, GEN_002).
request_idstringCorrelation id for support requests. Echoes the x-request-id request header when one was supplied.
errorsobjectField-level validation messages keyed by field name. Present on 400/422 validation failures only.