> ## Documentation Index
> Fetch the complete documentation index at: https://tapace.lk/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Void a pass

> Permanently ends a pass.

Voiding is final. The pass is marked as voided in the holder's wallet, it can't be updated, and it can no longer be added to a wallet. The holder isn't notified. The pass stays in your account. To remove it, [delete it](https://tapace.lk/docs/api-reference/passes/delete.md).

**id** `string` *required*

The pass ID.

**Idempotency-Key** `string` *required*

A unique value for this request.

### Response

Returns the [pass](https://tapace.lk/docs/api-reference/passes/get.md) with `status` set to `voided`.

### Errors

| Status | When |
| - | - |
| `404` | The pass doesn't exist. |
| `409` | The pass is already voided. |

```bash cURL theme={null}
curl -X POST https://api.tapace.lk/v1/passes/pass_7hGk2LmQ9xVt4RnB8cYe/void \
  -H "Authorization: Bearer $TAPACE_API_KEY" \
  -H "Idempotency-Key: 9a2c7e1b-4f3d-4b8a-8e6c-2d1f5a9b3c70"
```

```json 200 theme={null}
{
  "object": "pass",
  "id": "pass_7hGk2LmQ9xVt4RnB8cYe",
  "status": "voided",
  "voidedAt": "2026-10-13T12:00:00.000Z"
}
```

```json 409 theme={null}
{
  "error": {
    "type": "conflict_error",
    "message": "This pass is already voided."
  },
  "requestId": "req_8f3a2c1d9e7b6a54"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.