---
updatedAt: 2026-04-23T12:53:11.000Z
agentTools:
  projectIndex: https://developers.themarketer.com/llms.txt
---

# Get Unsubscribed Emails

If you use multiple subscriber management systems, then you can use this API in order to retrieve contacts who have unsubscribed from theMarketer, in order to unsubscribe them from your other systems as well.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "theMarketer API",
    "version": "1.0.0",
    "description": ""
  },
  "servers": [
    {
      "url": "https://t.themarketer.com"
    }
  ],
  "paths": {
    "/api/v1/unsubscribed_emails": {
      "parameters": [],
      "get": {
        "summary": "Get Unsubscribed Emails",
        "tags": [],
        "parameters": [
          {
            "name": "k",
            "in": "query",
            "required": true,
            "deprecated": false,
            "schema": {
              "type": "string"
            },
            "example": "REST_KEY"
          },
          {
            "name": "u",
            "in": "query",
            "required": true,
            "deprecated": false,
            "schema": {
              "type": "string"
            },
            "example": "CUSTOMER_ID"
          },
          {
            "name": "date_from",
            "in": "query",
            "required": false,
            "deprecated": false,
            "schema": {
              "type": "string",
              "format": "date"
            },
            "example": "2023-01-01"
          },
          {
            "name": "date_to",
            "in": "query",
            "required": false,
            "deprecated": false,
            "schema": {
              "type": "string",
              "format": "date"
            },
            "example": "2025-07-07"
          }
        ],
        "responses": {
          "200": {
            "description": "200 Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "format": "email",
                    "example": "['email@example.com', 'email2@example.com']",
                    "description": "Array of unsubscribed email addresses"
                  }
                },
                "example": [
                  "ac+zapier@themarketer.com",
                  "ac+zapier1@themarketer.com",
                  "ac+zapier2@themarketer.com",
                  "cosmin.oancea@themarketer.com",
                  "bt@themarketer4.com",
                  "bt@themarketer5.com",
                  "cosmin.oancea+test13@themarketer.com",
                  "cosmin.oancea+test29@themarketer.com",
                  "email@example.com",
                  "bt@themarketer3.com",
                  "alexclain@yahoo.com",
                  "testingduplicatesms@themarketer.com",
                  "accccccccc33@themarketer.com",
                  "asdfsdfsfsdf@themarketer.com"
                ]
              }
            }
          },
          "404": {
            "description": "404 Not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "No query results for model [App\\Models\\System\\Domain] CUSTOMER_ID",
                      "description": "No query results for model [App\\Models\\System\\Domain] CUSTOMER_ID"
                    }
                  }
                },
                "example": {
                  "message": "No query results for model [App\\Models\\System\\Domain] CUSTOMER_ID"
                }
              }
            }
          },
          "405": {
            "description": "405 method not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "The POST method is not supported for this route. Supported methods: GET, HEAD.",
                      "description": "The POST method is not supported for this route. Supported methods: GET, HEAD."
                    }
                  }
                },
                "example": {
                  "message": "The POST method is not supported for this route. Supported methods: GET, HEAD."
                }
              }
            }
          }
        }
      }
    }
  }
}
```