Move orders

2 minute read

POST https://www.digicert.com/services/v2/account/move-orders/{{target_account_id}}

Use this endpoint to move certificate orders from a parent account to a direct subaccount.

The move operation is asynchronous - orders are added to a queue and processed in the background. After the order moves from the parent account to a direct subaccount, the operation cannot be reversed.
You can include up to 1,000 orders in a request. Orders must belong to the source account and be in issued or pending status. Orders in reissue_pending status, Direct/HISP product orders, and subscription orders cannot be moved. If the orders have an associated organization, include target_org_id in the API request. When move_custom_fields is true, the API validates that the source and target accounts have compatible custom field types before adding the request to the move queue.

Example requests and responses

curl -X POST \
  https://www.digicert.com/services/v2/account/move-orders/1760235 \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "target_org_id": 2148565,
    "order_ids": "1371862516,1371862517,1371862518",
    "move_custom_fields": true
}'

import requests

url = "https://www.digicert.com/services/v2/account/move-orders/1760235"

payload = "{\n  \"target_org_id\": 2148565,\n  \"order_ids\": \"1371862516,1371862517,1371862518\",\n  \"move_custom_fields\": true\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

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

print(response.text)

package main

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

func main() {

    url := "https://www.digicert.com/services/v2/account/move-orders/1760235"
    
    payload := strings.NewReader("{\n  \"target_org_id\": 2148565,\n  \"order_ids\": \"1371862516,1371862517,1371862518\",\n  \"move_custom_fields\": true\n}")

    req, _ := http.NewRequest("POST", url, payload)

    req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
    req.Header.Add("Content-Type", "application/json")

    res, _ := http.DefaultClient.Do(req)

    defer res.Body.Close()
    body, _ := ioutil.ReadAll(res.Body)

    fmt.Println(res)
    fmt.Println(string(body))

}

var request = require("request");

var options = { method: 'POST',
  url: 'https://www.digicert.com/services/v2/account/move-orders/1760235',
  headers: {
    'Content-Type': 'application/json',
    'X-DC-DEVKEY': '{{api_key}}'
  },
  body: {
    target_org_id: 2148565,
    order_ids: '1371862516,1371862517,1371862518',
    move_custom_fields: true
  },
  json: true
};

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});

201 Created

{
  "move_request_id": 12345
}

URL query parameters

Name	Req/Opt	Type	Description
target_account_id	required	integer	ID of the target account where the orders will be moved. The target account must be a direct subaccount of the parent or source account.

Request parameters

Name	Req/Opt	Type	Description
target_org_id	optional	integer	ID of the target organization in the target subaccount where the orders will be moved. Required when the orders being moved are associated with an organization.
order_ids	required	string	Comma-separated list of order IDs to move (for example, 1371862518). A maximum of 1000 orders are allowed per request.
move_custom_fields	optional	boolean	Specify whether to move custom fields associated with the orders. Default: `true`