# Retrieve a token

<mark style="color:yellow;">`POST`</mark> `/v1/tokens/:id`

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

```
curl https://{provided url}/v1/tokens/aH79qManT3uP4vCKzUiryQ \
  -u sk_test_yFStF-KUmgr-7CoumuY2JA: \
  -H 'Content-Type: application/application/x-www-form-urlencoded'
```

{% endtab %}
{% endtabs %}

The above command returns JSON structured like this:

```json
{
	"id": "aH79qManT3uP4vCKzUiryQ",
	"type": "card",
	"client_ip": "127.0.0.1",
	"created_at": 1627464935,
	"fingerprint": "-hzCuTB1NmGekIyKul2aRAH2rMsbJwKUAvMmQfApbv8",
	"merchant": "7qc0R04oQ0uyGG8goQqHrg",
	"usage": "single_use",
	"customer": "",
	"card": {
		"name": "John Doe",
		"last4": "4242",
		"brand": "visa",
		"exp_month": 12,
		"exp_year": 2022,
		"address_line1": "Address Line 1",
		"address_line2": "",
		"address_city": "Address City",
		"address_country": "PL",
		"address_zip": "24310",
		"address_state": "sk"
	}
}
```

## Arguments <a href="#arguments-2" id="arguments-2"></a>

| Parameter | Type   | Required | Description                  |
| --------- | ------ | -------- | ---------------------------- |
| token     | string | required | The ID of the desired token. |

## Returns <a href="#returns-2" id="returns-2"></a>

Returns a token if a valid ID was provided. Returns an error otherwise.