---
title: "Get voucher order details"
source_url: https://dev.digicert.com/certcentral-apis/services-api/vouchers/get-voucher-order-details.html
api_method: GET
api_endpoint: "/services/v2/voucher/{id}"
api_url: "https://www.digicert.com/services/v2/voucher/{id}"
---

**GET** `https://www.digicert.com/services/v2/voucher/{id}`

Use this endpoint to get voucher code details.

## Example requests and responses

## cURL

```bash
curl -g --request GET 'https://www.digicert.com/services/v2/voucher/{id}' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json'
```

## 200 OK

```json
{
    "id": {id},
    "name": "ACME CORP",
    "status": "completed",
    "cost": 37,
    "currency": "USD",
    "created_date": "2020-01-20 01:26:02",
    "expiration_date": "2021-01-20",
    "can_cancel": true,
    "codes": [
        {
            "id": 1001,
            "value": "B6TEM44GLJE2KASGWXDI5LER7LK6MYYG",
            "product": {
                "group_name": "dv_ssl_certificate",
                "name_id": "ssl_dv_geotrust_flex",
                "name": "GeoTrust DV SSL"
            },
            "no_of_fqdns": 1,
            "no_of_wildcards": 1,
            "validity_years": 1,
            "status": "active"
        },
        {
            "id": 1002,
            "value": "P2KLM44GLJE2KASGWXDI5LER7LK6MYYG",
            "product": {
                "group_name": "dv_ssl_certificate",
                "name_id": "ssl_dv_thawte",
                "name": "Thawte SSL123 DV"
            },
            "no_of_fqdns": 5,
            "no_of_wildcards": 1,
            "validity_years": 1,
            "status": "active"
        },
    ],
    "notes": "Example note",
    "page": {
        "total": 0,
        "limit": 0,
        "offset": 0
    }
}
```

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>int</td>
<td>Voucher order ID.</td>
</tr>
<tr>
<td>name</td>
<td>string</td>
<td>Organization name.</td>
</tr>
<tr>
<td>status</td>
<td>string</td>
<td>Status of Voucher order.<br>Possible values:active, used, canceled,</td>
</tr>
<tr>
<td>cost</td>
<td>int</td>
<td>Total cost of order.</td>
</tr>
<tr>
<td>currency</td>
<td>string</td>
<td>Currency unit for voucher order cost.</td>
</tr>
<tr>
<td>created_date</td>
<td>string</td>
<td>Date that voucher was created.<br>Format:
YYYY-MM-DD HH:MM:SS</td>
</tr>
<tr>
<td>expiration_date</td>
<td>string</td>
<td>Date that voucher expires.<br>Format:
YYYY-MM-DD</td>
</tr>
<tr>
<td>can_cancel</td>
<td>boolean</td>
<td>If order is eligible for cancelation.</td>
</tr>
<tr>
<td>codes</td>
<td>object</td>
<td>Container object. Each code is returned in a separate object.</td>
</tr>
<tr>
<td>..id</td>
<td>string</td>
<td>Voucher code ID</td>
</tr>
<tr>
<td>..value</td>
<td>string</td>
<td>Unique voucher code.</td>
</tr>
<tr>
<td>..product_name_id</td>
<td>string</td>
<td>Name ID of the product.</td>
</tr>
<tr>
<td>..no_of_fqdns</td>
<td>int</td>
<td>Number of FQDN SAN slots.<br>Range: 1-250. Note that the total number of SANs cannot exceed 250.</td>
</tr>
<tr>
<td>..no_of_wildcards</td>
<td>int</td>
<td>Number of Wildcard SAN slots.<br>Range: 1-250</td>
</tr>
<tr>
<td>..validity_years</td>
<td>int</td>
<td>Number of years the certificate order is valid.<br>*Can be replaced with validity_days.</td>
</tr>
<tr>
<td>..validity_days</td>
<td>int</td>
<td>Number of days the certificate order is valid.</td>
</tr>
<tr>
<td>notes</td>
<td>string</td>
<td>Displays order note.</td>
</tr>
<tr>
<td>used_from</td>
<td>string</td>
<td>Date and time code was used for a certificate request.</td>
</tr>
<tr>
<td>valid_till</td>
<td>string</td>
<td>Date and time that voucher expires.</td>
</tr>
</tbody>
</table>