---
title: "POST /v1/escrowkeyunlock"
method: POST
path: "/v1/escrowkeyunlock"
---

# POST /v1/escrowkeyunlock

`POST /v1/escrowkeyunlock`

Perform an Escrow Key Unlock against Apple's API. Uses the APNs certificate of the provided topic for mTLS authentication. Note that despite all parameters being in the HTTP body (form) this endpoint moves the appropriate parameters to the URL query parameters per Apple's documentation. The response body, status, and headers are handed straight through from the Apple endpoint.

## Response `200`

Success.

## Other responses

- `400` — Failure: bad request; likely cause is a malformed request query or body.
- `401` — API key is missing or invalid.
- `404` — Failure: device is not found, or escrowKey is invalid.
- `500` — Unexpected server error; try again later.

## Changes

- **2025-10-07** `42633d53908e` — 1 info
  - endpoint added
- **2021-07-03** `d3af2176e7e6` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/micromdm/apis/nanomdm-api/changes/v1/escrowkeyunlock/post.md)

---

[API](https://skmtc.dev/micromdm/apis/nanomdm-api.md) · [All operations](https://skmtc.dev/micromdm/apis/nanomdm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/micromdm/nanomdm-api/revisions/29fcd7c65bd8/schema)