Title: Add a Dedicated IP to a Reseller Windows Hosting Order Using the API  
PrimaryCategory: API  
Type: Procedural  
Tags: dedicated IP, reseller hosting, API, billing, request parameters  
Source UI Terms: auth-userid, api-key, order-id, invoice-option, discount-amount  
Source Reference: Add a Dedicated IP to a Reseller Windows Hosting Order Using the API  

---

### Procedural

Prerequisites:
- Have an existing Reseller Windows Hosting order.
- Obtain valid API authentication credentials (auth-userid and api-key).

Steps:
1) Use the HTTP POST method to send a request to the appropriate API endpoint based on your server location:
   - For the US server: `https://test.httpapi.com/api/resellerhosting/windows/us/add-dedicated-ip.json`
   - For the India server: `https://test.httpapi.com/api/resellerhosting/windows/in/add-dedicated-ip.json`
2) Include the following required parameters in the API request:
   - `auth-userid`: Your integer user ID for authentication.
   - `api-key`: Your API key string for authentication.
   - `order-id`: The integer ID of the Reseller Windows Hosting order to which you want to add the dedicated IP.
   - `invoice-option`: A string determining invoice handling. Possible values are:
     - `NoInvoice`
     - `PayInvoice`
     - `KeepInvoice`
     - `OnlyAdd`
3) Optionally, include the `discount-amount` parameter as a float to apply a discount on the order.
4) Submit the request.
5) Receive a response containing a map of execution details for the dedicated IP addition.

Warnings:
- Ensure the `invoice-option` parameter is correctly set to handle billing according to your requirements.
- The `discount-amount` is optional; if used, validate its amount and format.

Summary:
You can add a dedicated IP to an existing Reseller Windows Hosting order via the API by sending a POST request with required authentication and order details, specifying how invoices should be handled.

Evaluation Pairs:
Q: What HTTP method is used to add a dedicated IP to a Reseller Windows Hosting order using the API?  
A: The HTTP POST method is used.

Q: Which parameters are required to add a dedicated IP using this API?  
A: Required parameters are `auth-userid`, `api-key`, `order-id`, and `invoice-option`.

Q: How can billing be controlled when adding a dedicated IP?  
A: Billing is controlled using the `invoice-option` parameter, which can be set to `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 add a dedicated IP to an existing Reseller Windows Hosting order using the API. This article explains billing options and API request details for dedicated IP provisioning.</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 Windows Hosting Order.</p>
<h2><a name="heading_1"></a>Parameters</h2>
<table class="codetable"><tbody><tr><th colspan="1" rowspan="1">Name</th><th colspan="1" rowspan="1">Data Type</th><th colspan="1" rowspan="1">Required / Optional</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">auth-userid</td><td colspan="1" rowspan="1">Integer</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Authentication Parameter</td></tr><tr><td colspan="1" rowspan="1">api-key</td><td colspan="1" rowspan="1">String</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Authentication Parameter</td></tr><tr><td colspan="1" rowspan="1">order-id</td><td colspan="1" rowspan="1">Integer</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">The Order ID for which a dedicated IP to be added.</td></tr><tr><td colspan="1" rowspan="1">invoice-option</td><td colspan="1" rowspan="1">String</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">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><td colspan="1" rowspan="1">discount-amount</td><td colspan="1" rowspan="1">Float</td><td colspan="1" rowspan="1">Optional</td><td colspan="1" rowspan="1">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/windows/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 <br><br></code> <strong>India Server</strong> <code> https://test.httpapi.com/api/resellerhosting/windows/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>
<div class="seedetailssection"> </div>

When you want to add a dedicated IP to an existing Reseller Windows Hosting order using the API. This article explains billing options and API request details for dedicated IP provisioning.

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.