WAwavix
API Keys

List API keys

Changed on

Returns the API keys belonging to the authenticated account.

get/v1/api-keys

Request

  • Base URL
    https://api.wavix.com
  • URL
    https://api.wavix.com/v1/api-keys
  • Auth
    HTTP bearer

Query parameters

labelstring

Filters API keys by label. Matches partial values.

Response

Returns the list of API keys.

idinteger required

API key ID.

labelstring required

API key label.

valuestring required

API key value.

activeboolean required

Indicates whether the API key is active.

restrictedboolean required

Indicates whether IP restrictions are enabled. When enabled, the API key works only from IP addresses in permitted_ips.

permitted_ipsstring[] required

List of permitted IP addresses. If restricted is false, an empty list means no IP restrictions. If restricted is true, an empty list prevents all requests.

scopes_enabledboolean required

When true, the key is restricted to the permissions defined in the scope fields below. When false, the key has full access.

last_used_atstring date-time nullable required

Timestamp of the most recent authenticated request made with this key.

created_atstring date-time required

Creation date and time in ISO 8601 format.

Example response

[
  {
    "id": 123,
    "label": "Production API Key",
    "value": "abc123def456ghi789jkl012mno345pqr678stu901vwx234yz",
    "active": true,
    "restricted": true,
    "permitted_ips": [
      "192.168.1.1",
      "10.0.0.1"
    ],
    "scopes_enabled": true,
    "last_used_at": "2026-04-20T15:42:11Z",
    "numbers": {
      "allow": "read"
    },
    "trunks": {
      "allow": "read"
    },
    "calls": {
      "allow": "read"
    },
    "messages": {
      "allow": "read"
    },
    "recordings": {
      "allow": "read"
    },
    "campaigns": {
      "allow": "read"
    },
    "two_fa": {
      "allow": "read"
    },
    "validator": {
      "allow": "read"
    },
    "webhooks": {
      "allow": "read"
    },
    "embeddable": {
      "allow": "read"
    },
    "billing": {
      "allow": "read"
    },
    "account": {
      "allow": "read"
    },
    "subaccounts": {
      "allow": "read"
    },
    "created_at": "2024-01-15T10:30:00Z"
  }
]

Changes

  • 76b9bb35619fRevision changes
    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • breaking

      removed the required property / from the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

  • d4adae930be5Revision changes
    • info

      added the non-success response with the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status