# Set the door PIN
Source: https://docs.lomi.africa/api/events/EventsApiController_doorPin

Set the door PIN

***

title: "Set the door PIN"
description: "Set the door PIN"
full: true
method: post
path: /events/door-pin
operationId: EventsApiController\_doorPin
-----------------------------------------

## Overview

Sets the PIN that admits tickets on the verify page. It is not the payout PIN and it does not move money. Requires Ticketing. The door phone saves this PIN in the browser.

## Authentication

Merchant routes require an API key in the `X-API-KEY` header. Use a test key against `https://sandbox.api.lomi.africa` and a live key against `https://api.lomi.africa`.

## Endpoint

`POST /events/door-pin`

## Request

### Request body

| Field | Required | Type     | Description                  |
| ----- | -------- | -------- | ---------------------------- |
| `pin` | Yes      | `string` | Door PIN for the verify page |

## Responses

| Status | Description      |
| ------ | ---------------- |
| `200`  | Success          |
| `403`  | Ticketing is off |

## Errors

**403** means Ticketing is off. **401** means the API key is missing or invalid. **429** means too many requests.

## Example

```bash
curl -sS -X POST "https://sandbox.api.lomi.africa/events/door-pin" \
  -H "X-API-KEY: $LOMI_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pin":"1234"}'
```

## OpenAPI

* **operationId**: `EventsApiController_doorPin`
* **Operation**: `POST /events/door-pin`
