---
title: "Move orders"
source_url: https://dev.digicert.com/certcentral-apis/services-api/account/move-order.html
api_method: POST
api_endpoint: "/services/v2/account/move-orders/<target_account_id>"
api_url: "https://www.digicert.com/services/v2/account/move-orders/{{target_account_id}}"
---

**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.


> **Info**
>
> 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. <br>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**

```bash
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
}'
```

**Python**

```python
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)
```

**Go**

```go
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))

}
```

**NodeJS**

```javascript
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

```json
{
  "move_request_id": 12345
}
```

## URL query parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>target_account_id</td>
<td>required</td>
<td>integer</td>
<td>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.</td>
</tr>
</tbody>
</table>

## Request parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>target_org_id</td>
<td>optional</td>
<td>integer</td>
<td>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.</td>
</tr>
<tr>
<td>order_ids</td>
<td>required</td>
<td>string</td>
<td>Comma-separated list of order IDs to move (for example, 1371862518). A maximum of 1000 orders are allowed per request.</td>
</tr>
<tr>
<td>move_custom_fields</td>
<td>optional</td>
<td>boolean</td>
<td>Specify whether to move custom fields associated with the orders.<br> Default: <code>true</code></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>move_request_id</td>
<td>integer</td>
<td>ID for the order move request. Use this ID to track the status of the move operation.</td>
</tr>
</tbody>
</table>