Title: Add a Reseller Linux Hosting Order Using the API
PrimaryCategory: API
Type: Procedural
Tags: reseller hosting, linux hosting, api, dedicated ip, order creation, billing
Source UI Terms: auth-userid, api-key, order-id, invoice-option, discount-amount
Source Reference: Add a Reseller Linux Hosting Order Using the API

Prerequisites:
- Have valid API credentials: auth-userid and api-key.
- Know the Order ID of the existing Reseller Linux Hosting order to which you want to add a dedicated IP.
- Decide on the invoice handling method for the operation.

Steps:
1) Use the HTTP POST method.
2) Construct the API request URL for your server region:
   - US Server: `https://test.httpapi.com/api/resellerhosting/linux/us/add-dedicated-ip.json`
   - India Server: `https://test.httpapi.com/api/resellerhosting/linux/in/add-dedicated-ip.json`
3) Include the following required parameters in the query string or POST data:
   - `auth-userid`: Your integer user ID for authentication.
   - `api-key`: Your string API key for authentication.
   - `order-id`: Integer Order ID specifying the reseller hosting order.
   - `invoice-option`: String controlling invoice handling; allowed values:
     - `NoInvoice`
     - `PayInvoice`
     - `KeepInvoice`
     - `OnlyAdd`
4) Optionally include the `discount-amount` parameter (float) to apply a discount to the order.
5) Submit the POST request to add a dedicated IP to the specified order.
6) Receive a response map detailing the execution status of the add dedicated IP operation.

Warnings:
- Ensure the `invoice-option` parameter uses one of the allowed values to avoid errors.
- Use correct server endpoint matching your region (US or India).
- The `order-id` must correspond to an existing reseller Linux hosting order.

Summary:
To add a dedicated IP to an existing Reseller Linux Hosting order via the API, send a POST request including your authentication parameters, the order ID, invoice handling option, and optional discount amount to the correct regional endpoint.

Evaluation Pairs:
Q: What parameters are required to add a dedicated IP via the API for a reseller Linux hosting order?
A: Required parameters are auth-userid, api-key, order-id, and invoice-option.

Q: What HTTP method is used to add a dedicated IP via the API?
A: The HTTP POST method is used.

Q: What is the purpose of the invoice-option parameter when adding a dedicated IP through the API?
A: It controls how customer invoices are handled, with possible values NoInvoice, PayInvoice, KeepInvoice, or OnlyAdd.

<div class="region region-content">
<div class="block block-core block-page-title-block" id="block-twostates-page-title">
<div class="content">
<div id="toc" style="display: block;">
<div id="toc_content">
<p>When you want to place a Reseller Linux Hosting order using the API. This article explains hosting plan parameters, billing settings, dedicated IP options, and API request details for order creation.</p>
<p> </p>
<p> </p>
</div>
</div>
</div>
</div>
<div class="node__content clearfix">
<div class="layout layout--onecol">
<div class="layout__region layout__region--content">
<div class="clearfix text-formatted field field--name-body field--type-text-with-summary field--label-hidden field__item">
<h2><a name="heading_0"></a>Description</h2>
<p>Adds a dedicated IP for an existing Reseller Linux Hosting Order.</p>
<h2><a name="heading_1"></a>Parameters</h2>
<table class="codetable" style="width: 100%;height: 269.125px;"><tbody><tr style="height: 55.25px;"><th colspan="1" rowspan="1" style="width: 11.1469%;">Name</th><th colspan="1" rowspan="1" style="width: 7.44201%;">Data Type</th><th colspan="1" rowspan="1" style="width: 12.8443%;">Required / Optional</th><th colspan="1" rowspan="1" style="width: 60.5127%;">Description</th></tr><tr style="height: 34.4583px;"><td colspan="1" rowspan="1" style="width: 11.1469%;">auth-userid</td><td colspan="1" rowspan="1" style="width: 7.44201%;">Integer</td><td colspan="1" rowspan="1" style="width: 12.8443%;">Required</td><td colspan="1" rowspan="1" style="width: 60.5127%;">Authentication Parameter</td></tr><tr style="height: 34.4583px;"><td colspan="1" rowspan="1" style="width: 11.1469%;">api-key</td><td colspan="1" rowspan="1" style="width: 7.44201%;">String</td><td colspan="1" rowspan="1" style="width: 12.8443%;">Required</td><td colspan="1" rowspan="1" style="width: 60.5127%;">Authentication Parameter</td></tr><tr style="height: 34.4583px;"><td colspan="1" rowspan="1" style="width: 11.1469%;">order-id</td><td colspan="1" rowspan="1" style="width: 7.44201%;">Integer</td><td colspan="1" rowspan="1" style="width: 12.8443%;">Required</td><td colspan="1" rowspan="1" style="width: 60.5127%;">The Order ID for which a dedicated IP to be added.</td></tr><tr style="height: 55.25px;"><td colspan="1" rowspan="1" style="width: 11.1469%;">invoice-option</td><td colspan="1" rowspan="1" style="width: 7.44201%;">String</td><td colspan="1" rowspan="1" style="width: 12.8443%;">Required</td><td colspan="1" rowspan="1" style="width: 60.5127%;">This parameter will decide how the Customer Invoices will be handled. Values can be: <em>NoInvoice</em>, <em>PayInvoice</em>, <em>KeepInvoice</em>, <em>OnlyAdd</em></td></tr><tr style="height: 55.25px;"><td colspan="1" rowspan="1" style="width: 11.1469%;">discount-amount</td><td colspan="1" rowspan="1" style="width: 7.44201%;">Float</td><td colspan="1" rowspan="1" style="width: 12.8443%;">Optional</td><td colspan="1" rowspan="1" style="width: 60.5127%;">Discount amount for the order value.</td></tr></tbody></table>
<h2><a name="heading_2"></a>HTTP Method</h2>
<p>POST</p>
<h2><a name="heading_3"></a>Example Test URL Request</h2>
<p><strong>US Server</strong> <code> https://test.httpapi.com/api/resellerhosting/linux/us/add-dedicated-ip.json?auth-userid=0&amp;api-key=key&amp;order-id=0&amp;invoice-option=NoInvoice&amp;discount-amount=0.00 </code> <strong>India Server</strong> <code> https://test.httpapi.com/api/resellerhosting/linux/in/add-dedicated-ip.json?auth-userid=0&amp;api-key=key&amp;order-id=0&amp;invoice-option=NoInvoice&amp;discount-amount=0.00 </code></p>
<h2><a name="heading_4"></a>Response</h2>
<p>Returns a map of the execution details of the adding dedicated IP operation.</p>
</div>
</div>
</div>
</div>
</div>

When you want to place a Reseller Linux Hosting order using the API. This article explains hosting plan parameters, billing settings, dedicated IP options, and API request details for order creation.

Name	Data Type	Required / Optional	Description
auth-userid	Integer	Required	Authentication Parameter
api-key	String	Required	Authentication Parameter
order-id	Integer	Required	The Order ID for which a dedicated IP to be added.
invoice-option	String	Required	This parameter will decide how the Customer Invoices will be handled. Values can be: NoInvoice, PayInvoice, KeepInvoice, OnlyAdd
discount-amount	Float	Optional	Discount amount for the order value.