{
  "opencollection": "1.0.0",
  "info": {
    "name": "API Reference agent-webhooks usage API",
    "version": "1.0.0"
  },
  "items": [
    {
      "info": {
        "name": "usage",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get Usage",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.agentphone.ai/v1/usage",
            "headers": [
              {
                "name": "Authorization",
                "value": ""
              }
            ]
          },
          "docs": "Get usage statistics for the current account.\n\nReturns:\n- Phone number limits (used/limit/remaining)\n- Message statistics (total, last 24h, last 7 days, last 30 days)\n- Call statistics (total, last 24h, last 7 days, last 30 days)\n- Webhook delivery statistics"
        },
        {
          "info": {
            "name": "Get Daily Usage",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.agentphone.ai/v1/usage/daily",
            "headers": [
              {
                "name": "Authorization",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "days",
                "value": "",
                "type": "query"
              }
            ]
          },
          "docs": "Get daily usage breakdown for the last N days (up to 365).\nReturns per-day counts of messages, calls, and webhook deliveries."
        },
        {
          "info": {
            "name": "Get Monthly Usage",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.agentphone.ai/v1/usage/monthly",
            "headers": [
              {
                "name": "Authorization",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "months",
                "value": "",
                "type": "query"
              }
            ]
          },
          "docs": "Get monthly usage aggregation for the last N months.\nReturns per-month totals of messages, calls, and webhook deliveries."
        },
        {
          "info": {
            "name": "Get Usage By Number",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.agentphone.ai/v1/usage/by-number",
            "headers": [
              {
                "name": "Authorization",
                "value": ""
              }
            ]
          },
          "docs": "Get usage statistics broken down by phone number, with linked agent info."
        },
        {
          "info": {
            "name": "Get Usage By Agent",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.agentphone.ai/v1/usage/by-agent",
            "headers": [
              {
                "name": "Authorization",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "period",
                "value": "",
                "type": "query"
              },
              {
                "name": "tz",
                "value": "",
                "type": "query",
                "description": "IANA timezone, e.g. America/New_York"
              }
            ]
          },
          "docs": "Get usage broken down by agent for the current calendar week, month, or year.\nIncludes message count, completed call count, and total call seconds per agent.\nCalls/messages with no agent attached are bucketed as \"Unassigned\"."
        }
      ]
    }
  ],
  "bundled": true
}