❗️
Before you can use this endpoint in Production environment, you must go through an approval process with our Compliance. Please contact compliance@coinify.com to get the process started.

🚧
Important:
We do not consider adding a new property to the Customer payload as a breaking change to the API. Please build your integration to allow for new properties to be added to this and other resources.

The customer resource is a JSON object. When calling the Customer API endpoints, you get the following response:

{
  "id": "2a2c8407-f7d2-49e6-9c8f-39f69a6e5644",
  "wallets": [
    {
      "type": "non_custodial",
      "id": "1382bc73-7887-4ada-8c55-17178b34dc17",
      "state": "unverified",
      "currency": "ETH",
      "address": "0x42cE19972118a6F59fcA1D7E13A09712E9C83884",
      "tag": null,
      "providerName": null,
      "createTime": "2025-08-04T09:06:09.667Z",
      "updateTime": "2025-08-04T09:06:09.667Z"
    },
    {
      "type": "custodial",
      "id": "e4f87f0c-1800-4e33-be19-4ca9c0d5c3b5",
      "state": "verified",
      "currency": null,
      "address": null,
      "tag": null,
      "providerName": "Binance",
      "createTime": "2025-08-04T09:06:55.225Z",
      "updateTime": "2025-08-04T09:06:55.225Z"
    }
  ]
}

Please find the descriptions of the Customer resource properties below:

id

The ID of the specific Customer in the Coinify system as returned in the response of the Create Customer API endpoint.

wallets

The wallets array of object provides the customer wallets which can be used when interacting with Coinify's products.

You can find the properties of the wallet object described in continuation:

Property	Type	Description
id	string	The ID of the wallet entry
type	string	The type of the wallet, currently supports `custodial` and `non_custodial`
state	string	The state of the wallet, currently supports `unverified` and `verified`
currency	string or null	The currency associated with the wallet
address	string or null	The address associated with the wallet
tag	string or null	Applicable for cryptocurrencies that support the concept of tag/memo etc.
providerName	string or null	The name of the wallet provider
createTime	string	The creation time of the wallet
updateTime	string	The update time of the wallet