> For the complete documentation index, see [llms.txt](https://docs.qiro.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qiro.fi/developer-section/openapi-spec/repayments/preview-full-repayment-of-one-drawdown.md).

# Preview full repayment of one drawdown

Returns an optional, non-reserving payoff preview. The preview is not required to create a repayment and does not freeze the displayed amount. It includes facility-level obligations because the contract pays those before the selected drawdown. Qiro reads fresh dues again when repayment is created.

```json
{"openapi":"3.1.0","info":{"title":"Qiro Partner Instant Settlement API","version":"1.0.0-draft"},"tags":[{"name":"Repayments","description":"Preview, prepare, and track full repayment of one funded drawdown."}],"servers":[{"url":"/","description":"Qiro API host supplied to the partner during onboarding."}],"security":[{"oauth2":["repayments:read"]}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"/oauth/token","scopes":{"facilities:read":"Read facilities owned by the authenticated partner.","drawdowns:read":"Read partner drawdown resources.","drawdowns:write":"Create and prepare partner drawdowns.","repayments:read":"Read dues quotes and repayment resources.","repayments:write":"Create and prepare repayments.","closures:read":"Read facility closure dues and closure resources.","closures:write":"Create and prepare facility closures."}}}}},"parameters":{"DrawdownId":{"name":"drawdown_id","in":"path","required":true,"description":"Stable Qiro identifier for one partner drawdown workflow.","schema":{"type":"string","pattern":"^drw_[A-Za-z0-9]+$"}},"OptionalCorrelationId":{"name":"X-Correlation-ID","in":"header","required":false,"description":"Optional end-to-end request identifier. The SDK supplies one automatically; Qiro generates and echoes one when absent.","schema":{"type":"string","minLength":1,"maxLength":128}}},"headers":{"CorrelationId":{"description":"Echo of the request correlation identifier.","schema":{"type":"string","minLength":1,"maxLength":128}}},"schemas":{"RepaymentQuote":{"type":"object","additionalProperties":false,"required":["drawdown_id","facility_id","repayment_asset","funded_drawdown_id","loc_address","token_address","token_decimals","designated_wallet","facility","selected_drawdown","quoted_total","maximum_repayment","calculated_at"],"properties":{"drawdown_id":{"type":"string","pattern":"^drw_[A-Za-z0-9]+$"},"facility_id":{"type":"string","pattern":"^fac_[A-Za-z0-9]+$"},"repayment_asset":{"type":"string","enum":["USDC","USDT"]},"funded_drawdown_id":{"$ref":"#/components/schemas/UnsignedIntegerString"},"loc_address":{"$ref":"#/components/schemas/EvmAddress"},"token_address":{"$ref":"#/components/schemas/EvmAddress"},"token_decimals":{"type":"integer","minimum":0,"maximum":18},"designated_wallet":{"$ref":"#/components/schemas/RepaymentDesignatedWallet"},"facility":{"type":"object","additionalProperties":false,"required":["interest","late_fees","total"],"properties":{"interest":{"$ref":"#/components/schemas/RepaymentMoney"},"late_fees":{"$ref":"#/components/schemas/RepaymentMoney"},"total":{"$ref":"#/components/schemas/RepaymentMoney"}},"description":"Facility-level obligations paid before the selected drawdown."},"selected_drawdown":{"type":"object","additionalProperties":false,"required":["principal","interest","late_fees","total"],"properties":{"principal":{"$ref":"#/components/schemas/RepaymentMoney"},"interest":{"$ref":"#/components/schemas/RepaymentMoney"},"late_fees":{"$ref":"#/components/schemas/RepaymentMoney"},"total":{"$ref":"#/components/schemas/RepaymentMoney"}}},"quoted_total":{"$ref":"#/components/schemas/RepaymentMoney"},"maximum_repayment":{"allOf":[{"$ref":"#/components/schemas/RepaymentMoney"}],"description":"Buffered maximum encoded in the repayment transaction; the contract consumes only actual dues."},"calculated_at":{"type":"string","format":"date-time"}}},"UnsignedIntegerString":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"EvmAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"RepaymentDesignatedWallet":{"type":"object","additionalProperties":false,"required":["wallet_id","wallet_version","address","chain_id"],"properties":{"wallet_id":{"type":"string","pattern":"^wal_[A-Za-z0-9]+$"},"wallet_version":{"type":"integer","minimum":1},"address":{"$ref":"#/components/schemas/EvmAddress"},"chain_id":{"type":"integer","minimum":1}}},"RepaymentMoney":{"type":"object","additionalProperties":false,"required":["amount","amount_base_units"],"properties":{"amount":{"$ref":"#/components/schemas/MoneyString"},"amount_base_units":{"$ref":"#/components/schemas/UnsignedIntegerString"}}},"MoneyString":{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d+)?$","description":"Decimal display-unit amount. JSON numbers are not accepted."},"ErrorResponse":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code."},"message":{"type":"string","description":"Safe human-readable explanation."},"request_id":{"type":"string"},"correlation_id":{"type":"string"},"retryable":{"type":"boolean"},"details":{"type":"object","additionalProperties":true},"issues":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"BadRequest":{"description":"Invalid schema, field format, or correlation identifier.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Unauthorized":{"description":"The bearer token is missing, invalid, or expired.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Forbidden":{"description":"The authenticated partner does not own the resource or lacks the required scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"DrawdownNotFound":{"description":"The drawdown was not found for the authenticated partner.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"ResourceConflict":{"description":"Idempotency, workflow state, or verified facility identity conflicts with the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"ServiceUnavailable":{"description":"Contract, RPC, subgraph, or reconciliation infrastructure is temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/v1/drawdowns/{drawdown_id}/dues":{"get":{"tags":["Repayments"],"operationId":"getDrawdownDues","summary":"Preview full repayment of one drawdown","description":"Returns an optional, non-reserving payoff preview. The preview is not required to create a\nrepayment and does not freeze the displayed amount. It includes facility-level obligations\nbecause the contract pays those before the selected drawdown. Qiro reads fresh dues again\nwhen repayment is created.\n","parameters":[{"$ref":"#/components/parameters/DrawdownId"},{"$ref":"#/components/parameters/OptionalCorrelationId"}],"responses":{"200":{"description":"Current informational full-payoff preview.","headers":{"X-Correlation-ID":{"$ref":"#/components/headers/CorrelationId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RepaymentQuote"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/DrawdownNotFound"},"409":{"$ref":"#/components/responses/ResourceConflict"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}}}}
```
