---
title: "Simulate void"
method: POST
path: "/v1/simulate/void"
tags: ["Transaction"]
---

# Simulate void

`POST /v1/simulate/void`

Voids a pending authorization. If `amount` is not set, the full amount will be voided. Can be used on partially voided transactions but not partially cleared transactions. _Simulating an authorization expiry on credit authorizations or credit authorization advice is not currently supported but will be added soon._

## Request body

- object
  - `amount` integer — Amount (in cents) to void. Typically this will match the amount in the original authorization, but can be less. Applies to authorization reversals only. An authorization expiry will always apply to the full pending amount.
  - `token` string, uuid, required — The transaction token returned from the /v1/simulate/authorize response.
  - `type` 'AUTHORIZATION_EXPIRY' | 'AUTHORIZATION_REVERSAL' — Type of event to simulate. Defaults to `AUTHORIZATION_REVERSAL`. * `AUTHORIZATION_EXPIRY` indicates authorization has expired and been reversed by Lithic. * `AUTHORIZATION_REVERSAL` indicates authorization was reversed by the merchant.

## Response `201`

OK

- object
  - `debugging_request_id` string, uuid — Debugging request ID to share with Lithic Support team.

## Other responses

- `400` — A parameter in the query given in the request does not match the valid queries for the endpoint.
- `401` — | | | |---|---| | User has not been authenticated | Invalid or missing API key | | API key is not active | The API key used is no longer active | | Could not find API key | The API key provided is not associated with any user | | Please provide API key in Authorization header | The Authorization header is not in the request | | Please provide API key in the form Authorization: [api-key] | The Authorization header is not formatted properly | | Insufficient privileges. Issuing API key required | Write access requires an Issuing API key. Reach out at [lithic.com/contact](https://lithic.com/contact) | | Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege | Reach out at [lithic.com/contact](https://lithic.com/contact) |
- `404` — The specified resource was not found.
- `429` — Client has exceeded the number of allowed requests in a given time period. | | | |---|---| | Rate limited, too many requests per second | User has exceeded their per second rate limit | | Rate limited, reached daily limit | User has exceeded their daily rate limit | | Rate limited, too many keys tried | One IP has queried too many different API keys |

---

[API](https://skmtc.net/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.net/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/revisions/53ab5d4e2adb/schema)