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

# Global IP Usage Metrics

`GET /global_ip_usage`

Retrieve usage metrics for your Global IPs.

## Query parameters

- `filter` object
  - `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` GlobalIpUsageMetric[]
    - `global_ip` object
      - `id` string, uuid — Global IP ID.
      - `ip_address` string — The Global IP address.
    - `received` object
      - `amount` number — The amount of data received.
      - `unit` string — The unit of the amount of data received.
    - `timestamp` string, date-time — The timestamp of the metric.
    - `transmitted` object
      - `amount` number — The amount of data transmitted.
      - `unit` string — The unit of the amount of data transmitted.

## Other responses

- `422` — Unexpected error
- `default` — Unexpected error

## Changes

- **2026-08-17** `1571b0380bd7` — 2 breaking
  - the `errors/items/code` response's property type/format changed from `integer`/`int32` to `string`/`` for status `422`
  - the `errors/items/code` response's property type/format changed from `integer`/`int32` to `string`/`` for status `default`
- **2026-08-04** `8f5f4e537994` — 2 breaking
  - the `errors/items/code` response's property type/format changed from `string`/`` to `integer`/`int32` for status `422`
  - the `errors/items/code` response's property type/format changed from `string`/`` to `integer`/`int32` for status `default`

[Change history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/global_ip_usage/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/3fdc16374d70/schema)