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

# Get Monitor Usage

> The **monitor_get_usage** API shows how many messages have been stored this billing period. Limits reset on your billing date (the 1st of the month, UTC, without a subscription). A null limit means unlimited.
#### Header:
**X-CC-API-Key**: Your API Key
#### Response:
- **messages_used**, **messages_limit**: Messages that passed authentication.
- **failed_auth_used**, **failed_auth_limit**: Messages that failed SPF/DKIM/DMARC.
- **not_stored**: Copies that arrived after a limit was reached.
- **resets_at**: When the counters start again (UTC).



## OpenAPI

````yaml GET /v1/monitor_get_usage
openapi: 3.0.0
info:
  title: API DOCUMENTATION
  description: >-


    [Campaign Cleaner](https://campaigncleaner.com) is the leader in ensuring
    that your campaigns don't affect your IP and Domain reputation, it's the
    most advanced toolset you'll find that gives you all the tools you need to
    keep your campaigns within acceptable ratios of many email and spam
    filtering software and automatically fixes your HTML by sanitizing all
    non-email friendly attributes and inlines all your CSS to be compatible with
    every email client.


    We offer a robust collection of API's to allow you to integrate its
    functionality into your email marketing software and tools.


    The **{{api_key}}** is located in your account on [Campaign
    Cleaner](https://campaigncleaner.com) under **API Management API Keys.**


    The **Inbox Placement Monitor** endpoints (monitor_*) let you get the seed
    addresses, manage the domains you send from, read where every copy of your
    real campaigns landed, and manage placement alerts. They are included with
    The Works and the Inbox Placement Tester plan and don't use API credits.


    Use the navigation on the left to access the different API Endpoints.
  version: 1.0.0
servers:
  - url: https://api.campaigncleaner.com
security: []
tags:
  - name: Campaign Cleaner
    description: Campaign analysis, cleaning, credits and inbox placement tests.
  - name: Inbox Placement Monitor
    description: >-
      Track where your real campaigns land. Add the seed addresses to your
      normal sends, verify the domains you send from, then read placement per
      message or per provider and manage alerts. No API credits are used.
      Limits: 60 calls a minute per account and 120 a minute per client IP.
paths:
  /v1/monitor_get_usage:
    get:
      tags:
        - Inbox Placement Monitor
      summary: Get Monitor Usage
      description: >-
        The **monitor_get_usage** API shows how many messages have been stored
        this billing period. Limits reset on your billing date (the 1st of the
        month, UTC, without a subscription). A null limit means unlimited.

        #### Header:

        **X-CC-API-Key**: Your API Key

        #### Response:

        - **messages_used**, **messages_limit**: Messages that passed
        authentication.

        - **failed_auth_used**, **failed_auth_limit**: Messages that failed
        SPF/DKIM/DMARC.

        - **not_stored**: Copies that arrived after a limit was reached.

        - **resets_at**: When the counters start again (UTC).
      parameters:
        - name: X-CC-API-Key
          in: header
          schema:
            type: string
          example: '{{api_key}}'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
              example:
                messages_used: 21
                messages_limit: 1000
                failed_auth_used: 0
                failed_auth_limit: 50
                not_stored: 0
                resets_at: '2026-11-14T09:00:00Z'

````

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