---
title: "Read an escrow by id"
method: GET
path: "/v1/pay/escrow/{id}"
tags: ["Voidly Pay"]
---

# Read an escrow by id

`GET /v1/pay/escrow/{id}`

State: open | released | refunded | expired. Plus amount_micro, reason, deadline_at and the lifecycle timestamps (opened_at, released_at, refunded_at) and open_envelope_hash. REDACTED BY DEFAULT: from_did, to_did, memo and refund_actor are omitted for callers who have not proved they are a party. Send x-voidly-proof signed by EITHER party to receive them. Every response carries view: full | redacted, and a redacted one carries a redaction object naming the omitted fields.

## Path parameters

- `id` string, required

## Headers

- `x-voidly-proof` string

## Response `200`

Escrow

## Other responses

- `404` — escrow_not_found

---

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