---
title: "Changes to List saved contacts"
method: GET
path: "/contacts"
---

# Changes to List saved contacts

`GET /contacts`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 17 revisions.

- **2026-11-12** `299a3aa6f521`: 2 warning, 29 info
- **2026-10-23** `a02795de2d2b`: 12 warning, 7 info
- **2026-10-20** `19eb00e9f258`: 1 info
- **2026-10-20** `bd6c9d69540e`: 1 warning
- **2026-10-20** `19eb00e9f258`: 1 info
- **2026-09-20** `2febbf154d5b`: 8 warning, 2 info
- **2026-09-19** `5e65a1e72e42`: 2 warning, 8 info
- **2026-09-18** `17c058e61d91`: 9 info
- **2026-09-18** `606e4be0d601`: 4 warning, 4 info
- **2026-09-18** `795d8fc8f2af`: 1 info

## Changes

- **2026-11-12** `299a3aa6f521`: 2 warning, 29 info
  - added the new `FDIC_EUR` enum value to the `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/destinationAccount/anyOf[subschema #1: AccountKey]/` response property for the response status `200`
  - added the new `verification_not_applicable` enum value to the `error/code` response property for the response status `422`
  - added `#/components/schemas/BankAddress-Output` to the `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/bankAddress` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/IntermediaryBank-Output` to the `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/intermediaryBank` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/UserAddress-Output` to the `items/items/address` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/UserAddress-Output` to the `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/holder/address` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/BankAddress` from the `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/bankAddress` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/IntermediaryBank` from the `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/intermediaryBank` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/UserAddress` from the `items/items/address` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/UserAddress` from the `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/holder/address` response property `anyOf` list for the response status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/fields/accountKind` became required for the status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/fields/accountNumber` became required for the status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/fields/bic` became required for the status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/fields/branchNumber` became required for the status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/fields/financialInstitutionId` became required for the status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/fields/iban` became required for the status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/fields/paymentKey` became required for the status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/fields/phoneNumber` became required for the status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/fields/pixKey` became required for the status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/fields/pixKeyType` became required for the status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/fields/routingNumber` became required for the status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/holder/address` became required for the status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/holder/businessName` became required for the status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/holder/firstName` became required for the status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/holder/idNumber` became required for the status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/holder/idType` became required for the status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/holder/lastName` became required for the status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/holder/nationality` became required for the status `200`
  - the response property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/holder/taxId` became required for the status `200`
  - removed the `phone_required` enum value from the `error/code` response property for the response status `422`
  - removed the `rail_requirements_unmet` enum value from the `error/code` response property for the response status `422`
- **2026-10-23** `a02795de2d2b`: 12 warning, 7 info
  - deleted the `header` request parameter `x-api-key`
  - added the new `KYC_CARDS` enum value to the `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/destinationAccount/anyOf[subschema #1: AccountKey]/` response property for the response status `200`
  - added the new `RD` enum value to the `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/destinationAccount/anyOf[subschema #1: AccountKey]/` response property for the response status `200`
  - added the new `USDC_ARB` enum value to the `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/destinationAccount/anyOf[subschema #1: AccountKey]/` response property for the response status `200`
  - added the new `client_already_linked` enum value to the `error/code` response property for the response status `422`
  - added the new `kyb_documents_processing` enum value to the `error/code` response property for the response status `422`
  - added the new `link_code_expired` enum value to the `error/code` response property for the response status `422`
  - added the new `link_code_invalid` enum value to the `error/code` response property for the response status `422`
  - added the new `payout_not_awaiting_signature` enum value to the `error/code` response property for the response status `422`
  - added the new `redirect_uri_not_allowed` enum value to the `error/code` response property for the response status `422`
  - added the new `sandbox_amount_limit_exceeded` enum value to the `error/code` response property for the response status `422`
  - added the new `sandbox_faucet_balance_too_high` enum value to the `error/code` response property for the response status `422`
  - added the optional property `items/items/icon` to the response with the `200` status
  - added the optional property `items/items/lastUsedAt` to the response with the `200` status
  - removed the `client_policy_not_enabled` enum value from the `error/code` response property for the response status `422`
  - removed the `client_request_conflict` enum value from the `error/code` response property for the response status `422`
  - removed the `email_in_use` enum value from the `error/code` response property for the response status `422`
  - removed the `integrator_inactive` enum value from the `error/code` response property for the response status `422`
  - removed the `name_in_use` enum value from the `error/code` response property for the response status `422`
- **2026-10-20** `19eb00e9f258`: 1 info
  - removed the `phone_in_use` enum value from the `error/code` response property for the response status `422`
- **2026-10-20** `bd6c9d69540e`: 1 warning
  - added the new `phone_in_use` enum value to the `error/code` response property for the response status `422`
- **2026-10-20** `19eb00e9f258`: 1 info
  - removed the `document_fields_missing` enum value from the `error/code` response property for the response status `422`
- **2026-09-20** `2febbf154d5b`: 8 warning, 2 info
  - added the new `account_not_supported` enum value to the `error/code` response property for the response status `422`
  - added the new `account_unavailable` enum value to the `error/code` response property for the response status `422`
  - added the new `client_policy_not_enabled` enum value to the `error/code` response property for the response status `422`
  - added the new `intent_not_signable` enum value to the `error/code` response property for the response status `422`
  - added the new `swap_not_confirmable` enum value to the `error/code` response property for the response status `422`
  - added the new `swap_not_found` enum value to the `error/code` response property for the response status `422`
  - added the new `swap_route_unavailable` enum value to the `error/code` response property for the response status `422`
  - added the new `transfer_policy_denied` enum value to the `error/code` response property for the response status `422`
  - added `#/components/schemas/AccountKey` to the `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/destinationAccount` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/BalanceAccount` from the `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/destinationAccount` response property `anyOf` list for the response status `200`
- **2026-09-19** `5e65a1e72e42`: 2 warning, 8 info
  - removed the optional property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/settlementToken` from the response with the `200` status
  - added the new `payment_slot_consumed` enum value to the `error/code` response property for the response status `422`
  - added the optional property `items/items/bank/anyOf[subschema #1: ContactPaymentAccountView]/destinationAccount` to the response with the `200` status
  - added the optional property `items/items/user` to the response with the `200` status
  - added the optional property `items/items/userId` to the response with the `200` status
  - removed the `contact_requires_quote` enum value from the `error/code` response property for the response status `422`
  - removed the `direct_transfer_unsupported` enum value from the `error/code` response property for the response status `422`
  - removed the `funding_attempts_exhausted` enum value from the `error/code` response property for the response status `422`
  - removed the `funding_state_unknown` enum value from the `error/code` response property for the response status `422`
  - removed the `self_transfer` enum value from the `error/code` response property for the response status `422`
- **2026-09-18** `17c058e61d91`: 9 info
  - api operation id `listContacts` removed and replaced with `list_contacts_contacts_get`
  - the endpoint scheme security `HTTPBearer` was added to the API
  - the endpoint scheme security `bearerAuth` was removed from the API
  - api tag `contacts` added
  - api tag `Contacts` removed
  - added the new optional `header` request parameter `x-api-key`
  - added the non-success response with the status `422`
  - added `#/components/schemas/ContactPaymentAccountView` to the `items/items/bank` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/Requisite-Output` from the `items/items/bank` response property `anyOf` list for the response status `200`
- **2026-09-18** `606e4be0d601`: 4 warning, 4 info
  - added the new `recipient_chain_unsupported` enum value to the `error/code` response property for the response status `4XX`
  - added the new `recipient_chain_unsupported` enum value to the `error/code` response property for the response status `5XX`
  - added the new `recipient_token_unsupported` enum value to the `error/code` response property for the response status `4XX`
  - added the new `recipient_token_unsupported` enum value to the `error/code` response property for the response status `5XX`
  - removed the `recipient_requires_quote` enum value from the `error/code` response property for the response status `4XX`
  - removed the `recipient_requires_quote` enum value from the `error/code` response property for the response status `5XX`
  - removed the `settlement_token_unsupported` enum value from the `error/code` response property for the response status `4XX`
  - removed the `settlement_token_unsupported` enum value from the `error/code` response property for the response status `5XX`
- **2026-09-18** `795d8fc8f2af`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/hevn-inc/apis/hevn-api/docs/contacts/get.md) - [API](https://skmtc.dev/hevn-inc/apis/hevn-api.md) - [Page](https://skmtc.dev/hevn-inc/apis/hevn-api/changes/contacts/get)
