# Validate a voucher

## Arguments

| Parameter | Type   | Required | Description          |
| --------- | ------ | -------- | -------------------- |
| pin       | string | true     | voucher’s pin string |

<mark style="color:green;">`POST`</mark> [`https://`](https://voucherapi.globalprimex.com/v2/vouchers/validate)`{domain given}/v2/vouchers/validate`

{% tabs %}
{% tab title="CURL" %}

```
curl https://{domain given}/v2/vouchers/validate \
  -u pk_test_BQokikJOvBiI2HlWgH4olfQ4: \
  -d pin=KLVGBEFEBPZ7B4QW
```

{% endtab %}
{% endtabs %}

The above command returns JSON structured like this:

```
{
	"id": "AWUkux58D52AoRFGa7mf2A",
	"value": 1000,
	"currency": "USD",
	"bundle": false,
	"created_at": 1534255857,
	"expires_at": 1549807857,
	"livemode": false
}
```