> For the complete documentation index, see [llms.txt](https://docs.giga.store/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giga.store/webhooks/custom-data-consumption.md).

# Custom Data Consumption

Gigastore is sending this webhook as a POST request whenever a customer's data consumption reaches one of your configured consumption thresholds. Each threshold is a **percentage of the original package allowance consumed** (for example 60%, 80%, or 100% = package fully used up). You can configure up to three thresholds, and each one is triggered once per package. The *configuredThresholdPercentage* field tells you which threshold was crossed.

{% hint style="info" %}
Please add your server URL on [Gigastore](https://dent.giga.store/#/api). \
Only **HTTPS** server URLs are allowed. 
{% endhint %}

### Request Parameters <a href="#response-parameters" id="response-parameters"></a>

<table data-header-hidden><thead><tr><th width="268.1263020833333">Attribute</th><th width="133.9765625">Type</th><th>Example</th></tr></thead><tbody><tr><td>Attribute</td><td>Type</td><td>Info</td></tr><tr><td>uid</td><td>string</td><td>058c8716-47dd-4fc4-be89-00978a86b7c0</td></tr><tr><td>iccid</td><td>string</td><td>89361123300836129514</td></tr><tr><td>imsi</td><td>string</td><td>260216611193634</td></tr><tr><td>timestamp</td><td>dateTime</td><td>2022-08-21T10:15:30Z</td></tr><tr><td>configuredThresholdPercentage</td><td>number</td><td>80 (percentage consumed that was crossed; decimals like 12.5 are possible) </td></tr><tr><td>balanceAmountInByte</td><td>long</td><td>93618231</td></tr><tr><td>originalBalanceAmountInByte</td><td>long</td><td>1073741824</td></tr><tr><td>activatedItemId</td><td>string</td><td>a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d</td></tr></tbody></table>

#### Sample request <a href="#sample-response" id="sample-response"></a>

```
{                                                                                                                                                                                                                                                                                                                         
    "uid": "058c8716-47dd-4fc4-be89-00978a86b7c0",                                                                                                                                                                                                                                                                          
    "iccid": "89361123300836129514",                                                                                                                                                                                                                                                                                        
    "imsi": "260216611193634",                                                                                                                                                                                                                                                                                              
    "timestamp": "2022-08-21T10:15:30Z",                                                                                                                                                                                                                                                                                    
    "balanceAmountInByte": 214748365,                                                                                                                                                                                                                                                                                       
    "configuredThresholdPercentage": 80,                                                                                                                                                                                                                                                                                    
    "activatedItemId": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",                                                                                                                                                                                                                                                              
    "originalBalanceAmountInByte": 1073741824                                                                                                                                                                                                                                                                               
  }    
```