---
title: "Global IP Assignment Usage Metrics"
method: GET
path: "/global_ip_assignments/usage"
tags: ["Global IPs"]
---

# Global IP Assignment Usage Metrics

`GET /global_ip_assignments/usage`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/global_ip_assignments/usage`
- Auth: HTTP bearer

Retrieve usage metrics for your Global IP assignments.

## Query parameters

- `filter` object
  - `global_ip_assignment_id` union
    - string: Filter by exact Global IP Assignment ID
    - object: Filtering operations
      - `in` string: Filter by Global IP Assignment ID(s) separated by commas
  - `global_ip_id` union
    - string: Filter by exact Global IP ID
    - object: Filtering operations
      - `in` string: Filter by Global IP ID(s) separated by commas

## Response `200`

Successful response

- object
  - `data` GlobalIpAssignmentUsageMetric[]
    - `timestamp` string, date-time: The timestamp of the metric.
    - `global_ip` object
      - `id` string, uuid: Global IP ID.
      - `ip_address` string: The Global IP address.
    - `global_ip_assignment` object
      - `id` string, uuid: Global IP assignment ID.
      - `wireguard_peer_id` string, uuid: Wireguard peer ID.
      - `wireguard_peer` object
        - `name` string: A user specified name for the interface.
        - `ip_address` string: The IP address of the interface.
    - `transmitted` object
      - `amount` number: The amount of data transmitted.
      - `unit` string: The unit of the amount of data transmitted.
    - `received` object
      - `amount` number: The amount of data received.
      - `unit` string: The unit of the amount of data received.

## Other responses

- `422`: Unexpected error
- `default`: Unexpected error

## Changes

- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/global_ip_assignments/usage/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)