GraphQL API Changes

The GraphQL API has been improved and extended in numerous ways. Here, we mainly highlight the changes that could potentially be breaking for existing API integrations.

The minor version bump to version 8.1.0 means that there are only absolutely minimal potentially breaking changes (see below). Instead, the main change in this version is the backwards-compatible introduction of filterable and sortable APIs in numerous queries.

New Filtering Support

Numerous APIs have gained a flexible (and optional) filter parameter with which to filter results. Please consult the documentation on the filter API and filter in the GUI for more information.

New Sorting Support

Numerous APIs have gained a flexible (and optional) sortOrder parameter with which to sort results. Please consult the documentation on the sorting API and sorting in the GUI for more information.

Changed Sort Order of Archived Transactions

In previous releases, the autod { txDetails } query would return transactions ordered by descending finalisation date if and only if ARCHIVED was passed as a status argument. Now, transactions are always ordered by descending creation date by default. Sorting by finalisation date can be achieved by passing a sortOrder: [{ property: FINALIZED_AT, order: DESCENDING }] argument (see immediately preceding section for more information).

Removal of deprecated items

  • The previously deprecated updateChainalysisRisk mutation on the AopdMutation type was removed. Please use the setProviderRiskScore mutation instead.
  • The isSanctioned field was removed from the TrpdOriginator type. This was never used.

Removal of some exotic assets

The following asset variants have been removed:

  • "BonkHoneyHNTMobileSOL (SOL) on Solana SOL" (DTI146FHT2GR) from both Asset and AopdAsset.
  • "TRON (TRX) on TRON TRX" (DTI523PVPHKS) from both Asset and AopdAsset. Note that this is not the native TRON asset, but a smart contract token.
  • "The Infinite Garden (ETH) on Ethereum Ether" (DTIQ6H1WK0Q0) from both Asset and AopdAsset.
  • "Celo native asset (CELO) on Celo" (DTI49F711L3G) from Asset.
  • "GOATs of Sui (SUI) on SUI" (DTI5MHZGR5F9) from Asset.
  • "Aptos (APT) on Aptos Token" (DTISMB9ZBCGN) from Asset.

Renames

  • The previously misspelled AOPD_RETIRGGER_RISK_SCORE variant on AutodAuditEvent has been corrected to AOPD_RETRIGGER_RISK_SCORE.
  • The TRPD_REGISTER_CUSTODIAL_USER variant on AutodAuditEvent has been renamed to AUTOD_REGISTER_CUSTODIAL_USER.
  • The TRPD_SET_WALLET_ADDRESS variant on AutodAuditEvent has been renamed to AUTOD_SET_WALLET_ADDRESS.
  • The TrpdIdentity type has been renamed to TravelIdentity.

New Deprecations

The following items have been deprecated and will be removed in a future release. Please consult the deprecation field for instructions on how to upgrade. Most of the new deprecations are related to the addition of flexible user-specified filter arguments that replace special-purpose filtered queries.

  • The following aopd queries: proof, proofAsXlsx, proofForAddress, proofForXpub and proofsForCustomer.
  • The following queries in autod: txDetail, txAsXlsx and txsWithTxId.
  • The vasp query in email.
  • The status argument to the following autod queries: txDetails, txDetailsCount and txsAsXlsx.
  • The msg input field in object AopdExpectedAoppProofInput.
  • The registerCustodialUser and setWalletAddress mutations on TrpdMutation.