> ## 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 Messages

> The **monitor_get_messages** API returns every stored copy of your mail that reached a seed, newest first, with where it landed and its authentication results. Messages are kept for 30 days.

Parameters can be sent in the query string, or in a JSON body with POST.
#### Header:
**X-CC-API-Key**: Your API Key
#### Parameters (all optional):
- **domain_id**: Only this monitored domain (default: all verified domains).
- **provider_key**: Only this provider (values from **monitor_get_seeds**).
- **placement**: Inbox, Spam, Promotions, Social, Updates, Newsletter, Announcements, Forums or Other.
- **days**: 1 to 30, default 30.
- **page**: 1-based, default 1.
- **page_size**: 1 to 200, default 50.
#### Response:
- **page**, **page_size**, **total**
- **messages**:
   - **message_id**: Use with **monitor_get_message**.
   - **domain_id**, **domain**: The monitored domain the message matched.
   - **from**, **subject**
   - **seed**, **provider**, **provider_key**: The seed it reached.
   - **placement**: Where it landed (normalized).
   - **folder**: The mailbox folder it was found in.
   - **received_at**: UTC time.
   - **authentication**: **passed** (true/false), **spf**, **dkim**, **dmarc**.



## OpenAPI

````yaml GET /v1/monitor_get_messages
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_messages:
    get:
      tags:
        - Inbox Placement Monitor
      summary: Get Monitor Messages
      description: >-
        The **monitor_get_messages** API returns every stored copy of your mail
        that reached a seed, newest first, with where it landed and its
        authentication results. Messages are kept for 30 days.


        Parameters can be sent in the query string, or in a JSON body with POST.

        #### Header:

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

        #### Parameters (all optional):

        - **domain_id**: Only this monitored domain (default: all verified
        domains).

        - **provider_key**: Only this provider (values from
        **monitor_get_seeds**).

        - **placement**: Inbox, Spam, Promotions, Social, Updates, Newsletter,
        Announcements, Forums or Other.

        - **days**: 1 to 30, default 30.

        - **page**: 1-based, default 1.

        - **page_size**: 1 to 200, default 50.

        #### Response:

        - **page**, **page_size**, **total**

        - **messages**:
           - **message_id**: Use with **monitor_get_message**.
           - **domain_id**, **domain**: The monitored domain the message matched.
           - **from**, **subject**
           - **seed**, **provider**, **provider_key**: The seed it reached.
           - **placement**: Where it landed (normalized).
           - **folder**: The mailbox folder it was found in.
           - **received_at**: UTC time.
           - **authentication**: **passed** (true/false), **spf**, **dkim**, **dmarc**.
      parameters:
        - name: X-CC-API-Key
          in: header
          schema:
            type: string
          example: '{{api_key}}'
        - name: domain_id
          in: query
          schema:
            type: integer
        - name: provider_key
          in: query
          schema:
            type: string
          example: gmail.com
        - name: placement
          in: query
          schema:
            type: string
          example: Spam
        - name: days
          in: query
          schema:
            type: integer
          example: 7
        - name: page
          in: query
          schema:
            type: integer
          example: 1
        - name: page_size
          in: query
          schema:
            type: integer
          example: 50
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
              example:
                page: 1
                page_size: 50
                total: 21
                messages:
                  - message_id: 9821
                    domain_id: 12
                    domain: example.com
                    from: news@example.com
                    subject: October offers
                    seed: cc_seed_01@aol.com
                    provider: AOL
                    provider_key: imap.aol.com
                    placement: Spam
                    folder: Bulk
                    received_at: '2026-10-20T11:29:00Z'
                    authentication:
                      passed: true
                      spf: pass
                      dkim: pass
                      dmarc: pass

````

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