> 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/retrieve-repayment-status.md).

# Retrieve repayment status

```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":{"RepaymentId":{"name":"repayment_id","in":"path","required":true,"description":"Stable Qiro identifier for one drawdown repayment workflow.","schema":{"type":"string","pattern":"^rpy_[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}}},"schemas":{"Repayment":{"type":"object","additionalProperties":false,"required":["repayment_id","drawdown_id","facility_id","funded_drawdown_id","status","repayment_asset","loc_address","token_address","token_decimals","designated_wallet","latest_quoted_total","latest_maximum_repayment","correlation_id","failure","verified_allocation","blockchain_evidence","created_at","updated_at","resource_version"],"properties":{"repayment_id":{"type":"string","pattern":"^rpy_[A-Za-z0-9]+$"},"drawdown_id":{"type":"string","pattern":"^drw_[A-Za-z0-9]+$"},"facility_id":{"type":"string","pattern":"^fac_[A-Za-z0-9]+$"},"funded_drawdown_id":{"$ref":"#/components/schemas/UnsignedIntegerString"},"status":{"$ref":"#/components/schemas/RepaymentStatus"},"repayment_asset":{"type":"string","enum":["USDC","USDT"]},"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/BoundWallet"},"latest_quoted_total":{"$ref":"#/components/schemas/RepaymentMoney"},"latest_maximum_repayment":{"description":"Fixed operation maximum established when the repayment was created. Later preparation calls refresh current dues but do not increase this cap.","$ref":"#/components/schemas/RepaymentMoney"},"verified_allocation":{"oneOf":[{"type":"object","additionalProperties":false,"required":["total_paid_base_units","principal_paid_base_units","interest_paid_base_units","late_fees_paid_base_units"],"properties":{"total_paid_base_units":{"$ref":"#/components/schemas/UnsignedIntegerString"},"principal_paid_base_units":{"$ref":"#/components/schemas/UnsignedIntegerString"},"interest_paid_base_units":{"$ref":"#/components/schemas/UnsignedIntegerString"},"late_fees_paid_base_units":{"$ref":"#/components/schemas/UnsignedIntegerString"}}},{"type":"null"}]},"correlation_id":{"type":"string"},"failure":{"oneOf":[{"$ref":"#/components/schemas/WorkflowReason"},{"type":"null"}]},"blockchain_evidence":{"type":"array","items":{"$ref":"#/components/schemas/OperationChainEvidence"}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"resource_version":{"type":"integer","minimum":1}}},"UnsignedIntegerString":{"type":"string","pattern":"^(0|[1-9]\\d*)$"},"RepaymentStatus":{"type":"string","enum":["READY_FOR_SUBMISSION","SUBMITTING","CONFIRMING","REPAID","FAILED"]},"EvmAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"BoundWallet":{"type":"object","additionalProperties":false,"required":["wallet_id","wallet_version"],"properties":{"wallet_id":{"type":"string","pattern":"^wal_[A-Za-z0-9]+$"},"wallet_version":{"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."},"WorkflowReason":{"type":"object","additionalProperties":false,"required":["code"],"properties":{"code":{"type":"string","minLength":1}}},"OperationChainEvidence":{"type":"object","additionalProperties":false,"required":["event_name","chain_id","contract_address","transaction_hash","log_index","block_number","block_hash","observed_at"],"properties":{"event_name":{"type":"string","enum":["RepaymentMade","DrawdownRepaid","LOCClosed","RecoveryRecorded"]},"chain_id":{"type":"integer","minimum":1},"contract_address":{"$ref":"#/components/schemas/EvmAddress"},"transaction_hash":{"$ref":"#/components/schemas/TransactionHash"},"log_index":{"type":"integer","minimum":0},"block_number":{"$ref":"#/components/schemas/UnsignedIntegerString"},"block_hash":{"$ref":"#/components/schemas/TransactionHash"},"observed_at":{"type":"string","format":"date-time"},"total_amount_base_units":{"$ref":"#/components/schemas/UnsignedIntegerString"},"principal_paid_base_units":{"$ref":"#/components/schemas/UnsignedIntegerString"},"interest_paid_base_units":{"$ref":"#/components/schemas/UnsignedIntegerString"},"late_fees_paid_base_units":{"$ref":"#/components/schemas/UnsignedIntegerString"}}},"TransactionHash":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"},"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"}}}},"ResourceNotFound":{"description":"The requested workflow resource was not found for the authenticated partner.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/v1/repayments/{repayment_id}":{"get":{"tags":["Repayments"],"operationId":"getRepayment","summary":"Retrieve repayment status","parameters":[{"$ref":"#/components/parameters/RepaymentId"},{"$ref":"#/components/parameters/OptionalCorrelationId"}],"responses":{"200":{"description":"Current repayment state and verified evidence.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Repayment"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/ResourceNotFound"}}}}}}
```
