---
title: "List codes for voucher order"
source_url: https://dev.digicert.com/certcentral-apis/services-api/vouchers/list-codes-for-voucher-order.html
api_method: GET
api_endpoint: "/services/v2/voucher/{{voucher_order_id}}/download"
api_url: "https://www.digicert.com/services/v2/voucher/{{voucher_order_id}}/download"
---

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

Use this endpoint to get a list of voucher codes for a given voucher order ID.

To get the list in CSV format, set the `Accept` header in the request to `text/csv`.

## Example requests and responses

## cURL

```bash
curl -X GET \
  'https://www.digicert.com/services/v2/voucher/{{voucher_order_id}}/download' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
```

**200 OK**

```json
{
  "codes": [
    {
      "id": 49170,
      "value": "ZVB3LWIH3H3U53AOZU5QZ4W4TUTRPPCS",
      "product_name": "Basic OV",
      "no_of_fqdns": 5,
      "no_of_wildcards": 0,
      "shipping_method": "N/A",
      "validity_years": 3,
      "validity_days": 0,
      "status": "used",
      "created_date": "2022-03-03 13:31:03",
      "voucher_order_id": 25252,
      "cert_request_date": "2022-03-03 13:41:41",
      "cert_validity_start_date": " ",
      "cert_validity_end_date": " ",
      "cert_organization": "Example Inc.",
      "cert_common_name": "example.com",
      "certificate_order_id": "204928159",
      "voucher_validity_end_date": "2023-03-03",
      "order_valid_from": " ",
      "order_valid_till": " ",
      "server_licenses": "1"
    }
  ]
}
```

**200 OK (text/csv)**

```console
id,value,product_name,no_of_fqdns,no_of_wildcards,shipping_method,validity_years,validity_days,status,created_date,voucher_order_id,cert_request_date,cert_validity_start_date,cert_validity_end_date,cert_organization,cert_common_name,certificate_order_id,voucher_validity_end_date,order_valid_from,order_valid_till,server_licenses
49170,ZVB3EWIHDH3U63AOZU5QZ4W4TUTRPPCS,"Basic OV",5,0,N/A,3,0,used,"2022-03-03 13:31:03",25252,"2022-03-03 13:41:41"," "," ","Example Inc.",example.com,204928159,2023-03-03," "," ",1
49178,ZGGRW6GCJIWCR2XHAU4M6TNNBAURHLJM,"Basic OV",5,0,N/A,3,0,used,"2022-03-03 14:43:28",25256,"2022-03-04 10:48:47"," "," ","Example Inc.",example.com,204928160,2023-03-03," "," ",1
49179,4U6P5PVRG6HMOWYNGRD3HBM6QUSJRDH5,"Secure Site Pro EV SSL",2,0,N/A,3,0,used,"2022-03-03 14:43:28",25256,"2022-03-04 10:49:38"," "," ","Example Corp.",example.com,204928161,2023-03-03," "," ",1
```


## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>codes</td>
<td>array</td>
<td>List of voucher codes. Each voucher code object has the key/value pairs listed below.</td>
</tr>
<tr>
<td>.. id</td>
<td>integer</td>
<td>Voucher code ID.</td>
</tr>
<tr>
<td>.. value</td>
<td>string</td>
<td>Voucher code.</td>
</tr>
<tr>
<td>.. product_name</td>
<td>string</td>
<td>Product the voucher code is for.<br><strong>Possible values:</strong> See <a href="https://dev.digicert.com/md/certcentral-apis/services-api/glossary.md">Glossary – Product identifiers</a>.</td>
</tr>
<tr>
<td>.. no_of_fqdns</td>
<td>integer</td>
<td>Number of FQDNs the voucher allows.</td>
</tr>
<tr>
<td>.. no_of_wildcards</td>
<td>string</td>
<td>Number of wildcard domain names the voucher allows.</td>
</tr>
<tr>
<td>.. shipping_method</td>
<td>string</td>
<td>Voucher code shipping method.<br>Possible values: N/A, <code>STANDARD</code>, <code>EXPEDITED</code></td>
</tr>
<tr>
<td>.. validity_years</td>
<td>integer</td>
<td>Order validity in years. Returns 0 if the order validity for the voucher code is set using days instead of years.</td>
</tr>
<tr>
<td>.. validity_days</td>
<td>integer</td>
<td>Order validity in days. Returns 0 if the order validity for the voucher code is set using years instead of days.</td>
</tr>
<tr>
<td>.. status</td>
<td>string</td>
<td>Voucher code status.</td>
</tr>
<tr>
<td>.. created_date</td>
<td>string</td>
<td>Date and time the voucher code was created.<br><strong>Format:</strong> <code>YYYY-MM-DD hh:mm:ss</code></td>
</tr>
<tr>
<td>.. voucher_order_id</td>
<td>integer</td>
<td>ID of voucher order associated with the voucher code.</td>
</tr>
<tr>
<td>.. cert_request_date</td>
<td>string</td>
<td>Date and time the voucher code was used to request a certificate.<br><strong>Format:</strong> <code>YYYY-MM-DD hh:mm:ss</code></td>
</tr>
<tr>
<td>.. cert_validity_start_date</td>
<td>string</td>
<td>Certificate validity start date. Returns an empty string (<code>&quot; &quot;</code>) if the certificate has not been issued.</td>
</tr>
<tr>
<td>.. cert_validity_end_date</td>
<td>string</td>
<td>Certificate validity end date. Returns an empty string (<code>&quot; &quot;</code>) if the certificate has not been issued.</td>
</tr>
<tr>
<td>.. cert_organization</td>
<td>string</td>
<td>Name of the organization on the certificate request.</td>
</tr>
<tr>
<td>.. cert_common_name</td>
<td>string</td>
<td>Value of the common name on the certificate request.</td>
</tr>
<tr>
<td>.. certificate_order_id</td>
<td>string</td>
<td>Certificate order ID. Use this ID with the <a href="https://dev.digicert.com/md/certcentral-apis/services-api/orders/order-info.md">Order info</a> API to get more information about the certificate order.</td>
</tr>
<tr>
<td>.. voucher_validity_end_date</td>
<td>string</td>
<td>Voucher code expiration date.<br><strong>Format:</strong> <code>YYYY-MM-DD</code></td>
</tr>
<tr>
<td>.. order_valid_from</td>
<td>string</td>
<td>Order validity start date. Returns an empty string (<code>&quot; &quot;</code>) if the certificate has not been issued.</td>
</tr>
<tr>
<td>.. order_valid_till</td>
<td>string</td>
<td>Order validity end date. Returns an empty string (<code>&quot; &quot;</code>) if the certificate has not been issued.</td>
</tr>
<tr>
<td>.. server_licenses</td>
<td>integer</td>
<td>Number of server licenses included with the certificate.</td>
</tr>
</tbody>
</table>