# Get traffic usage of the package

<mark style="color:yellow;">`POST`</mark> `https://proxy-seller.com/personal/api/v1/{YourApiKey}/resident/traffic/details`

### **Example:**

```
https://proxy-seller.com/personal/api/v1/fj4948ffhg58gh843gh/resident/traffic/details
```

### Path parameter&#x73;**:**

<table data-full-width="false"><thead><tr><th width="153">Name</th><th width="186">Value</th><th>Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Authorization</td><td><code>&#x3C;Your_API_Key></code></td><td>Your personal API key</td><td></td></tr></tbody></table>

### **Request body:**

<table><thead><tr><th width="134">Name</th><th width="96">Type</th><th>Description</th></tr></thead><tbody><tr><td><strong>packageKey</strong></td><td>String</td><td>Package key (required)</td></tr><tr><td>login</td><td>String</td><td>Filter by List login</td></tr><tr><td>date_start</td><td>String</td><td>Filter by Date start (20.01.2026)</td></tr><tr><td>date_end</td><td>String</td><td>Filter by Date end (21.01.2026)</td></tr></tbody></table>

### **Response:**

{% tabs %}
{% tab title="200: OK Success response " %}

```json
{
    "status": "success",
    "data": {
        "1234567890abcdef": {
            "2025-12-02 14:00:00": 431879,
            "2025-12-02 15:00:00": 890159,
            "2025-12-02 16:00:00": 1650503,
            "2025-12-02 17:00:00": 2453952,
            "2025-12-02 18:00:00": 2326935,
            "2025-12-02 19:00:00": 1871175,
            "2025-12-02 20:00:00": 1949695,
            "2025-12-02 21:00:00": 234030,
            "2025-12-02 22:00:00": 212451,
            "2025-12-02 23:00:00": 2311198,
            "2025-12-03 00:00:00": 2132501,
            "2025-12-03 01:00:00": 2530564,
            "2026-01-22 03:00:00": 20947346,
            "2026-01-22 04:00:00": 20222530,
            "2026-01-22 05:00:00": 18709287,
            "2026-01-22 06:00:00": 18247463,
            "2026-01-22 07:00:00": 7678039,
            "2026-01-22 12:00:00": 41008,
            "2026-01-22 15:00:00": 710170,
            "2026-01-22 18:00:00": 5140074,
            "2026-01-22 21:00:00": 1016758
        }
    },
    "errors": []
}
```

{% endtab %}

{% tab title="200: OK Error response Wrong API key" %}

```json
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "Error api key",
            "code": 503,
            "customData": null
        },
        {
            "message": "IP not allowed",
            "code": 503,
            "customData": null
        },
        {
            "message": "Request limit reached",
            "code": 503,
            "customData": null
        }
    ]
}
```

{% endtab %}

{% tab title="200: OK Error response Wrong authorization IP" %}

```json
{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "IP not allowed",
            "code": 503,
            "customData": null
        }
    ]
}
```

{% endtab %}

{% tab title="200: OK Error response List not found" %}

```json
Same response in case with wrong rotation!

{
    "status": "error",
    "data": null,
    "errors": [
        {
            "message": "key is required",
            "code": 0,
            "customData": null
        },
        {
            "message": "not-found",
            "code": 404,
            "customData": null
        },
        {
            "message": "not-found (404)",
            "code": 0,
            "customData": null
        }
    ]
}
```

{% endtab %}
{% endtabs %}