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

# Global IP Usage Metrics

`GET /global_ip_usage`

## 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[]
    - `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.
    - `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

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)