---
title: "Update verification state (sandbox only)"
method: PATCH
path: "/sanbox-tools/verifications/{verification-id}"
tags: ["Sandbox tools"]
---

# Update verification state (sandbox only)

`PATCH /sanbox-tools/verifications/{verification-id}`

**Sandbox only.** Changes verification status while preserving realistic flow transitions, so you can simulate states and receive notifications.

Official reference uses host `sandbox.dlocal.com` and path `/kyc/sanbox-tools/verifications/{verification-id}` (note **sanbox** spelling in the path).

## Path parameters

- `verification-id` string, required

## Request body

- object
  - `status` string, required — Target verification status. [See details](https://docs.dlocal.com/reference/verification-status).
  - `status_detail` string, required — Target status detail. [See details](https://docs.dlocal.com/reference/verification-status).

## Response `200`

Event processed successfully

## Other responses

- `400` — Bad request — invalid verification status
- `401` — Unauthorized — invalid credentials
- `403` — Forbidden — authentication failed or unauthorized access
- `404` — Verification not found
- `500` — Internal server error

---

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