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

# Exclude Removed Entities

> Opt-out filter to hide REMOVED Google Ads entities from listing endpoints

<Note>
  This page is also available in [Ukrainian](/guides/exclude-removed-uk).
</Note>

## Overview

All Google Ads listing endpoints now return **REMOVED** entities (deleted
campaigns, ad groups, ads, keywords) by default. To hide them, pass
`?exclude_removed=true`.

This is a **non-breaking change** — existing responses now include additional
rows with `status: "REMOVED"`. The old behavior is available via opt-out.

***

## How to use

Add `?exclude_removed=true` to any listing endpoint to restore previous
filtering:

```
GET /api/v1/google-ads/{customer_id}/ad-groups?exclude_removed=true
GET /api/v1/google-ads/{customer_id}/keywords?exclude_removed=true
```

Omitting the parameter (or `exclude_removed=false`) returns everything,
including REMOVED entities.

### Parameter

| Property | Value             |
| -------- | ----------------- |
| Name     | `exclude_removed` |
| Type     | `bool` (optional) |
| Default  | `false`           |

***

## Affected endpoints

| Endpoint            | What gets filtered when `true`             |
| ------------------- | ------------------------------------------ |
| `/campaigns`        | removed campaigns                          |
| `/campaigns/csv`    | removed campaigns                          |
| `/ad-groups`        | removed ad groups                          |
| `/ad-groups/csv`    | removed ad groups                          |
| `/ads`              | removed campaigns, ad groups, and ads      |
| `/ads/csv`          | removed campaigns, ad groups, and ads      |
| `/keywords`         | removed campaigns, ad groups, and keywords |
| `/keywords/csv`     | removed campaigns, ad groups, and keywords |
| `/search-terms`     | removed campaigns and ad groups            |
| `/search-terms/csv` | removed campaigns and ad groups            |
| `/assets`           | removed campaigns                          |
| `/ad-schedule`      | removed campaigns                          |
| `/ad-schedule/csv`  | removed campaigns                          |
| `/locations`        | removed campaigns                          |

***

## Frontend integration

<Tabs>
  <Tab title="Quick (preserve old behavior)">
    Add `&exclude_removed=true` to all listing API calls. Nothing else changes.

    ```typescript theme={null}
    const params = {
      customer_id: customerId,
      start_date: startDate,
      end_date: endDate,
      exclude_removed: true, // ← add this
    };
    ```
  </Tab>

  <Tab title="Recommended (show REMOVED)">
    Remove the parameter (or leave it `false`) and handle `status: "REMOVED"`
    in your table rendering — e.g., gray out the row or show a badge.

    ```typescript theme={null}
    // No exclude_removed param needed — REMOVED entities are included
    const params = {
      customer_id: customerId,
      start_date: startDate,
      end_date: endDate,
    };
    ```
  </Tab>
</Tabs>