Get orders by 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
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
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
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
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
{
  "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

Name Req/Opt Description
alternative_order_id required Alternative order ID to search for.

URL query strings

Name Req/Opt Type Description
offset optional integer Index of the first result to include in the response.
Default: 0
limit optional integer Total number of results to include in the response.
Max: 1000 (default)

Response parameters

Name Type Description
orders array List of objects with the order ID, certificate ID, and order status for orders that have the same alternative_order_id as the value provided in the request URL.
.. order_id integer Order ID.
.. certificate_id integer Certificate ID.
.. status string Order status.
Possible values: See Glossary – Order status
page object Object with pagination details.
See Structures – Page details object