# Change History View changes made to resources within a Project. Change History is a historical log of changes (create, update, and delete) made to [supported entity types](https://docs.commercetools.com/api/history/overview.md#supported-entities) within a Project. On this page, you can find the common types used by the Change History API. To view change types related to entities, see their dedicated pages. The default offering of Audit Log (Audit Log Basic) only tracks changes made in the [Merchant Center](https://docs.commercetools.com/merchant-center/). With Audit Log Basic, changes originating from other sources, such as [APIs](https://docs.commercetools.com/api), will not show in the query results. ## Hosts The Change History API has different hosts than the [HTTP API](https://docs.commercetools.com/api/general-concepts.md#hosts) and is hosted at the following URLs: (a CSV formatted table follows. The first line are the column names.) Region,API URL North America (Google Cloud, Iowa),`https://history.us-central1.gcp.commercetools.com/` North America (AWS, Ohio),`https://history.us-east-2.aws.commercetools.com/` Europe (Google Cloud, Belgium),`https://history.europe-west1.gcp.commercetools.com/` Europe (AWS, Frankfurt),`https://history.eu-central-1.aws.commercetools.com/` Australia (Google Cloud, Sydney),`https://history.australia-southeast1.gcp.commercetools.com/` If the documentation refers to `https://history.{region}.commercetools.com`, replace the `{region}` placeholder with the actual value. ## Representations Representations are JSON objects submitted or received as payload to API requests or responses. #### Record See API type definition [Record](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3ARecord). #### RecordPagedQueryResponse See API type definition [RecordPagedQueryResponse](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3ARecordPagedQueryResponse). #### ModifiedBy See API type definition [ModifiedBy](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AModifiedBy). #### Source See API type definition [Source](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3ASource). #### ChangeHistoryResourceType See API type definition [ChangeHistoryResourceType](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AChangeHistoryResourceType). #### Label Provides descriptive information specific to the change. ##### AssociateRoleLabel See API type definition [AssociateRoleLabel](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AAssociateRoleLabel). ##### BusinessUnitLabel See API type definition [BusinessUnitLabel](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3ABusinessUnitLabel). ##### CustomerLabel See API type definition [CustomerLabel](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3ACustomerLabel). ##### CustomObjectLabel See API type definition [CustomObjectLabel](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3ACustomObjectLabel). ##### LocalizedLabel See API type definition [LocalizedLabel](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3ALocalizedLabel). ##### OrderLabel See API type definition [OrderLabel](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AOrderLabel). ##### PaymentLabel See API type definition [PaymentLabel](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3APaymentLabel). ##### ProductLabel See API type definition [ProductLabel](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AProductLabel). ##### QuoteRequestLabel See API type definition [QuoteRequestLabel](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AQuoteRequestLabel). ##### QuoteLabel See API type definition [QuoteLabel](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AQuoteLabel). ##### ReviewLabel See API type definition [ReviewLabel](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AReviewLabel). ##### ShippingMethodLabel See API type definition [ShippingMethodLabel](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AShippingMethodLabel). ##### StandalonePriceLabel See API type definition [StandalonePriceLabel](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AStandalonePriceLabel). ##### StagedQuoteLabel See API type definition [StagedQuoteLabel](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AStagedQuoteLabel). ##### StringLabel See API type definition [StringLabel](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AStringLabel). #### DateStringFilter This data type consists of one enum value: `"now"`. #### PlatformInitiatedChange See API type definition [PlatformInitiatedChange](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3APlatformInitiatedChange). #### Change See API type definition [Change](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AChange). ##### UnknownChange See API type definition [UnknownChange](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AUnknownChange). #### ChangeValue ##### AssetChangeValue See API type definition [AssetChangeValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AAssetChangeValue). ##### CustomFieldExpandedValue See API type definition [CustomFieldExpandedValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3ACustomFieldExpandedValue). ##### CustomShippingMethodChangeValue See API type definition [CustomShippingMethodChangeValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3ACustomShippingMethodChangeValue). ##### DeliveryChangeValue See API type definition [DeliveryChangeValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3ADeliveryChangeValue). ##### ParcelChangeValue See API type definition [ParcelChangeValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AParcelChangeValue). ##### ShippingMethodChangeValue See API type definition [ShippingMethodChangeValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AShippingMethodChangeValue). ##### TransactionChangeValue See API type definition [TransactionChangeValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3ATransactionChangeValue). ##### ChangeValueChangeValue Indicates how a Cart or Product is discounted: - [ChangeValueAbsoluteChangeValue](https://docs.commercetools.com/api/history/change-history.md#changevalueabsolutechangevalue) for Cart or Product discounted by an absolute value - [ChangeValueRelativeChangeValue](https://docs.commercetools.com/api/history/change-history.md#changevaluerelativechangevalue) for Cart or Product discounted by a relative value - [ChangeValueGiftLineItemChangeValue](https://docs.commercetools.com/api/history/change-history.md#changevaluegiftlineitemchangevalue) for free Line Item added as a gift to the Cart - [ChangeValueExternalChangeValue](https://docs.commercetools.com/api/history/change-history.md#changevalueexternalchangevalue) for Product discounted by an external service ##### ChangeValueAbsoluteChangeValue See API type definition [ChangeValueAbsoluteChangeValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AChangeValueAbsoluteChangeValue). ##### ChangeValueRelativeChangeValue See API type definition [ChangeValueRelativeChangeValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AChangeValueRelativeChangeValue). ##### ChangeValueGiftLineItemChangeValue See API type definition [ChangeValueGiftLineItemChangeValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AChangeValueGiftLineItemChangeValue). ##### ChangeValueExternalChangeValue See API type definition [ChangeValueExternalChangeValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AChangeValueExternalChangeValue). #### ChangeTargetChangeValue Indicates the segment of the Cart that is discounted: - [ChangeTargetLineItemsChangeValue](https://docs.commercetools.com/api/history/change-history.md#changetargetlineitemschangevalue) for [LineItems](https://docs.commercetools.com/api/projects/carts.md#lineitem) - [ChangeTargetCustomLineItemsChangeValue](https://docs.commercetools.com/api/history/change-history.md#changetargetcustomlineitemschangevalue) for [CustomLineItems](https://docs.commercetools.com/api/projects/carts.md#customlineitem) - [ChangeTargetShippingChangeValue](https://docs.commercetools.com/api/history/change-history.md#changetargetshippingchangevalue) for [ShippingInfo](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3AShippingInfo) - [ChangeTargetMultiBuyLineItemsChangeValue](https://docs.commercetools.com/api/history/change-history.md#changetargetmultibuylineitemschangevalue) for [MultiBuyLineItemsTarget](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3AMultiBuyLineItemsTarget) - [ChangeTargetMultiBuyCustomLineItemsChangeValue](https://docs.commercetools.com/api/history/change-history.md#changetargetmultibuycustomlineitemschangevalue) for [MultiBuyCustomLineItemsTarget](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3AMultiBuyCustomLineItemsTarget) - [ChangeTargetPatternChangeValue](https://docs.commercetools.com/api/history/change-history.md#changetargetpatternchangevalue) for [CartDiscountPatternTarget](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3ACartDiscountPatternTarget) ##### ChangeTargetLineItemsChangeValue See API type definition [ChangeTargetLineItemsChangeValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AChangeTargetLineItemsChangeValue). ##### ChangeTargetCustomLineItemsChangeValue See API type definition [ChangeTargetCustomLineItemsChangeValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AChangeTargetCustomLineItemsChangeValue). ##### ChangeTargetShippingChangeValue See API type definition [ChangeTargetShippingChangeValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AChangeTargetShippingChangeValue). ##### ChangeTargetMultiBuyLineItemsChangeValue See API type definition [ChangeTargetMultiBuyLineItemsChangeValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AChangeTargetMultiBuyLineItemsChangeValue). ##### ChangeTargetMultiBuyCustomLineItemsChangeValue See API type definition [ChangeTargetMultiBuyCustomLineItemsChangeValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AChangeTargetMultiBuyCustomLineItemsChangeValue). ##### ChangeTargetPatternChangeValue See API type definition [ChangeTargetPatternChangeValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AChangeTargetPatternChangeValue). #### Embedded values ##### AttributeValue See API type definition [AttributeValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AAttributeValue). ##### EnumValue See API type definition [EnumValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AEnumValue). ##### LocalizedEnumValue See API type definition [LocalizedEnumValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3ALocalizedEnumValue). ##### FieldDefinitionOrderValue See API type definition [FieldDefinitionOrderValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AFieldDefinitionOrderValue). ##### InventoryQuantityValue See API type definition [InventoryQuantityValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AInventoryQuantityValue). ##### ShoppingListLineItemValue See API type definition [ShoppingListLineItemValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AShoppingListLineItemValue). ##### SetCartClassificationShippingRateInputValue See API type definition [SetCartClassificationShippingRateInputValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3ASetCartClassificationShippingRateInputValue). ##### SetCartScoreShippingRateInputValue See API type definition [SetCartScoreShippingRateInputValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3ASetCartScoreShippingRateInputValue). ##### ShippingMethodTaxAmountChangeValue See API type definition [ShippingMethodTaxAmountChangeValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AShippingMethodTaxAmountChangeValue). ##### TaxedPrice See API type definition [TaxedPrice](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3ATaxedPrice). ##### TextLineItemValue See API type definition [TextLineItemValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3ATextLineItemValue). ##### ValidFromAndUntilValue See API type definition [ValidFromAndUntilValue](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Atype%3AValidFromAndUntilValue). ## Query Records See API endpoint definition [GET /\{projectKey}](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Aendpoint%3A%2F%7BprojectKey%7D%3AGET). ### Query Records for specific resource type See API endpoint definition [GET /\{projectKey}/\{resourceType}](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Aendpoint%3A%2F%7BprojectKey%7D%2F%7BresourceType%7D%3AGET). ### Query Records by resource ID See API endpoint definition [GET /\{projectKey}/\{resourceType}/\{id}](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Aendpoint%3A%2F%7BprojectKey%7D%2F%7BresourceType%7D%2F%7Bid%7D%3AGET). ## Query Records with GraphQL Our Change History API is versionless, meaning new types and fields may be introduced at any time without notice. As a result, dynamic schema stitching is discouraged, as it can lead to naming conflicts and unexpected behavior. GraphQL uses HTTP POST requests to query data. Access to resources is granted by the same [scopes](https://docs.commercetools.com/api/scopes.md) that are used on the REST API endpoints. The `view_audit_log:{projectKey}` scope is required, and depending on the [resource type](https://docs.commercetools.com/api/history/change-history.md#changehistoryresourcetype) queried, their respective scopes must be granted too—for example, to filter queries by Categories, provide the `view_categories:{projectKey}` scope too. See API endpoint definition [POST /\{projectKey}/graphql](https://docs.commercetools.com/api/history/change-history.md?urn=ctp%3Ahistory%3Aendpoint%3A%2F%7BprojectKey%7D%2Fgraphql%3APOST). ### Interactive GraphQL console You can also use the [Apollo GraphQL console](https://studio.apollographql.com/sandbox/explorer) to query Records. It lets you explore the documentation for supported GraphQL queries and introspect the GraphQL schema. In the console, go to Connection settings and enter the values for the following: - For Endpoint, enter: ```bash https://history.{region}.commercetools.com/{projectKey}/graphql ``` - For Shared headers, select `Authorization` as the header key and enter `Bearer {bearerToken}` as the value. ## Related pages - [Section overview page](https://docs.commercetools.com/api.md) - [Previous page: Overview](https://docs.commercetools.com/api/history/overview.md)