---
title: "Get orders by alternative order ID"
source_url: https://dev.digicert.com/certcentral-apis/services-api/orders/get-orders-by-alternative-order-id.html
api_method: GET
api_endpoint: "/services/v2/order/alternate/{{alternative_order_id}}"
api_url: "https://www.digicert.com/services/v2/order/alternate/{{alternative_order_id}}"
---

**GET** `https://www.digicert.com/services/v2/order/alternate/{{alternative_order_id}}`

Use this endpoint to get a list of orders assigned the same `alternative_order_id`. Include the `alternative_order_id` value in the request URL.

For all matching orders the authenticated user has permission to view, the response includes:

- Order ID
- Certificate ID
- Order status

## Example requests and responses

**cURL**

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

**Python**

```python
import requests
import json

url = "https://www.digicert.com/services/v2/order/alternate/{{alternative_order_id}}"

payload={}
headers = {
  'X-DC-DEVKEY': {{api_key}},
  'Content-Type': 'application/json'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
```

**Go**

```go
package main

import (
		"fmt"
		"net/http"
		"io/ioutil"
)

func main() {

		url := "https://www.digicert.com/services/v2/order/alternate/{{alternative_order_id}}"
		method := "GET"

		client := &http.Client {
		}
		req, err := http.NewRequest(method, url, nil)

		if err != nil {
				fmt.Println(err)
				return
		}
		req.Header.Add("X-DC-DEVKEY", {{api_key}})
		req.Header.Add("Content-Type", "application/json")

		res, err := client.Do(req)
		if err != nil {
				fmt.Println(err)
				return
		}
		defer res.Body.Close()

		body, err := ioutil.ReadAll(res.Body)
		if err != nil {
				fmt.Println(err)
				return
		}
		fmt.Println(string(body))
}
```

**NodeJS**

```javascript
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://www.digicert.com/services/v2/order/alternate/{{alternative_order_id}}',
  'headers': {
    'X-DC-DEVKEY': {{api_key}},
    'Content-Type': 'application/json'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
```


## 200 OK

```json
{
  "orders": [
    {
      "order_id": 1234567,
      "certificate_id": 2345678,
      "status": "pending"
    },
    {
      "order_id": 1234568,
      "certificate_id": 2345679,
      "status": "pending"
    }
  ],
  "page": {
    "total": 2,
    "limit": 1000,
    "offset": 0
  }
}
```

## Path parameters

<table>
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>alternative_order_id</td>
<td>required</td>
<td>Alternative order ID to search for.</td>
</tr>
</tbody>
</table>

## URL query strings

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>offset</td>
<td>optional</td>
<td>integer</td>
<td>Index of the first result to include in the response.<br>Default:
 0</td>
</tr>
<tr>
<td>limit</td>
<td>optional</td>
<td>integer</td>
<td>Total number of results to include in the response.<br>Max: 1000 (default)</td>
</tr>
</tbody>
</table>

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>orders</td>
<td>array</td>
<td>List of objects with the order ID, certificate ID, and order status for orders that have the same <code>alternative_order_id</code> as the value provided in the request URL.</td>
</tr>
<tr>
<td>.. order_id</td>
<td>integer</td>
<td>Order ID.</td>
</tr>
<tr>
<td>.. certificate_id</td>
<td>integer</td>
<td>Certificate ID.</td>
</tr>
<tr>
<td>.. status</td>
<td>string</td>
<td>Order status.<br>Possible values: See Glossary – Order status</td>
</tr>
<tr>
<td>page</td>
<td>object</td>
<td>Object with pagination details.<br>See Structures – Page details object</td>
</tr>
</tbody>
</table>