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

# Retrieve Usage

> Retrieve your account usage and plan limits.

## Response Fields

**object** `string`

Always `usage`.

**emails** `object`

Email sending and receiving quota, broken down by day and month.

**properties**

**daily** `object`

Rolling 24-hour quota. Shaped as `{ used, limit, sent, received,
            resets_at }`. `limit` is `null` once the team has an active sending
subscription — daily caps only apply to the free tier.

**monthly** `object`

Calendar-month quota, shaped the same as `daily`. `limit` is always a
number that scales with the plan.

**contacts** `object`

Shaped as `{ used, limit }`.

**segments** `object`

Shaped as `{ used, limit }`. `limit` is `null` once the team has an active
contacts subscription — segment caps only apply to the free tier.

**broadcasts** `object`

Shaped as `{ used, limit }`. `limit` is always `null` — broadcasts have no
cap.

**ai\_credits** `object`

Shaped as `{ used, limit, next_increase_at }`. `next_increase_at` is `null`
until the team's first AI credit use in the current rolling window; once
credits are used, it's when the oldest usage ages out and frees up quota.

**automation\_runs** `object`

Shaped as `{ used, limit, resets_at }`.

**domains** `object`

Shaped as `{ used, limit }`. `limit` is `null` when the plan has no domain
cap.

**rate\_limit** `object`

The team's API rate limit, shaped as `{ limit, duration }`. `duration` is a
string like `"1000ms"`.

```ts Node.js theme={"theme":{"light":"github-light","dark":"vesper"}}
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.usage.get();
```

```php PHP theme={"theme":{"light":"github-light","dark":"vesper"}}
$resend = Resend::client('re_xxxxxxxxx');

$resend->usage->get();
```

```python Python theme={"theme":{"light":"github-light","dark":"vesper"}}
import resend

resend.api_key = "re_xxxxxxxxx"

resend.Usage.get()
```

```ruby Ruby theme={"theme":{"light":"github-light","dark":"vesper"}}
require "resend"

Resend.api_key = "re_xxxxxxxxx"

usage = Resend::Usage.get
puts usage
```

```go Go theme={"theme":{"light":"github-light","dark":"vesper"}}
package main

import "github.com/resend/resend-go/v4"

func main() {
	client := resend.NewClient("re_xxxxxxxxx")

	client.Usage.Get()
}
```

```rust Rust theme={"theme":{"light":"github-light","dark":"vesper"}}
use resend_rs::{Resend, Result};

#[tokio::main]
async fn main() -> Result<()> {
  let resend = Resend::new("re_xxxxxxxxx");

  let _usage = resend.usage.get().await?;

  Ok(())
}
```

```java Java theme={"theme":{"light":"github-light","dark":"vesper"}}
import com.resend.Resend;
import com.resend.core.exception.ResendException;
import com.resend.services.usage.model.UsageResponse;

public class Main {
    public static void main(String[] args) throws ResendException {
        Resend resend = new Resend("re_xxxxxxxxx");

        UsageResponse usage = resend.usage().get();
    }
}
```

```csharp .NET theme={"theme":{"light":"github-light","dark":"vesper"}}
using Resend;

IResend resend = ResendClient.Create( "re_xxxxxxxxx" ); // Or from DI

var resp = await resend.UsageAsync();
Console.WriteLine( "Contacts used={0}", resp.Content.Contacts.Used );
```

```bash cURL theme={"theme":{"light":"github-light","dark":"vesper"}}
curl -X GET 'https://api.resend.com/usage' \
     -H 'Authorization: Bearer re_xxxxxxxxx'
```

```bash CLI theme={"theme":{"light":"github-light","dark":"vesper"}}
resend usage
```

```json Response theme={"theme":{"light":"github-light","dark":"vesper"}}
{
  "object": "usage",
  "emails": {
    "daily": {
      "used": 10,
      "limit": 100,
      "sent": 8,
      "received": 2,
      "resets_at": "2026-07-29T00:00:00.000Z"
    },
    "monthly": {
      "used": 100,
      "limit": 3000,
      "sent": 80,
      "received": 20,
      "resets_at": "2026-08-01T00:00:00.000Z"
    }
  },
  "contacts": {
    "used": 10,
    "limit": 3000
  },
  "segments": {
    "used": 1,
    "limit": 3
  },
  "broadcasts": {
    "used": 2,
    "limit": null
  },
  "ai_credits": {
    "used": 5,
    "limit": 100,
    "next_increase_at": null
  },
  "automation_runs": {
    "used": 3,
    "limit": 10000,
    "resets_at": "2026-08-01T00:00:00.000Z"
  },
  "domains": {
    "used": 1,
    "limit": 1
  },
  "rate_limit": {
    "limit": 1000,
    "duration": "1000ms"
  }
}
```