Get customer verified address
Returns the address on file for a customer. For individual customers, this is extracted from KYC verification data (proof of address). For corporate customers, this is the stored business address. This address is automatically used when creating a first-party withdrawal bank without providing an address.
Returns the address on file for a customer. For individual customers, this is extracted from KYC verification data (proof of address). For corporate customers, this is the stored business address. This address is automatically used when creating a first-party withdrawal bank without providing an address.
Authorization
bearerAuth Organization API key obtained from PropelAuth
In: header
Path Parameters
The unique identifier of the customer
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
curl 'https://compose.finance/api/v2/customers/{customerId}/kyc/address' \ -H 'Authorization: Bearer YOUR_API_KEY'{
"addressLine1": "Friedrichstrasse 123",
"city": "Berlin",
"country": "DE",
"postalCode": "10117"
}{
"error": "Unauthorized - Invalid or missing API key or session"
}{
"error": "Customer KYC verification must be completed before retrieving address"
}{
"error": "Customer not found"
}{
"error": "Failed to fetch KYC data. Please try again later."
}Update customer developer fees PATCH
Updates the developer fee configuration for the customer. These fees are deducted from customer deposits before USDC is sent to their wallet. **Fee Types** - `developerSpreadFeeBps`: Spread fee in basis points (0-2500, max 25%). Applied to the USDC amount. **Fee Calculation** ``` spreadFee = amount × spreadFeeBps / 10000 customerReceives = amount - spreadFee ``` **Example:** 1000 USDC deposit with 1% spread (100 bps) → customer receives 990 USDC
Initiate customer KYC POST
Generates a KYC verification link for a customer. The link can be used to start the identity verification process.