> 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/facilities/retrieve-an-approved-facility.md).

# Retrieve an approved facility

Returns partner-scoped facility identity and a current contract-backed snapshot. `drawdown_eligibility` reports facility-level blockers; request-specific amount, corridor, and tenor checks still run when a drawdown is created.

```json
{"openapi":"3.1.0","info":{"title":"Qiro Partner Instant Settlement API","version":"1.0.0-draft"},"tags":[{"name":"Facilities","description":"Read Qiro-approved facility identity, balances, policy, and designated wallet."}],"servers":[{"url":"/","description":"Qiro API host supplied to the partner during onboarding."}],"security":[{"oauth2":["facilities: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":{"FacilityId":{"name":"facility_id","in":"path","required":true,"description":"Stable Qiro identifier for one approved LOC facility.","schema":{"type":"string","pattern":"^fac_[A-Za-z0-9]+$"}},"CorrelationId":{"name":"X-Correlation-ID","in":"header","required":true,"description":"End-to-end request identifier. When the body contains `correlation_id`, both values must match.","schema":{"type":"string","minLength":1,"maxLength":128}}},"headers":{"CorrelationId":{"description":"Echo of the request correlation identifier.","schema":{"type":"string","minLength":1,"maxLength":128}}},"schemas":{"Facility":{"type":"object","additionalProperties":false,"required":["facility_id","loc_address","client_id","client_name","client_type","status","currency","approved_limit","utilized_amount","available_amount","supported_settlement_assets","maximum_tenor_days","drawdown_eligibility","designated_wallet","resource_version","updated_at"],"properties":{"facility_id":{"type":"string","pattern":"^fac_[A-Za-z0-9]+$"},"loc_address":{"$ref":"#/components/schemas/EvmAddress"},"client_id":{"type":"string","description":"The partner's immutable identifier for the borrower."},"client_name":{"type":"string","description":"Qiro's authoritative stored borrower display name."},"client_type":{"type":"string","enum":["REMITTANCE_COMPANY"]},"status":{"$ref":"#/components/schemas/FacilityStatus"},"currency":{"type":"string","enum":["USDC","USDT"]},"approved_limit":{"$ref":"#/components/schemas/MoneyString"},"utilized_amount":{"$ref":"#/components/schemas/MoneyString"},"available_amount":{"$ref":"#/components/schemas/MoneyString"},"supported_settlement_assets":{"type":"array","minItems":1,"maxItems":1,"items":{"type":"string","enum":["USDC","USDT"]}},"maximum_tenor_days":{"type":"integer","minimum":0},"drawdown_eligibility":{"$ref":"#/components/schemas/DrawdownEligibility"},"designated_wallet":{"$ref":"#/components/schemas/DesignatedWallet"},"resource_version":{"type":"integer","minimum":1},"updated_at":{"type":"string","format":"date-time"}}},"EvmAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"FacilityStatus":{"type":"string","enum":["ACTIVE","SUSPENDED","DEFAULTED","RECOVERY_IN_PROGRESS","CLOSURE_REQUESTED","CLOSED","EXPIRED"]},"MoneyString":{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d+)?$","description":"Decimal display-unit amount. JSON numbers are not accepted."},"DrawdownEligibility":{"type":"object","additionalProperties":false,"required":["eligible","reasons"],"properties":{"eligible":{"type":"boolean"},"reasons":{"type":"array","uniqueItems":true,"items":{"type":"string","enum":["FACILITY_NOT_ACTIVE","DESIGNATED_WALLET_NOT_ACTIVE","DESIGNATED_WALLET_NOT_VERIFIED","FACILITY_STATE_MISMATCH","ACTIVE_DRAWDOWN_CONFLICT","FACILITY_PAYMENT_OVERDUE"]}}}},"DesignatedWallet":{"type":"object","additionalProperties":false,"required":["wallet_id","wallet_version","address","chain_id","purpose","status"],"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},"purpose":{"type":"string","const":"BORROWING_AND_REPAYMENT"},"status":{"type":"string","enum":["ACTIVE","INACTIVE"]}}},"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"}}}},"FacilityNotFound":{"description":"The facility 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/facilities/{facility_id}":{"get":{"tags":["Facilities"],"operationId":"getFacility","summary":"Retrieve an approved facility","description":"Returns partner-scoped facility identity and a current contract-backed snapshot.\n`drawdown_eligibility` reports facility-level blockers; request-specific amount,\ncorridor, and tenor checks still run when a drawdown is created.\n","parameters":[{"$ref":"#/components/parameters/FacilityId"},{"$ref":"#/components/parameters/CorrelationId"}],"responses":{"200":{"description":"The facility and its currently designated wallet.","headers":{"X-Correlation-ID":{"$ref":"#/components/headers/CorrelationId"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Facility"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/FacilityNotFound"},"409":{"$ref":"#/components/responses/ResourceConflict"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}}}}
```
