cURL
curl --request GET \
--header 'Authorization: Bearer YOUR_SECRET_API_KEY' \
--url https://sandbox.straddle.com/v1/customers/<uuid>/review{
"meta": {
"api_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"api_request_timestamp": "2023-11-07T05:31:56Z"
},
"data": {
"customer_details": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Ron Swanson",
"email": "[email protected]",
"phone": "+12128675309",
"status": "verified",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"external_id": "<string>",
"address": {
"address1": "123 Main St",
"city": "Anytown",
"state": "CA",
"zip": "12345",
"address2": "Apt 1"
},
"compliance_profile": {
"dob": "****-**-**",
"ssn": "***-**-****"
},
"device": {
"ip_address": "192.168.1.1"
},
"metadata": {},
"config": {}
},
"identity_details": {
"review_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"breakdown": {
"address": {
"codes": [
"<string>"
],
"risk_score": 123,
"correlation_score": 123
},
"email": {
"codes": [
"<string>"
],
"risk_score": 123,
"correlation_score": 123
},
"fraud": {
"codes": [
"<string>"
],
"risk_score": 123,
"correlation_score": 123
},
"phone": {
"codes": [
"<string>"
],
"risk_score": 123,
"correlation_score": 123
},
"synthetic": {
"codes": [
"<string>"
],
"risk_score": 123,
"correlation_score": 123
},
"business_identification": {
"codes": [
"<string>"
],
"risk_score": 123,
"correlation_score": 123
},
"business_validation": {
"codes": [
"<string>"
],
"risk_score": 123,
"correlation_score": 123
},
"business_evaluation": {
"codes": [
"<string>"
],
"risk_score": 123,
"correlation_score": 123
}
},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"messages": {},
"network_alerts": {
"codes": [
"<string>"
],
"alerts": [
"<string>"
]
},
"watch_list": {
"codes": [
"<string>"
],
"matched": [
"<string>"
],
"matches": [
{
"list_name": "<string>",
"urls": [
"<string>"
],
"match_fields": [
"<string>"
]
}
]
},
"kyc": {
"validations": {
"first_name": true,
"last_name": true,
"address": true,
"city": true,
"state": true,
"zip": true,
"phone": true,
"dob": true,
"ssn": true,
"email": true
},
"codes": [
"<string>"
]
},
"reputation": {
"codes": [
"<string>"
],
"risk_score": 123,
"insights": {
"ach_fraud_transactions_count": 123,
"ach_fraud_transactions_total_amount": 123,
"ach_fraud_transactions_dates": [
"2023-12-25"
],
"ach_returned_transactions_count": 123,
"ach_returned_transactions_total_amount": 123,
"ach_returned_transactions_dates": [
"2023-12-25"
],
"card_fraud_transactions_count": 123,
"card_fraud_transactions_total_amount": 123,
"card_fraud_transactions_dates": [
"2023-12-25"
],
"card_disputed_transactions_count": 123,
"card_disputed_transactions_total_amount": 123,
"card_disputed_transactions_dates": [
"2023-12-25"
],
"card_stopped_transactions_count": 123,
"card_stopped_transactions_dates": [
"2023-12-25"
],
"accounts_count": 123,
"accounts_active_count": 123,
"accounts_closed_count": 123,
"accounts_closed_dates": [
"2023-12-25"
],
"accounts_fraud_count": 123,
"accounts_fraud_loss_total_amount": 123,
"accounts_fraud_labeled_dates": [
"2023-12-25"
],
"applications_count": 123,
"applications_dates": [
"2023-12-25"
],
"applications_approved_count": 123,
"applications_declined_count": 123,
"applications_fraud_count": 123,
"user_institution_count": 123,
"user_dob_count": 123,
"user_mobile_count": 123,
"user_email_count": 123,
"user_address_count": 123,
"user_active_profile_count": 123,
"user_closed_profile_count": 123
}
}
}
}
}Customers
Review a customer
Retrieves and analyzes the results of a customer’s identity validation and fraud score. This endpoint provides a comprehensive breakdown of the validation outcome, including:
- Risk and correlation scores
- Reason codes for the decision
- Results of watchlist screening
- Any network alerts detected Use this endpoint to gain insights into the verification process and make informed decisions about customer onboarding.
GET
/
v1
/
customers
/
{id}
/
review
cURL
curl --request GET \
--header 'Authorization: Bearer YOUR_SECRET_API_KEY' \
--url https://sandbox.straddle.com/v1/customers/<uuid>/review{
"meta": {
"api_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"api_request_timestamp": "2023-11-07T05:31:56Z"
},
"data": {
"customer_details": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "Ron Swanson",
"email": "[email protected]",
"phone": "+12128675309",
"status": "verified",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"external_id": "<string>",
"address": {
"address1": "123 Main St",
"city": "Anytown",
"state": "CA",
"zip": "12345",
"address2": "Apt 1"
},
"compliance_profile": {
"dob": "****-**-**",
"ssn": "***-**-****"
},
"device": {
"ip_address": "192.168.1.1"
},
"metadata": {},
"config": {}
},
"identity_details": {
"review_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"breakdown": {
"address": {
"codes": [
"<string>"
],
"risk_score": 123,
"correlation_score": 123
},
"email": {
"codes": [
"<string>"
],
"risk_score": 123,
"correlation_score": 123
},
"fraud": {
"codes": [
"<string>"
],
"risk_score": 123,
"correlation_score": 123
},
"phone": {
"codes": [
"<string>"
],
"risk_score": 123,
"correlation_score": 123
},
"synthetic": {
"codes": [
"<string>"
],
"risk_score": 123,
"correlation_score": 123
},
"business_identification": {
"codes": [
"<string>"
],
"risk_score": 123,
"correlation_score": 123
},
"business_validation": {
"codes": [
"<string>"
],
"risk_score": 123,
"correlation_score": 123
},
"business_evaluation": {
"codes": [
"<string>"
],
"risk_score": 123,
"correlation_score": 123
}
},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"messages": {},
"network_alerts": {
"codes": [
"<string>"
],
"alerts": [
"<string>"
]
},
"watch_list": {
"codes": [
"<string>"
],
"matched": [
"<string>"
],
"matches": [
{
"list_name": "<string>",
"urls": [
"<string>"
],
"match_fields": [
"<string>"
]
}
]
},
"kyc": {
"validations": {
"first_name": true,
"last_name": true,
"address": true,
"city": true,
"state": true,
"zip": true,
"phone": true,
"dob": true,
"ssn": true,
"email": true
},
"codes": [
"<string>"
]
},
"reputation": {
"codes": [
"<string>"
],
"risk_score": 123,
"insights": {
"ach_fraud_transactions_count": 123,
"ach_fraud_transactions_total_amount": 123,
"ach_fraud_transactions_dates": [
"2023-12-25"
],
"ach_returned_transactions_count": 123,
"ach_returned_transactions_total_amount": 123,
"ach_returned_transactions_dates": [
"2023-12-25"
],
"card_fraud_transactions_count": 123,
"card_fraud_transactions_total_amount": 123,
"card_fraud_transactions_dates": [
"2023-12-25"
],
"card_disputed_transactions_count": 123,
"card_disputed_transactions_total_amount": 123,
"card_disputed_transactions_dates": [
"2023-12-25"
],
"card_stopped_transactions_count": 123,
"card_stopped_transactions_dates": [
"2023-12-25"
],
"accounts_count": 123,
"accounts_active_count": 123,
"accounts_closed_count": 123,
"accounts_closed_dates": [
"2023-12-25"
],
"accounts_fraud_count": 123,
"accounts_fraud_loss_total_amount": 123,
"accounts_fraud_labeled_dates": [
"2023-12-25"
],
"applications_count": 123,
"applications_dates": [
"2023-12-25"
],
"applications_approved_count": 123,
"applications_declined_count": 123,
"applications_fraud_count": 123,
"user_institution_count": 123,
"user_dob_count": 123,
"user_mobile_count": 123,
"user_email_count": 123,
"user_address_count": 123,
"user_active_profile_count": 123,
"user_closed_profile_count": 123
}
}
}
}
}Authorizations
Use your Straddle API Key in the Authorization header as Bearer to authorize API requests.
Headers
For use by platforms to specify an account id and set scope of a request.
Optional client generated identifier to trace and debug a request.
Optional client generated identifier to trace and debug a series of requests.
Path Parameters
Response
OK
Metadata about the API request, including an identifier and timestamp.
Show child attributes
Show child attributes
Indicates the structure of the returned content.
- "object" means the
datafield contains a single JSON object. - "array" means the
datafield contains an array of objects. - "error" means the
datafield contains an error object with details of the issue. - "none" means no data is returned.
Available options:
object, array, error, none Show child attributes
Show child attributes
Was this page helpful?
⌘I