---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/en/changes/checkCampaigns.md
  - https://yandex.com/dev/direct/doc/ru/changes/checkCampaigns.md
  - href: en/changes/checkCampaigns.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: en/ref-v5/changes/checkCampaigns.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/en/llms.txt

# checkCampaigns

Informs you of changes in the client's campaigns starting from the specified date.

### Learn more {#see-also}

- [How to check for changes](https://yandex.com/dev/direct/doc/dg/best-practice/check-changes.html)


## Request {#input}

Request structure in JSON format:

```javascript
{
  "method": "checkCampaigns",
  "params": { /* params */
    "Timestamp": (string) /* required */
  }
}
```

#|
|| **Parameter**  | **Type**  | **Description**  | **Required** ||

|| **params structure (for JSON) / CheckCampaignsRequest structure (for SOAP)** | > | > | > ||

|| `Timestamp` | string | The exact time to start from to check for changes. Specified in the format `YYYY-MM-DDThh:mm:ssZ` (following ISO 8601), such as `2015-05-24T23:59:59Z`.  | Yes ||
|# 


## Response {#output}

Response structure in JSON format:

```javascript
{
  "result": { /* result */
    "Campaigns": [{  /* CampaignChangesItem */
      "CampaignId": (long), /* required */
      "ChangesIn": [( "SELF" | "CHILDREN" | "STAT" ), ... ] /* required */
    }, ... ],
    "Timestamp": (string) /* required */
  }
}
```

#|
|| **Parameter**  | **Type**  | **Description**  ||

|| **result structure (for JSON) / CheckCampaignsResponse structure (for SOAP)** | > | > ||

|| `Campaigns` | array of CampaignChangesItem | Campaigns where changes were made.  ||

|| `Timestamp` | string | The exact time when changes were checked. Specified in the format `YYYY-MM-DDThh:mm:ssZ` (following ISO 8601), such as `2015-05-24T23:59:59Z`.  The timestamp is specified in the next method call, to check for changes starting from this time.  ||

|| **CampaignChangesItem structure** | > | > ||

|| `CampaignId` | long | The campaign ID.  ||

|| `ChangesIn` | array of CampaignChangesInEnum | Where exactly the changes occurred:

- SELF — In campaign parameters.
- CHILDREN — In child objects: groups, ads, or keywords.
- STAT — Corrected campaign statistics (usually related to filtering out false clicks).  ||
|# 


## Examples {#samples}

**Checking for changes in campaigns starting from 02.02.2015 10:08:22 UTC**
 
```javascript
    {
      "method": "checkCampaigns",
      "params": {
        "Timestamp": "2015-02-02T10:08:22Z"
      }
    }
```

**Response**
 
```javascript
    {
      "result": {
        "Campaigns": [{
          "CampaignId": 13243,
          "ChangesIn": ["SELF"]
        },
        {
          "CampaignId": 13326,
          "ChangesIn": ["SELF","CHILDREN"]
        },
        {
          "CampaignId": 14742,
          "ChangesIn": ["CHILDREN"]
        }],
        "Timestamp": "2015-02-02T12:24:31Z"
      }
    }
```

Changes were made in three campaigns: campaign parameters changed in two of them, and child objects changed in two of them.