Global IPs

Global IP Assignment Usage Metrics

Changed on

Retrieve usage metrics for your Global IP assignments.

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

Query parameters

Consolidated filter parameter (deepObject style). Originally: filter[global_ip_assignment_id][in], filter[global_ip_id][in]

Response

Successful response

Example response

{
  "data": [
    {
      "timestamp": "2020-01-01T00:00:00.000Z",
      "global_ip": {
        "id": "a836125b-20b6-452e-9c03-2653f09c7ed7",
        "ip_address": "64.1.4.130"
      },
      "global_ip_assignment": {
        "id": "a836125b-20b6-452e-9c03-2653f09c7ed7",
        "wireguard_peer_id": "e66c496d-4a85-423b-8b2a-8e63fac20320",
        "wireguard_peer": {
          "name": "Wireguard Peer 1",
          "ip_address": "172.1.0.1"
        }
      },
      "transmitted": {
        "amount": 100000,
        "unit": "B"
      },
      "received": {
        "amount": 100000,
        "unit": "B"
      }
    }
  ]
}

Changes

  • 19db5ee4ec59Revision changes
    • breaking

      the // response's property type changed from integer to string, and format from int32 to no format for status

    • breaking

      the // response's property type changed from integer to string, and format from int32 to no format for status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • a6a61a29ecddRevision changes
    • breaking

      the // response's property type changed from string to integer, and format from no format to int32 for status

    • breaking

      the // response's property type changed from string to integer, and format from no format to int32 for status