# Get multi-use or durable card tokens

{% hint style="info" %}
See [Getting Started](https://app.gitbook.com/s/j9heLdoDRsfnChUQohvj/api/payments/getting-started) before calling the [Vault API](https://app.gitbook.com/s/j9heLdoDRsfnChUQohvj/api/payments/cards/vault) to get tokens.
{% endhint %}

To get all tokens associated with a specific merchant:

1. Use **GET** method to call the `rest/v2/tokens` endpoint.

The API returns the following response:

{% code overflow="wrap" lineNumbers="true" %}

```json
{
    "payloadType": "text",
    "tokens": {
        "token": [
            {
                "authorization-code": "ACH789",
                "avs-address": "123 example",
                "avs-zip": "123456",
                "card-type": "VISA",
                "created": "09/19/2016 08:06:78",
                "description": "joint checking",
                "exp-date": "0919",
                "last-four-digits": "5678",
                "merchant-id": "text",
                "merchant-legacy-token-id": "text",
                "software-vendor-name": "text",
                "status": "Active",
                "times-used": "5",
                "token-id": "10009993322221111",
                "token-status": "Open",
                "updated": "09/19/2016 08:06:78",
                "avs-result-code": "X",
                "customer-first-name": "John",
                "customer-key": "customer123",
                "customer-last-name": "Doe",
                "default": false,
                "token-update-status": "UPDATED"
            }
        ]
    }
}
```

{% endcode %}

The API response includes the following fields:

<table><thead><tr><th width="160.33331298828125" valign="top">Name</th><th width="148.66668701171875" valign="top">Data type</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top"><code>payloadType</code></td><td valign="top">String</td><td valign="top">Indicates the format of the payload content.</td></tr><tr><td valign="top"><code>tokens</code></td><td valign="top">Object</td><td valign="top">Contains the card tokens associated with the merchant.</td></tr><tr><td valign="top"><code>tokens.token</code></td><td valign="top">Array</td><td valign="top">Contains token details across multiple fields.</td></tr><tr><td valign="top"><code>token.authorization-code</code></td><td valign="top">String</td><td valign="top">The code returned by the issuer to approve the transaction.</td></tr><tr><td valign="top"><code>token.avs-address</code></td><td valign="top">String</td><td valign="top">The address used for Address Verification System (AVS) validation.</td></tr><tr><td valign="top"><code>token.avs-zip</code></td><td valign="top">String</td><td valign="top">The ZIP code used for Address Verification System (AVS) validation.</td></tr><tr><td valign="top"><code>token.card-type</code></td><td valign="top">String</td><td valign="top">The type of card used. For examples, <code>VISA</code>, <code>MasterCard</code>.</td></tr><tr><td valign="top"><code>token.created</code></td><td valign="top">String</td><td valign="top">The date and time when the token were created.</td></tr><tr><td valign="top"><code>token.description</code></td><td valign="top">String</td><td valign="top">A description of the account or token.</td></tr><tr><td valign="top"><code>token.exp-date</code></td><td valign="top">String</td><td valign="top">The expiration date of the card in MMYY format.</td></tr><tr><td valign="top"><code>token.last-four-digits</code></td><td valign="top">String</td><td valign="top">The last four digits of the card number.</td></tr><tr><td valign="top"><code>token.merchant-id</code></td><td valign="top">String</td><td valign="top">The merchant identifier (MID) associated with the token.</td></tr><tr><td valign="top"><code>token.merchant-legacy-token-id</code></td><td valign="top">String</td><td valign="top">The legacy token ID used by the merchant.</td></tr><tr><td valign="top"><code>token.software-vendor-name</code></td><td valign="top">String</td><td valign="top">The name of the software vendor that initiated the token request.</td></tr><tr><td valign="top"><code>token.status</code></td><td valign="top">String</td><td valign="top">The current status of the token. For example, <code>Active</code>.</td></tr><tr><td valign="top"><code>token.times-used</code></td><td valign="top">String</td><td valign="top">The number of times the token has been used.</td></tr><tr><td valign="top"><code>token.token-id</code></td><td valign="top">String</td><td valign="top">The unique identifier for the token.</td></tr><tr><td valign="top"><code>token.token-status</code></td><td valign="top">String</td><td valign="top">The lifecycle status of the token. For example, Open.</td></tr><tr><td valign="top">token.updated</td><td valign="top">String</td><td valign="top">The date and time when the token were last updated.</td></tr><tr><td valign="top"><code>token.avs-result-code</code></td><td valign="top">String</td><td valign="top">The result code returned from the Address Verification System (AVS) check.</td></tr><tr><td valign="top"><code>token.customer-first-name</code></td><td valign="top">String</td><td valign="top">The first name of the customer associated with the token.</td></tr><tr><td valign="top"><code>token.customer-key</code></td><td valign="top">String</td><td valign="top">The unique identifier for the customer.</td></tr><tr><td valign="top"><code>token.customer-last-name</code></td><td valign="top">String</td><td valign="top">The last name of the customer associated with the token.</td></tr><tr><td valign="top"><code>token.default</code></td><td valign="top">Boolean</td><td valign="top">Indicates whether this token is the default for the customer.</td></tr><tr><td valign="top"><code>token.token-update-status</code></td><td valign="top">String</td><td valign="top">Indicates the result of the token update operation. For example, <code>UPDATED</code>.</td></tr></tbody></table>