Get a verification
Status and outcome of a verification by its ID. Identity data is not included.
merchantApiKeymerchantTimestampmerchantNoncemerchantSignatureX-API-KEY<token>Merchant API key (starts with upk_, also accepts api-key); signing headers are also required
X-Timestamp<token>Unix timestamp in seconds, within 300 seconds of server time
X-Nonce<token>Unique per request; cannot be reused with the same credential during the timestamp validity window
X-Signature<token>Hex HMAC-SHA256 signature (either letter case) of the method, full path, timestamp, nonce and body digest
verificationId*stringVerification ID (starts with cvr_)
Verification
application/json- response
id*stringVerification ID (starts with cvr_)
customer_id*stringCustomer ID (starts with cus_)
usage*VerificationUsageVerification usage, which determines the provider that runs it. The usage must be enabled for the merchant (configured by UPP; test is off by default, the others are on):
| usage | Notes |
|---|---|
| test | Development and testing only |
| basic | Returns a hosted verification link |
| kyc | Part of the profile flow: also creates the profile; contact_email is required when the customer has no email; the result has no document images |
| bank_account | Used before applying for virtual accounts at some banks: required when the virtual_account profile's document is not an ID card or passport; start it after the virtual_account profile is approved, otherwise 422; the result has no document images |
"test""basic""kyc""bank_account"status*CustomerVerificationStatuspending waiting for the customer or the review, approved approved, rejected rejected
"pending""approved""rejected"rejection_reason*|Rejection reason, only when rejected
verified_at*|Approval time, only when approved
date-timecreated_at*stringdate-timeupdated_at*stringdate-timecurl -X GET 'https://sandbox.getupp.net/api/v1/customer-verifications/string'{ "id": "cvr_01m5eadct0b1padtfy5g1h9z1w", "customer_id": "cus_01m5ead2k7knsqfa65tpt1an6r", "usage": "test", "status": "approved", "rejection_reason": null, "verified_at": "2026-10-21T04:09:51.000000Z", "created_at": "2026-10-21T04:09:51.000000Z", "updated_at": "2026-10-21T04:09:51.000000Z"}