> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve Usage

> Retrieve aggregated sending metrics, plan allowances, and active resource counts (Beta).

Inspect current monthly quota usage, delivery rates, active contact counts, and configured domain counts via the Mailofly API.

> **Beta Endpoint**: The usage schema is in active beta and subject to additive enhancements.

### Query Parameters

**days** `number` (default: 30)

Aggregation period window in days (1 to 90).

### Response

**data** `object`

**periodDays** `number`

Active aggregation window.

**emailsSent** `number`

Total emails sent in period.

**delivered** `number`

Total delivered / opened / clicked count.

**bounced** `number`

Total bounced count.

**activeContacts** `number`

Current contacts count.

**domains** `number`

Active domains count.

**limits** `object`

**emailsPerMonth** `number`

Monthly email allowance.

**domainsAllowed** `number`

Domain allowance.

**rateLimitPerSecond** `number`

Maximum API requests / sec.

```bash cURL theme={null}
curl -X GET "https://api.mailofly.com/usage?days=30" \
  -H "Authorization: Bearer mf_live_your_api_key"
```

```json 200 OK theme={null}
{
  "data": {
    "periodDays": 30,
    "emailsSent": 12850,
    "delivered": 12790,
    "bounced": 60,
    "activeContacts": 4500,
    "domains": 3,
    "limits": {
      "emailsPerMonth": 50000,
      "domainsAllowed": 10,
      "rateLimitPerSecond": 10
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.