{"uid":"cap_wg02Bniu0vi_sx7E3a-VF","slug":"agentmail-metrics-918c005f","name":"AgentMail Query Metrics","description":"Query Metrics","url":"https://mpp.api.agentmail.to/v0/metrics?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"end":{"type":"string","title":"End","format":"date-time","description":"End timestamp for the query."},"limit":{"type":"integer","title":"MetricLimit","description":"Limit on number of buckets to return."},"start":{"type":"string","title":"Start","format":"date-time","description":"Start timestamp for the query."},"period":{"type":"string","title":"Period","description":"Period in number of seconds for the query."},"descending":{"type":"boolean","title":"Descending","description":"Sort in descending order."},"event_types":{"type":"array","items":{"enum":["message.sent","message.delivered","message.bounced","message.delayed","message.rejected","message.complained","message.received"],"type":"string","title":"MetricEventType","description":"Type of metric event."},"title":"MetricEventTypes","description":"List of metric event types to query."}}},"responseSchema":{"type":"object","title":"QueryMetricsResponse","description":"Metrics grouped by event type.","additionalProperties":{"type":"array","items":{"type":"object","title":"MetricBucket","required":["timestamp","count"],"properties":{"count":{"type":"integer","description":"Count of events in the bucket."},"timestamp":{"type":"string","format":"date-time","description":"Timestamp of the bucket."}}}}},"example":null,"exampleRequest":null,"tags":["email","inboxes","domains","drafts","threads","webhooks","messaging","ai","social"],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"free","summary":"Free","primary":{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"free","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_hMZFeOJTfvaiigKXBHFE8","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"AgentMail","brandSlug":"agentmail","brandBaseUrl":"https://agentmail.to","brandDocsUrl":"https://docs.agentmail.to","whatItDoes":"Queries time-bucketed email event metrics (sent, delivered, bounced, delayed, rejected, complained, received) over a specified time range and period","exampleAgentPrompt":"Show me my AgentMail email metrics for the past 7 days broken down into daily buckets — I want to see counts for message.sent, message.delivered, and message.bounced events, sorted in ascending order, with up to 7 buckets.","exampleUseCases":null,"resultDescription":"Returns an object keyed by event type (e.g. 'message.sent', 'message.bounced'), each containing an array of time-bucketed objects with a timestamp and count of events in that bucket over the queried period.","failureModes":["Invalid date-time format for start/end returns 422 validation error","Invalid event_type enum value returns 422 validation error","Missing or invalid Authorization bearer token returns 401 unauthorized","Period value not a valid number of seconds returns 422","Limit exceeding server maximum returns 422 or clamped result","No data for the requested time range returns empty arrays per event type"],"whenToPreferThis":"Use this endpoint when you need aggregate, time-bucketed analytics on email event activity (sent, delivered, bounced, etc.) for AI agent inboxes managed by AgentMail. Prefer this over per-message retrieval when you need trend data, volume counts, or delivery performance monitoring across a time window rather than inspecting individual messages or threads.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:46:58.111Z","isFirstParty":false,"canonicalSlug":"agentmail-metrics-918c005f"}