---
updatedAt: 2026-06-12T17:46:13.000Z
agentTools:
  projectIndex: https://mcm-docs.moloco.com/llms.txt
---

# QueryCampaignItemsHistory

Query items' history in the campaign.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Management API",
    "description": "MOLOCO RMP Management API provides functionalities for MOLOCO RMP systems.",
    "version": "1.0",
    "contact": {
      "name": "Moloco Inc.",
      "url": "https://www.molocoads.com"
    }
  },
  "paths": {
    "/rmp/mgmt/v1/platforms/{platform_id}/ad-accounts/{ad_account_id}/campaigns/{campaign_id}/change-log-items": {
      "post": {
        "summary": "QueryCampaignItemsHistory",
        "description": "Query items' history in the campaign.",
        "operationId": "RmpManagementApi_QueryCampaignChangeLogItems",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/publicQueryCampaignChangeLogItemsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request. Detailed cause can be found in the response message.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/publicRepresentedError"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/publicRepresentedError"
                }
              }
            }
          },
          "403": {
            "description": "Permission denied.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/publicRepresentedError"
                }
              }
            }
          },
          "404": {
            "description": "Not found. One or more required resources do not exist.You can see the details in the response message.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/publicRepresentedError"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error. Detailed cause can be found in the response message.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/publicRepresentedError"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "platform_id",
            "description": "Identifier of the platform who requests management api. It is passed as a path parameter.",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ad_account_id",
            "description": "AdAccount id.",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "campaign_id",
            "description": "Campaign id.",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "updated_at": {
                    "type": "string",
                    "format": "date-time",
                    "description": "Updated timestamp of Campaign."
                  },
                  "type": {
                    "$ref": "#/components/schemas/v1ChangeLogItemsType"
                  },
                  "page_index": {
                    "type": "integer",
                    "format": "int32",
                    "description": "Index of the page to be returned. If empty, the default page_index will be 1."
                  },
                  "page_size": {
                    "type": "integer",
                    "format": "int32",
                    "description": "Number of items to be returned on this page index. The maximum number is 5000."
                  },
                  "search_keyword": {
                    "type": "string",
                    "description": "Search keyword. Specific string in the item id/title to search for."
                  },
                  "order_by": {
                    "$ref": "#/components/schemas/v1ChangeLogItemsOrderBy"
                  }
                },
                "description": "Request message of QueryCampaignItemsHistory.",
                "required": [
                  "updated_at",
                  "type"
                ],
                "additionalProperties": true
              }
            }
          },
          "required": true
        },
        "tags": [
          "ChangeHistory"
        ]
      }
    }
  },
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "x-readme": {
    "explorer-enabled": false
  },
  "servers": [
    {
      "url": "https://<platform>-mgmt.mcm-api.moloco.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header"
      }
    },
    "schemas": {
      "RepresentedErrorDetail": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "The type of the metadata."
          },
          "category": {
            "$ref": "#/components/schemas/commonErrorCategory"
          },
          "metadata": {
            "type": "object",
            "description": "The metadata of the responded error.",
            "additionalProperties": true
          }
        },
        "required": [
          "type",
          "category"
        ],
        "additionalProperties": true
      },
      "commonErrorCategory": {
        "type": "string",
        "enum": [
          "DEFAULT_ERROR_CATEGORY",
          "INPUT_VALIDATION",
          "CHARACTER_LIMIT_EXCEEDED",
          "TIMESTAMP_MISMATCH",
          "FEATURE_NOT_ALLOWED",
          "REINVITE_NOT_ALLOWED",
          "LAST_OWNER_REVOKE_NOT_ALLOWED",
          "LAST_OWNER_DELETE_NOT_ALLOWED",
          "SSO_USER_JOIN_REQUEST_NOT_ALLOWED",
          "MFA_VERIFICATION_FAILED",
          "INSUFFICIENT_SPENDING_LIMIT",
          "AD_ACCOUNT_ALREADY_OWNED",
          "INSUFFICIENT_WALLET_BALANCE",
          "INSUFFICIENT_SPEND_CAP_BUDGET",
          "MAX_SPEND_CAP_COUNT_REACHED",
          "MAX_CAMPAIGNS_COUNT_PER_SPEND_CAP_REACHED",
          "MAX_CAMPAIGN_COUNT_REACHED",
          "MODIFY_ARCHIVED_CAMPAIGN_NOT_ALLOWED",
          "INVALID_CAMPAIGN_STATUS_FOR_ARCHIVE",
          "INVALID_MANAGED_CPT_CAMPAIGN_SCHEDULE",
          "INACTIVE_AD_ACCOUNT",
          "DUPLICATE_AUDIENCE",
          "INVALID_RESERVED_TIME_LINE_ITEM_SCHEDULE",
          "EXCEED_MAX_IMAGE_SIZE",
          "MAX_LABEL_COUNT_REACHED",
          "MAX_LABEL_VALUE_COUNT_REACHED",
          "MAX_LABEL_VALUE_RELATIONSHIP_COUNT_REACHED",
          "PLATFORM_INSIGHT_UNAVAILABLE",
          "MAX_CUSTOM_TARGETING_KEY_COUNT_REACHED",
          "INVALID_CUSTOM_TARGETING"
        ],
        "default": "DEFAULT_ERROR_CATEGORY",
        "title": "- INPUT_VALIDATION: INPUT_VALIDATION: reserved for 1 ~ 99\n - TIMESTAMP_MISMATCH: TIMESTAMP_MISSMATCH: reserved for 100 ~ 199\n - FEATURE_NOT_ALLOWED: General policy: 1000 ~ 1999\n - REINVITE_NOT_ALLOWED: User policy: 2000 ~ 2999\n - INSUFFICIENT_SPENDING_LIMIT: Account policy: 3000 ~ 3999\nThis policy includes ad manager account, ad account, and wallet related policies\n - MAX_CAMPAIGN_COUNT_REACHED: Campaign policy: 4000 ~ 4999\n - INVALID_RESERVED_TIME_LINE_ITEM_SCHEDULE: Returned when a RESERVED_TIME line item's schedule overlaps an existing enabled RD booking on the same inventory.\n - EXCEED_MAX_IMAGE_SIZE: Asset policy: 5000 ~ 5999\n - MAX_LABEL_COUNT_REACHED: Labeling policy: 6000 ~ 6999\n - PLATFORM_INSIGHT_UNAVAILABLE: Insight metric policy: 7000 ~ 7999\n - MAX_CUSTOM_TARGETING_KEY_COUNT_REACHED: Custom Targeting policy: 8000 ~ 8999"
      },
      "commonOrderByDirection": {
        "type": "string",
        "enum": [
          "UNKNOWN_ORDER_BY_DIRECTION",
          "ASC",
          "DESC"
        ],
        "default": "UNKNOWN_ORDER_BY_DIRECTION"
      },
      "commonPageInfo": {
        "type": "object",
        "properties": {
          "page_index": {
            "type": "integer",
            "format": "int32",
            "description": "Current page we are at."
          },
          "page_size": {
            "type": "integer",
            "format": "int32",
            "description": "Number of items per page."
          },
          "pages_total": {
            "type": "integer",
            "format": "int32",
            "description": "Total number of pages."
          },
          "rows_total": {
            "type": "integer",
            "format": "int32",
            "description": "Total number of rows."
          }
        },
        "description": "Page information.",
        "required": [
          "page_index",
          "page_size",
          "pages_total",
          "rows_total"
        ],
        "additionalProperties": true
      },
      "publicQueryCampaignChangeLogItemsResponse": {
        "type": "object",
        "properties": {
          "rows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1CampaignChangeLogItem"
            },
            "description": "List of campaigned item history."
          },
          "page_info": {
            "$ref": "#/components/schemas/commonPageInfo"
          }
        },
        "description": "Response message of QueryCampaignItemsHistory.",
        "required": [
          "rows",
          "page_info"
        ],
        "additionalProperties": true
      },
      "publicRepresentedError": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32",
            "description": "The status code, which should be an enum value of google.rpc.Code.(https://developers.google.com/actions-center/reference/grpc-api/status_codes)"
          },
          "message": {
            "type": "string",
            "description": "The detailed message of responded error."
          },
          "details": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RepresentedErrorDetail"
            },
            "description": "The detailed information of responded error. Please refer to the error category section in guides for more detailed information.(https://rmp-docs.moloco.com/docs/management-api-error-categories)"
          }
        },
        "title": "Overridden from grpc status(https://github.com/grpc/grpc/blob/master/src/proto/grpc/status/status.proto)",
        "required": [
          "code",
          "message",
          "details"
        ],
        "additionalProperties": true
      },
      "v1CampaignChangeLogItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The id of the CampaignChangeLogItem."
          },
          "title": {
            "type": "string",
            "description": "The title of the CampaignChangeLogItem."
          }
        },
        "description": "Definition of a CampaignChangeLogItem.",
        "required": [
          "id",
          "title"
        ],
        "additionalProperties": true
      },
      "v1ChangeLogItemsOrderBy": {
        "type": "object",
        "properties": {
          "column": {
            "$ref": "#/components/schemas/v1ChangeLogItemsOrderByOrderByColumn"
          },
          "direction": {
            "$ref": "#/components/schemas/commonOrderByDirection"
          }
        },
        "additionalProperties": true
      },
      "v1ChangeLogItemsOrderByOrderByColumn": {
        "type": "string",
        "enum": [
          "UNKNOWN_ORDER_BY_COLUMN",
          "ID",
          "TITLE",
          "UPDATED_AT"
        ],
        "default": "UNKNOWN_ORDER_BY_COLUMN"
      },
      "v1ChangeLogItemsType": {
        "type": "string",
        "enum": [
          "UNKNOWN_TYPE",
          "REMOVED",
          "ADDED"
        ],
        "default": "UNKNOWN_TYPE"
      }
    }
  }
}
```