Query Metrics

curl --request GET \
  --url https://api.aisa.one/apis/v1/agentmail/metrics \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/agentmail/metrics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/agentmail/metrics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/agentmail/metrics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/agentmail/metrics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{}

GET

https://api.aisa.one

apis

agentmail

metrics

Query Metrics

curl --request GET \
  --url https://api.aisa.one/apis/v1/agentmail/metrics \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/agentmail/metrics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/agentmail/metrics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/agentmail/metrics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/agentmail/metrics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{}

Returns aggregate counters for the whole account as a flat map of counter name to an array of data points. Measured live on 2026-08-24 the keys are message.received, message.received.spam, message.received.blocked, message.received.unauthenticated, message.sent, message.delivered, message.bounced, message.complained, message.rejected, message.opened and domain.verified, each an empty array on an account with no traffic — an empty array means no activity, not an error. The shape is not pinned in this spec, so read the keys actually returned rather than assuming this list is closed. This is the organization-wide view spanning every inbox in the account. Every AIsa caller shares one AgentMail account, so this reaches inboxes other callers created; the inbox-scoped twin get_agentmail_inbox_metrics is the one to use when a single inbox is meant.

Example

curl -X GET "https://api.aisa.one/apis/v1/agentmail/metrics" \
  -H "Authorization: Bearer YOUR_API_KEY"

// Copy this whole block into Claude Code, Codex, Cursor or any coding agent.
// It carries everything needed to connect, authorize and run this example —
// no key to paste, one click of Allow in the browser.
{
  "calls": [
    {
      "call_id": "1",
      "tool": "get_agentmail_metrics",
      "arguments": {}
    }
  ]
}
// ── for the agent ─────────────────────────────────────────────────────────
// Register the AIsa MCP server, then call its `batch_quote` tool with the JSON above.
//   name       aisa
//   endpoint   https://mcp.aisa.one/mcp
//   transport  streamable-http
//   auth       OAuth. The server publishes RFC 9728 metadata, so open a
//              browser and the user clicks Allow once — nothing to paste.
//              If AISA_API_KEY is set, send it as a bearer header instead.
// Use your own MCP mechanism, not a hand-edited config file:
//   Codex        codex mcp add aisa --url https://mcp.aisa.one/mcp
//   Claude Code  claude mcp add --transport http -s user aisa https://mcp.aisa.one/mcp
//   Cursor / VS Code   a "url" entry for https://mcp.aisa.one/mcp in the MCP config
// The server reaches https://mcp.aisa.one/servers worth of APIs through a few meta
// tools: search, list_categories, get_details, batch_quote, batch_use.
// search, get_details and batch_quote are free; batch_use is billed per
// call. This operation's full contract — every argument, the response
// shape, the price and the pitfalls — is at
//   https://aisa.one/docs/api-reference/agentmail/get_agentmail-metrics.md
// Show me the quoted cost. Once I approve, run the same calls with
// batch_use and show me the result.

First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.

Set this endpoint up in your agent →

Request contract

Method and path: GET /apis/v1/agentmail/metrics
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/agentmail/metrics
descending: query; optional
end: query; optional
event_types: query; optional
limit: query; optional
period: query; optional
start: query; optional
Runtime facts: 18a04e28941fae19674c11246b677373368b6bd927b7c146220cec1f168f4639

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "get_agentmail_metrics",
  "method": "GET",
  "path": "/apis/v1/agentmail/metrics",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "in": "query",
      "name": "descending",
      "required": false,
      "schema": {
        "description": "Sort in descending order.",
        "title": "Descending",
        "type": "boolean"
      }
    },
    {
      "in": "query",
      "name": "end",
      "required": false,
      "schema": {
        "description": "End timestamp for the query.",
        "format": "date-time",
        "title": "End",
        "type": "string"
      }
    },
    {
      "in": "query",
      "name": "event_types",
      "required": false,
      "schema": {
        "description": "List of metric event types to query.",
        "items": {
          "description": "Type of metric event.",
          "enum": [
            "message.sent",
            "message.delivered",
            "message.bounced",
            "message.delayed",
            "message.rejected",
            "message.complained",
            "message.received"
          ],
          "title": "MetricEventType",
          "type": "string"
        },
        "title": "MetricEventTypes",
        "type": "array"
      }
    },
    {
      "in": "query",
      "name": "limit",
      "required": false,
      "schema": {
        "description": "Limit on number of buckets to return.",
        "title": "MetricLimit",
        "type": "integer"
      }
    },
    {
      "in": "query",
      "name": "period",
      "required": false,
      "schema": {
        "description": "Period in number of seconds for the query.",
        "title": "Period",
        "type": "string"
      }
    },
    {
      "in": "query",
      "name": "start",
      "required": false,
      "schema": {
        "description": "Start timestamp for the query.",
        "format": "date-time",
        "title": "Start",
        "type": "string"
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "explicit_zero",
    "customer_pricing": "fixed_success",
    "default_request_estimate_usd": 0.012,
    "estimate_source": "profile_seed",
    "evidence_source": "request_snapshot"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Published reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Default request reference estimate (USD): 0.012
Cost contract: explicit_zero
Settlement evidence source: request_snapshot

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

descending

boolean

Sort in descending order.

end

string<date-time>

End timestamp for the query.

event_types

enum<string>[]

List of metric event types to query.

Type of metric event.

Available options:

message.sent,

message.delivered,

message.bounced,

message.delayed,

message.rejected,

message.complained,

message.received

limit

integer

Limit on number of buckets to return.

period

string

Period in number of seconds for the query.

start

string<date-time>

Start timestamp for the query.

Response

Response with status 200

Metrics grouped by event type.

{key}

MetricBucket · object[]

Show child attributes

Overview

Models

Search & Research

Finance & Crypto

Social & Media

SEO & Web Intel

Sales & Email

Travel & Other

Query Metrics

Example

Request contract

Cost and request rules

Authorizations

Query Parameters

Response

​Example

​Request contract

​Cost and request rules

Authorizations

Query Parameters

Response

Example

Request contract

Cost and request rules