{
  "storefront": {
    "fromVersion": "2025-10",
    "toVersion": "2026-01",
    "apiType": "storefront",
    "generatedAt": "2025-12-03T12:02:51.248Z",
    "summary": {
      "totalChanges": 3,
      "breakingChanges": 1,
      "deprecations": 0,
      "additions": 0,
      "removals": 0,
      "modifications": 3
    },
    "changes": {
      "types": [
        {
          "name": "CartErrorCode",
          "kind": "ENUM",
          "changeType": "modified",
          "breaking": false,
          "description": "Enum value 'PARENT_LINE_INVALID_REFERENCE' was added to enum 'CartErrorCode'"
        },
        {
          "name": "CartErrorCode",
          "kind": "ENUM",
          "changeType": "modified",
          "breaking": false,
          "description": "Enum value 'GIFT_CARD_RECIPIENT_INVALID' was added to enum 'CartErrorCode'"
        },
        {
          "name": "Mutation",
          "kind": "OBJECT",
          "changeType": "modified",
          "breaking": true,
          "description": "Type for argument 'discountCodes' on field 'Mutation.cartDiscountCodesUpdate' changed from '[String!]' to '[String!]!'"
        }
      ],
      "queries": [],
      "mutations": [],
      "subscriptions": [],
      "enums": [
        {
          "name": "CartErrorCode",
          "kind": "ENUM",
          "changeType": "modified",
          "breaking": false,
          "description": "Enum value 'PARENT_LINE_INVALID_REFERENCE' was added to enum 'CartErrorCode'"
        },
        {
          "name": "CartErrorCode",
          "kind": "ENUM",
          "changeType": "modified",
          "breaking": false,
          "description": "Enum value 'GIFT_CARD_RECIPIENT_INVALID' was added to enum 'CartErrorCode'"
        }
      ]
    }
  },
  "customer-account": {
    "fromVersion": "2025-10",
    "toVersion": "2026-01",
    "apiType": "customer-account",
    "generatedAt": "2025-12-03T12:02:51.270Z",
    "summary": {
      "totalChanges": 48,
      "breakingChanges": 1,
      "deprecations": 0,
      "additions": 22,
      "removals": 0,
      "modifications": 5
    },
    "changes": {
      "types": [
        {
          "name": "AchPaymentDetails",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'AchPaymentDetails' was added"
        },
        {
          "name": "BankAccountHolderType",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'BankAccountHolderType' was added"
        },
        {
          "name": "BankAccountType",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'BankAccountType' was added"
        },
        {
          "name": "BankPaymentInstrument",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'BankPaymentInstrument' was added"
        },
        {
          "name": "BankPaymentMethod",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'BankPaymentMethod' was added"
        },
        {
          "name": "PaymentCredentialRemoteTokenInput",
          "kind": "INPUT_OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'PaymentCredentialRemoteTokenInput' was added"
        },
        {
          "name": "PaymentInstrumentAddPayload",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'PaymentInstrumentAddPayload' was added"
        },
        {
          "name": "PaymentInstrumentConnection",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'PaymentInstrumentConnection' was added"
        },
        {
          "name": "PaymentInstrumentEdge",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'PaymentInstrumentEdge' was added"
        },
        {
          "name": "PaymentInstrumentInput",
          "kind": "INPUT_OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'PaymentInstrumentInput' was added"
        },
        {
          "name": "PaymentInstrumentReplacePayload",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'PaymentInstrumentReplacePayload' was added"
        },
        {
          "name": "PaymentMandateInput",
          "kind": "INPUT_OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'PaymentMandateInput' was added"
        },
        {
          "name": "PaymentMandateResourceType",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'PaymentMandateResourceType' was added"
        },
        {
          "name": "PaymentMethod",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'PaymentMethod' was added"
        },
        {
          "name": "PaymentProviderClientCredentials",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'PaymentProviderClientCredentials' was added"
        },
        {
          "name": "RemoteTokenPaymentInstrumentInput",
          "kind": "INPUT_OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'RemoteTokenPaymentInstrumentInput' was added"
        },
        {
          "name": "ReturnReasonDefinition",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'ReturnReasonDefinition' was added"
        },
        {
          "name": "ReturnReasonDefinitionConnection",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'ReturnReasonDefinitionConnection' was added"
        },
        {
          "name": "ReturnReasonDefinitionEdge",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'ReturnReasonDefinitionEdge' was added"
        },
        {
          "name": "ReturnReasonDefinitionSortKeys",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'ReturnReasonDefinitionSortKeys' was added"
        },
        {
          "name": "OrderTransactionType",
          "kind": "ENUM",
          "changeType": "modified",
          "breaking": false,
          "description": "Enum value 'ACH' was added to enum 'OrderTransactionType'"
        },
        {
          "name": "PaymentDetails",
          "kind": "UNION",
          "changeType": "modified",
          "breaking": false,
          "description": "Member 'AchPaymentDetails' was added to Union type 'PaymentDetails'"
        },
        {
          "name": "RequestedLineItemInput",
          "kind": "INPUT_OBJECT",
          "changeType": "modified",
          "breaking": false,
          "description": "Input field 'returnReasonDefinitionId' of type 'ID' was added to input object type 'RequestedLineItemInput'"
        },
        {
          "name": "RequestedLineItemInput",
          "kind": "INPUT_OBJECT",
          "changeType": "modified",
          "breaking": true,
          "description": "Input field 'returnReason' was removed from input object type 'RequestedLineItemInput'"
        },
        {
          "name": "UserErrorsPaymentInstrumentUserErrorsCode",
          "kind": "ENUM",
          "changeType": "modified",
          "breaking": false,
          "description": "Enum value 'OWNER_ID_INVALID' was added to enum 'UserErrorsPaymentInstrumentUserErrorsCode'"
        }
      ],
      "queries": [],
      "mutations": [
        {
          "name": "paymentInstrumentAdd",
          "type": "Field",
          "changeType": "added",
          "description": "Field 'paymentInstrumentAdd' was added to object type 'Mutation'",
          "breaking": false
        },
        {
          "name": "paymentInstrumentReplace",
          "type": "Field",
          "changeType": "added",
          "description": "Field 'paymentInstrumentReplace' was added to object type 'Mutation'",
          "breaking": false
        }
      ],
      "subscriptions": [],
      "enums": [
        {
          "name": "OrderTransactionType",
          "kind": "ENUM",
          "changeType": "modified",
          "breaking": false,
          "description": "Enum value 'ACH' was added to enum 'OrderTransactionType'"
        },
        {
          "name": "UserErrorsPaymentInstrumentUserErrorsCode",
          "kind": "ENUM",
          "changeType": "modified",
          "breaking": false,
          "description": "Enum value 'OWNER_ID_INVALID' was added to enum 'UserErrorsPaymentInstrumentUserErrorsCode'"
        }
      ]
    }
  },
  "admin": {
    "fromVersion": "2025-10",
    "toVersion": "2026-01",
    "apiType": "admin",
    "generatedAt": "2025-12-03T12:02:51.412Z",
    "summary": {
      "totalChanges": 34,
      "breakingChanges": 2,
      "deprecations": 0,
      "additions": 6,
      "removals": 0,
      "modifications": 17
    },
    "changes": {
      "types": [
        {
          "name": "BankAccount",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'BankAccount' was added"
        },
        {
          "name": "BankAccountHolderType",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'BankAccountHolderType' was added"
        },
        {
          "name": "BankAccountType",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'BankAccountType' was added"
        },
        {
          "name": "BulkOperationConnection",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'BulkOperationConnection' was added"
        },
        {
          "name": "BulkOperationEdge",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'BulkOperationEdge' was added"
        },
        {
          "name": "BulkOperationsSortKeys",
          "kind": "OBJECT",
          "changeType": "added",
          "breaking": false,
          "description": "Type 'BulkOperationsSortKeys' was added"
        },
        {
          "name": "BillingAttemptUserErrorCode",
          "kind": "ENUM",
          "changeType": "modified",
          "breaking": false,
          "description": "Enum value 'THROTTLED' was added to enum 'BillingAttemptUserErrorCode'"
        },
        {
          "name": "CustomerPaymentInstrument",
          "kind": "UNION",
          "changeType": "modified",
          "breaking": false,
          "description": "Member 'BankAccount' was added to Union type 'CustomerPaymentInstrument'"
        },
        {
          "name": "InventoryTransferCreateAsReadyToShipInput",
          "kind": "INPUT_OBJECT",
          "changeType": "modified",
          "breaking": false,
          "description": "Input field 'InventoryTransferCreateAsReadyToShipInput.originLocationId' changed type from 'ID!' to 'ID'"
        },
        {
          "name": "InventoryTransferCreateAsReadyToShipInput",
          "kind": "INPUT_OBJECT",
          "changeType": "modified",
          "breaking": false,
          "description": "Input field 'InventoryTransferCreateAsReadyToShipInput.destinationLocationId' changed type from 'ID!' to 'ID'"
        },
        {
          "name": "Mutation",
          "kind": "OBJECT",
          "changeType": "modified",
          "breaking": false,
          "description": "Type for argument 'callbackUrl' on field 'Mutation.fulfillmentServiceCreate' changed from 'URL!' to 'URL'"
        },
        {
          "name": "OrderInput",
          "kind": "INPUT_OBJECT",
          "changeType": "modified",
          "breaking": false,
          "description": "Input field 'phone' of type 'String' was added to input object type 'OrderInput'"
        },
        {
          "name": "PaymentInstrument",
          "kind": "UNION",
          "changeType": "modified",
          "breaking": false,
          "description": "Member 'BankAccount' was added to Union type 'PaymentInstrument'"
        },
        {
          "name": "ReturnLineItemInput",
          "kind": "INPUT_OBJECT",
          "changeType": "modified",
          "breaking": false,
          "description": "Input field 'returnReasonDefinitionId' of type 'ID' was added to input object type 'ReturnLineItemInput'"
        },
        {
          "name": "ReturnLineItemInput",
          "kind": "INPUT_OBJECT",
          "changeType": "modified",
          "breaking": false,
          "description": "Input field 'ReturnLineItemInput.returnReason' changed type from 'ReturnReason!' to 'ReturnReason'"
        },
        {
          "name": "ReturnRequestLineItemInput",
          "kind": "INPUT_OBJECT",
          "changeType": "modified",
          "breaking": false,
          "description": "Input field 'returnReasonDefinitionId' of type 'ID' was added to input object type 'ReturnRequestLineItemInput'"
        },
        {
          "name": "ReturnRequestLineItemInput",
          "kind": "INPUT_OBJECT",
          "changeType": "modified",
          "breaking": false,
          "description": "Input field 'ReturnRequestLineItemInput.returnReason' changed type from 'ReturnReason!' to 'ReturnReason'"
        },
        {
          "name": "StoreCreditAccountCreditInput",
          "kind": "INPUT_OBJECT",
          "changeType": "modified",
          "breaking": false,
          "description": "Input field 'notify' of type 'Boolean' was added to input object type 'StoreCreditAccountCreditInput'"
        },
        {
          "name": "WebhookSubscriptionTopic",
          "kind": "ENUM",
          "changeType": "modified",
          "breaking": false,
          "description": "Enum value 'ORDERS_LINK_REQUESTED' was added to enum 'WebhookSubscriptionTopic'"
        }
      ],
      "queries": [],
      "mutations": [
        {
          "name": "bulkOperationRunMutation",
          "type": "Argument",
          "changeType": "modified",
          "description": "Argument 'groupObjects: Boolean!' was removed from field 'Mutation.bulkOperationRunMutation'",
          "breaking": true
        },
        {
          "name": "bulkOperationRunQuery",
          "type": "Description",
          "changeType": "modified",
          "description": "Description for argument 'groupObjects' on field 'Mutation.bulkOperationRunQuery' changed from 'Whether to group objects under their corresponding parent objects in the JSONL output. Grouping is costly, causes bulk operations to take longer to complete, and increases the chances of failures such as timeouts.' to 'Enables grouping objects directly under their corresponding parent objects in the JSONL output. Enabling grouping slows down bulk operations and increases the likelihood of timeouts. Only enable grouping if you depend on the grouped format.'",
          "breaking": false
        },
        {
          "name": "bulkOperationRunQuery",
          "type": "Default",
          "changeType": "modified",
          "description": "Default value for argument 'groupObjects' on field 'Mutation.bulkOperationRunQuery' changed from 'true' to 'false'",
          "breaking": false
        },
        {
          "name": "fulfillmentServiceCreate",
          "type": "Description",
          "changeType": "modified",
          "description": "Description for argument 'callbackUrl' on field 'Mutation.fulfillmentServiceCreate' changed from 'The URL to send requests for the fulfillment service.\n\nIf `callbackUrl` is provided ([optional as of API version \"2026-01\"](https://shopify.dev/changelog/fulfillment-service-callback-url-is-now-optional)), the following considerations apply:\n\n- Shopify queries the <code>callback_url/fetch_tracking_numbers</code> endpoint to retrieve tracking numbers\n    for orders, if `trackingSupport` is set to `true`.\n- Shopify queries the <code>callback_url/fetch_stock</code> endpoint to retrieve inventory levels,\n    if `inventoryManagement` is set to `true`.\n- Shopify uses the <code>callback_url/fulfillment_order_notification</code> endpoint to send\n    [fulfillment and cancellation requests](https://shopify.dev/apps/fulfillment/fulfillment-service-apps/manage-fulfillments#step-2-receive-fulfillment-requests-and-cancellations).' to 'The URL to send requests for the fulfillment service.\n\nIf `callbackUrl` is provided:\n- Shopify queries the <code>callback_url/fetch_tracking_numbers</code> endpoint to retrieve tracking numbers\n    for orders, if `trackingSupport` is set to `true`.\n- Shopify queries the <code>callback_url/fetch_stock</code> endpoint to retrieve inventory levels,\n    if `inventoryManagement` is set to `true`.\n- Shopify uses the <code>callback_url/fulfillment_order_notification</code> endpoint to send\n    [fulfillment and cancellation requests](https://shopify.dev/apps/fulfillment/fulfillment-service-apps/manage-fulfillments#step-2-receive-fulfillment-requests-and-cancellations).\n\nOtherwise, if no `callbackUrl` is provided you need to submit this information via the api:\n- For submitting tracking info and handling fulfillment requests, see our docs on [building for fulfillment services](https://shopify.dev/apps/build/orders-fulfillment/fulfillment-service-apps/build-for-fulfillment-services).\n- For managing inventory quantities, see our docs on [managing inventory quantities and states](https://shopify.dev/apps/build/orders-fulfillment/inventory-management-apps/manage-quantities-states).'",
          "breaking": false
        }
      ],
      "subscriptions": [],
      "enums": [
        {
          "name": "BillingAttemptUserErrorCode",
          "kind": "ENUM",
          "changeType": "modified",
          "breaking": false,
          "description": "Enum value 'THROTTLED' was added to enum 'BillingAttemptUserErrorCode'"
        },
        {
          "name": "WebhookSubscriptionTopic",
          "kind": "ENUM",
          "changeType": "modified",
          "breaking": false,
          "description": "Enum value 'ORDERS_LINK_REQUESTED' was added to enum 'WebhookSubscriptionTopic'"
        }
      ]
    }
  }
}