Customers

Identify who holds a destination wallet

Records who holds a wallet the customer sent crypto to: the customer's own self-hosted wallet (with the ownership attestation), or the customer's account at an exchange. OZAV asks for it with a requirement.due webhook (reason: destination_unidentified) and a documents_due item with purpose: travel_rule; answering closes that item. You can also send it before being asked. The identification applies to every send of the customer to the same wallet. It does not allow or block any send.

post/customers/{customer_id}/destination-identifications

Request

Base URL
https://developers.ozav.io/v2
Auth
- API key in header X-API-Key
- or HTTP bearer

Path parameters

customer_idstring required

Request body

chainstring required

The network of the address, with the name the send used (e.g. tron, ethereum, solana). Any other spelling is refused with 422, because it would never match the send.

addressstring required

The destination address. EVM addresses are matched case-insensitively.

wallet_type'self_custodied' | 'external' required

self_custodied - the customer's own wallet (holds the keys). external - the customer's account at an exchange.

wallet_attested_ownership_atstring date-time

Required with self_custodied - when the customer attested owning the wallet. Must not be in the future.

Example request

{
  "chain": "tron",
  "address": "TGssfnTouNs2H9AYPRkeZo9zuRxTPB5KCq"
}

Response

The identification, as recorded.

object'destination_identification' required

Resource type discriminator; always destination_identification.

customer_idstring required

The ozav_cus_ id of the customer.

chainstring required

The network, lowercase.

addressstring required

The address as stored (EVM in lowercase).

wallet_type'self_custodied' | 'external' required

Who holds the wallet.

wallet_attested_ownership_atstring date-time nullable

Present with self_custodied.

declared_atstring date-time nullable required

When the identification was recorded.

requirement_satisfiedboolean

Only on the create response - true when it answered an open destination_unidentified item of the customer.

Changes

No recorded changes to this operation across all 1 revision of this API.