Quiltt uses date-based API versioning. Breaking changes are only introduced in new versions, so your existing integration continues working until you explicitly upgrade. You can check your current version in the Quiltt Dashboard, where it appears as a version badge on each API key.

If you're upgrading across multiple versions (e.g. from 2024-01-01 to 2026-04-01), review the changes for each version in between.

Link to this section#How to Upgrade

1. Review the changes below for each version between your current version and the latest.

2. Test with a header override by setting the Quiltt-Version header in your API requests to use the new version:

Quiltt-Version: "2026-04-01"

3. Upgrade your API key in the Quiltt Dashboard. Navigate to the API Keys page and click the Upgrade API Version button on the key you want to move to the newer version, then select Upgrade to vX from the menu.

Link to this section#Version 2026-04-01

This version removes previously deprecated fields and arguments, and updates the Ntropy enrichment data model to V3.

Link to this section#Deprecated fields removed

If your queries reference any of these fields, update them before upgrading.

Link to this section#Deprecated arguments removed

Link to this section#Deprecated enum values removed

Link to this section#Deprecated subscriptions removed

Link to this section#Ntropy location type change

The location field on RemoteDataNtropyEnrichedTransaction changed from a plain String to a structured RemoteDataNtropyLocation object. If you only need the original string, use location.rawAddress. The new location.structured sub-object provides parsed address components:

Before (≤ 2025-04-01):

query {
  transactions {
    nodes {
      remoteData {
        ntropy {
          enrichment {
            location  # "123 Main St, New York, NY"
          }
        }
      }
    }
  }
}

After (2026-04-01):

query {
  transactions {
    nodes {
      remoteData {
        ntropy {
          enrichment {
            location {
              rawAddress  # "123 Main St, New York, NY"
              structured {
                street
                houseNumber
                city
                state
                postcode
                country
                countryCode
                storeNumber
                latitude
                longitude
                googleMapsUrl
                appleMapsUrl
              }
            }
          }
        }
      }
    }
  }
}

Link to this section#Ntropy V2 fields removed

The following fields on RemoteDataNtropyEnrichedTransaction are removed. Use the V3 equivalents:

Link to this section#Ntropy enrichment endpoint change

The Ntropy enrichment data in the REST API is returned under documents["api.ntropy.com"], keyed by endpoint path. In this version, the V2 path (/v2/transactions/{mode}) is removed for integrations enabled after April 1, 2026. Older integrations continue to receive both paths.

The document path and body structure differ between versions:

V2 path (/v2/transactions/{mode}):

{
  "documents": {
    "api.ntropy.com": {
      "/v2/transactions/{mode}": {
        "id": "xbx8YP14g565Xk",
        "timestamp": "2024-06-20T18:27:49Z",
        "body": {
          "transactionId": "xbx8YP14g565Xk",
          "merchant": "Starbucks",
          "merchantId": "d4bc3c80-ec1a-3da2-836e-2a4ca4758be5",
          "logo": "https://logos.ntropy.com/starbucks.com",
          "website": "starbucks.com",
          "mcc": [5814],
          "labels": ["coffee shop"],
          "location": "10 Union Square E, New York, NY 10003, United States",
          "locationStructured": {
            "address": "Union Square East",
            "city": "New York",
            "state": "New York",
            "postcode": "10003",
            "country": "US"
          }
        }
      }
    }
  }
}

V3 path (/v3/transactions):

{
  "documents": {
    "api.ntropy.com": {
      "/v3/transactions": {
        "id": "xbx8YP14g565Xk",
        "timestamp": "2024-06-20T18:27:49Z",
        "body": {
          "id": "xbx8YP14g565Xk",
          "entities": {
            "counterparty": {
              "id": "d4bc3c80-ec1a-3da2-836e-2a4ca4758be5",
              "name": "Starbucks",
              "logo": "https://logos.ntropy.com/starbucks.com",
              "website": "starbucks.com",
              "mccs": [5814],
              "type": "organization"
            }
          },
          "categories": {
            "general": "coffee shop"
          },
          "location": {
            "rawAddress": "10 Union Square E, New York, NY 10003, United States",
            "structured": {
              "street": "Union Square East",
              "city": "New York",
              "state": "New York",
              "postcode": "10003",
              "countryCode": "US",
              "country": "United States"
            }
          }
        }
      }
    }
  }
}

If your code accesses Ntropy data via the REST API, update it to read from the /v3/transactions path and use the nested body structure.

Link to this section#Version 2025-04-01

This version replaces the features field with products on Connections, using more descriptive enum values:

Link to this section#Product and Feature enum renames

If your queries use features, switch to products with the new values:

query {
  connections {
    # was: features returning [TRANSACTIONS, BALANCES]
    products  # now: [ACCOUNT_BALANCES_AND_TRANSACTIONS, ACCOUNT_BALANCE_REFRESHES]
  }
}

Link to this section#Version 2024-01-01

This is the oldest currently supported API version. If you're still on 2024-01-01, review the changes in each version above to plan your upgrade.