---
title: "Review a customer's identity results"
method: GET
path: "/v1/customers/{id}/review"
tags: ["Customers"]
---

# Review a customer's identity results

`GET /v1/customers/{id}/review`

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.

## Path parameters

- `id` string, uuid, required

## Headers

- `Straddle-Account-Id` string, uuid
- `Request-Id` string
- `Correlation-Id` string

## Response `200`

OK

- CustomerReviewV1ItemResponse
  - `meta` ResponseMetadata, required — Metadata about the API request, including an identifier and timestamp.
    - `api_request_id` string, uuid, required — Unique identifier for this API request, useful for troubleshooting.
    - `api_request_timestamp` string, date-time, required — Timestamp for this API request, useful for troubleshooting.
  - `response_type` 'object' | 'array' | 'error' | 'none', required — Indicates the structure of the returned content. - "object" means the `data` field contains a single JSON object. - "array" means the `data` field contains an array of objects. - "error" means the `data` field contains an error object with details of the issue. - "none" means no data is returned.
  - `data` CustomerReviewV1, required
    - `customer_details` CustomerV1, required
      - `id` string, uuid, required — Unique identifier for the customer.
      - `name` string, required — Full name of the individual or business name.
      - `type` 'individual' | 'business', required
      - `email` string, email, required — The customer's email address.
      - `phone` string, required — The customer's phone number in E.164 format.
      - `external_id` string, nullable — Unique identifier for the customer in your database, used for cross-referencing between Straddle and your systems.
      - `status` 'pending' | 'review' | 'verified' | 'inactive' | 'rejected', required
      - `created_at` string, date-time, required — Timestamp of when the customer record was created.
      - `updated_at` string, date-time, required — Timestamp of the most recent update to the customer record.
      - `address` AddressV11, nullable — An object containing the customer's address. This is optional, but if provided, all required fields must be present.
        - `address1` string, required — Primary address line (e.g., street, PO Box).
        - `address2` string, nullable — Secondary address line (e.g., apartment, suite, unit, or building).
        - `city` string, required — City, district, suburb, town, or village.
        - `state` string, required — Two-letter state code.
        - `zip` string, required — Zip or postal code.
      - `compliance_profile` union
        - object — PII required to trigger Patriot Act compliant KYC verification.
          - `dob` string, date, nullable, required — Masked date of birth in ****-**-** format.
          - `ssn` string, nullable, required — Masked Social Security Number in the format ***-**-****.
        - object — Business registration data required to trigger Patriot Act compliant KYB verification.
          - `ein` string, nullable, required — Masked Employer Identification Number in the format **-*******
          - `legal_business_name` string, nullable, required — The official registered name of the business. This name should be correlated with the `ein` value.
          - `website` string, uri, nullable — Official business website URL. Optional but recommended for enhanced KYB.
          - `representatives` RepresentativeV11[], nullable — A list of people related to the company. Only valid where customer type is 'business'.
            - `name` string, required
            - `email` string, nullable
            - `phone` string, nullable
      - `device` DeviceV1
        - `ip_address` string, ipv4, required — The customer's IP address at the time of profile creation. Use `0.0.0.0` to represent an offline customer registration.
      - `metadata` object, nullable — Up to 20 additional user-defined key-value pairs. Useful for storing additional information about the customer in a structured format.
      - `config` CustomerConfigurationV1
        - `sandbox_outcome` 'standard' | 'verified' | 'rejected' | 'review'
        - `processing_method` 'inline' | 'background' | 'skip'
    - `identity_details` CustomerIdentityV1
      - `review_id` string, uuid, required — Unique identifier for the review.
      - `decision` 'accept' | 'reject' | 'review', required
      - `messages` object, nullable — Dictionary of all messages from the customer verification process.
      - `breakdown` object, required — Detailed breakdown of the customer verification results, including decisions, risk scores, correlation score, and more.
        - `address` IdentityVerificationBreakdownV1
          - `decision` 'accept' | 'reject' | 'review'
          - `codes` string[], nullable — List of specific result codes from the fraud and risk screening.
          - `risk_score` number, double, nullable — Predicts the inherent risk associated with the customer for a given module. A higher score indicates a greater likelihood of fraud.
          - `correlation_score` number, double, nullable — Represents the strength of the correlation between provided and known information. A higher score indicates a stronger correlation.
          - `correlation` 'low_confidence' | 'potential_match' | 'likely_match' | 'high_confidence'
        - `email` IdentityVerificationBreakdownV1
          - `decision` 'accept' | 'reject' | 'review'
          - `codes` string[], nullable — List of specific result codes from the fraud and risk screening.
          - `risk_score` number, double, nullable — Predicts the inherent risk associated with the customer for a given module. A higher score indicates a greater likelihood of fraud.
          - `correlation_score` number, double, nullable — Represents the strength of the correlation between provided and known information. A higher score indicates a stronger correlation.
          - `correlation` 'low_confidence' | 'potential_match' | 'likely_match' | 'high_confidence'
        - `fraud` IdentityVerificationBreakdownV1
          - `decision` 'accept' | 'reject' | 'review'
          - `codes` string[], nullable — List of specific result codes from the fraud and risk screening.
          - `risk_score` number, double, nullable — Predicts the inherent risk associated with the customer for a given module. A higher score indicates a greater likelihood of fraud.
          - `correlation_score` number, double, nullable — Represents the strength of the correlation between provided and known information. A higher score indicates a stronger correlation.
          - `correlation` 'low_confidence' | 'potential_match' | 'likely_match' | 'high_confidence'
        - `phone` IdentityVerificationBreakdownV1
          - `decision` 'accept' | 'reject' | 'review'
          - `codes` string[], nullable — List of specific result codes from the fraud and risk screening.
          - `risk_score` number, double, nullable — Predicts the inherent risk associated with the customer for a given module. A higher score indicates a greater likelihood of fraud.
          - `correlation_score` number, double, nullable — Represents the strength of the correlation between provided and known information. A higher score indicates a stronger correlation.
          - `correlation` 'low_confidence' | 'potential_match' | 'likely_match' | 'high_confidence'
        - `synthetic` IdentityVerificationBreakdownV1
          - `decision` 'accept' | 'reject' | 'review'
          - `codes` string[], nullable — List of specific result codes from the fraud and risk screening.
          - `risk_score` number, double, nullable — Predicts the inherent risk associated with the customer for a given module. A higher score indicates a greater likelihood of fraud.
          - `correlation_score` number, double, nullable — Represents the strength of the correlation between provided and known information. A higher score indicates a stronger correlation.
          - `correlation` 'low_confidence' | 'potential_match' | 'likely_match' | 'high_confidence'
        - `business_identification` IdentityVerificationBreakdownV1
          - `decision` 'accept' | 'reject' | 'review'
          - `codes` string[], nullable — List of specific result codes from the fraud and risk screening.
          - `risk_score` number, double, nullable — Predicts the inherent risk associated with the customer for a given module. A higher score indicates a greater likelihood of fraud.
          - `correlation_score` number, double, nullable — Represents the strength of the correlation between provided and known information. A higher score indicates a stronger correlation.
          - `correlation` 'low_confidence' | 'potential_match' | 'likely_match' | 'high_confidence'
        - `business_validation` IdentityVerificationBreakdownV1
          - `decision` 'accept' | 'reject' | 'review'
          - `codes` string[], nullable — List of specific result codes from the fraud and risk screening.
          - `risk_score` number, double, nullable — Predicts the inherent risk associated with the customer for a given module. A higher score indicates a greater likelihood of fraud.
          - `correlation_score` number, double, nullable — Represents the strength of the correlation between provided and known information. A higher score indicates a stronger correlation.
          - `correlation` 'low_confidence' | 'potential_match' | 'likely_match' | 'high_confidence'
        - `business_evaluation` IdentityVerificationBreakdownV1
          - `decision` 'accept' | 'reject' | 'review'
          - `codes` string[], nullable — List of specific result codes from the fraud and risk screening.
          - `risk_score` number, double, nullable — Predicts the inherent risk associated with the customer for a given module. A higher score indicates a greater likelihood of fraud.
          - `correlation_score` number, double, nullable — Represents the strength of the correlation between provided and known information. A higher score indicates a stronger correlation.
          - `correlation` 'low_confidence' | 'potential_match' | 'likely_match' | 'high_confidence'
      - `network_alerts` IdentityVerificationAlertsV1
        - `decision` 'accept' | 'reject' | 'review'
        - `codes` string[], nullable — List of specific result codes from the consortium alert screening.
        - `alerts` string[], nullable — Any alerts or flags raised during the consortium alert screening.
      - `watch_list` IdentityVerificationWatchlistV1
        - `decision` 'accept' | 'reject' | 'review'
        - `codes` string[], nullable — Specific codes related to the Straddle watchlist screening results.
        - `matched` string[], nullable — Information about any matches found during screening.
        - `matches` IdentityVerificationWatchlistMatchV1[], nullable — Information about any matches found during screening.
          - `list_name` string, required — The name of the list the match was found.
          - `urls` string[], required — Relevent Urls to review.
          - `match_fields` string[], required — Data fields that matched.
          - `correlation` 'low_confidence' | 'potential_match' | 'likely_match' | 'high_confidence', required
      - `kyc` KnowYourCustomerV1
        - `decision` 'accept' | 'reject' | 'review'
        - `codes` string[], nullable — List of specific result codes from the KYC screening process.
        - `validations` object, required — Boolean values indicating the result of each validation in the KYC process.
          - `first_name` boolean
          - `last_name` boolean
          - `address` boolean
          - `city` boolean
          - `state` boolean
          - `zip` boolean
          - `phone` boolean
          - `dob` boolean
          - `ssn` boolean
          - `email` boolean
      - `created_at` string, date-time, required — Timestamp of when the review was initiated.
      - `updated_at` string, date-time, required — Timestamp of the most recent update to the review.
      - `reputation` IdentityVerificationReputationV1
        - `decision` 'accept' | 'reject' | 'review'
        - `codes` string[], nullable — Specific codes related to the Straddle reputation screening results.
        - `risk_score` number, double, nullable
        - `insights` IdentityVerificationReputationInsightsV1
          - `ach_fraud_transactions_count` integer, nullable
          - `ach_fraud_transactions_total_amount` number, double, nullable
          - `ach_fraud_transactions_dates` string[], nullable
          - `ach_returned_transactions_count` integer, nullable
          - `ach_returned_transactions_total_amount` number, double, nullable
          - `ach_returned_transactions_dates` string[], nullable
          - `card_fraud_transactions_count` integer, nullable
          - `card_fraud_transactions_total_amount` number, double, nullable
          - `card_fraud_transactions_dates` string[], nullable
          - `card_disputed_transactions_count` integer, nullable
          - `card_disputed_transactions_total_amount` number, double, nullable
          - `card_disputed_transactions_dates` string[], nullable
          - `card_stopped_transactions_count` integer, nullable
          - `card_stopped_transactions_dates` string[], nullable
          - `accounts_count` integer, nullable
          - `accounts_active_count` integer, nullable
          - `accounts_closed_count` integer, nullable
          - `accounts_closed_dates` string[], nullable
          - `accounts_fraud_count` integer, nullable
          - `accounts_fraud_loss_total_amount` number, double, nullable
          - `accounts_fraud_labeled_dates` string[], nullable
          - `applications_count` integer, nullable
          - `applications_dates` string[], nullable
          - `applications_approved_count` integer, nullable
          - `applications_declined_count` integer, nullable
          - `applications_fraud_count` integer, nullable
          - `user_institution_count` integer, nullable
          - `user_dob_count` integer, nullable
          - `user_mobile_count` integer, nullable
          - `user_email_count` integer, nullable
          - `user_address_count` integer, nullable
          - `user_active_profile_count` integer, nullable
          - `user_closed_profile_count` integer, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Failed
- `500` — Server Error

---

[API](https://skmtc.net/straddleio/apis/straddle-api.md) · [All operations](https://skmtc.net/straddleio/apis/straddle-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/straddleio/straddle-api/versions/6e13cd88cda9/schema)