---
title: "Get on-ramp liveness result"
method: GET
path: "/api/fma/v1/onramp-liveness-result"
tags: ["Managed Custody Mode"]
---

# Get on-ramp liveness result

`GET /api/fma/v1/onramp-liveness-result`

Poll the result of the liveness check. After liveness_result is pass, request a new On-ramp quote and submit using the new quoteId. On-ramp is not yet available for integration; this reference is a preview.

## Headers

- `X-Api-Signature` string, required
- `X-Api-Deadline` string, required
- `X-Api-PublicKey` string, required
- `X-Ur-Id` string
- `X-External-User-Id` string

## Response `200`

Standard envelope. Business errors return HTTP 200 with a non-zero code.

- McLivenessResultResponse — Standard UR OpenAPI response envelope. code 0 means success; a non-zero code is a business error described by message.
  - `code` integer, required — 0 on success; non-zero business error code.
  - `message` string, required — Human-readable explanation. May be empty on success.
  - `data` McLivenessResultData
    - `liveness_result` string — Liveness check outcome, e.g. pass or pending.
    - `checked_at` integer — Check timestamp in Unix seconds.
    - `expired_at` integer — Result expiry timestamp in Unix seconds.
    - `liveness_fail_reason` string — Failure reason; empty on pass.
    - `liveness_locked` boolean — True when the user is locked out after repeated failures.
    - `liveness_unlock_at` integer — Unlock timestamp in Unix seconds; 0 when not locked.

---

[API](https://skmtc.net/ur/apis/ur-api.md) · [All operations](https://skmtc.net/ur/apis/ur-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ur/ur-api/revisions/087dcf516ce2/schema)