Customers > KYC and Verification
/
Get Customers With KYC For Review

Get Customers With KYC For Review

GET
https://api.vivamo.co/v1/customers/kyc-for-review

Retrieve all customers with KYC submissions in under_review status, awaiting your manual approval or rejection.

Response

List of customers awaiting KYC review.
    array
      externalCustomerId
      string
      The unique identifier of the customer as provided by your system.
      Examples:demo-user
      data
      object
      Customer profile fields. Only `email` is required — all other fields are collected during SDK flows where needed.
        email
        string
        Required
        Customer email address. Must not use a disposable domain or contain a `+` suffix.
        Examples:demo@vivamo.co
        phone
        string
        Customer mobile number in international format (e.g. `+15551234567`). Must be a valid mobile number — landlines and VOIP numbers are rejected. If provided without a `+` prefix and with at least 10 digits, `+1` (US) is prepended automatically. Recommended if available — customers without a phone number are prompted to enter one during the SDK flow.
        Examples:+15551234567
        firstName
        string
        Customer's first name.
        Examples:John
        lastName
        string
        Customer's last name.
        Examples:Smith
        street
        string
        Street address.
        Examples:123 42nd St
        street2
        string
        Additional street address (apartment, suite, etc.).
        Examples:Suite 42
        state
        string
        2-character state code for US addresses.
        Examples:NY
        city
        string
        City name.
        Examples:New York
        zip
        string
        ZIP or postal code.
        Examples:10001
        country
        string
        2-character ISO 3166 Alpha-2 country code.
        Examples:US
      kycVerifications
      array of object
      A KYC verification record for a customer.
        type
        string
        The type of verification. Currently, only `proof_of_id` is supported.
        Examples:proof_of_id
          proof_of_id
          string
        status
        string
        Current verification status.
        Examples:pending
          pending
          string
          verified
          string
          under_review
          string
          rejected
          string
          expired
          string
          verified_manually
          string
          rejected_manually
          string
        createdAt
        string
        Timestamp when the verification was initiated.
        Examples:2025-06-17T00:16:31.155Z
      createdAt
      string
      Timestamp when the customer record was created.
      Examples:2025-06-05T04:57:11.151Z
Built with