IVS

Verify Customer

Use the Verify Customer endpoint to perform identity verification for individual or business customers and their associated entities. This endpoint validates customer information, including personal details, addresses, and identification documents. For businesses, a single customer profile can support the verification of multiple associated entities (e.g., directors or beneficial owners).

post/ivs/2.0/verifyCustomer

Request

Base URL
{corename}.risk.{env}.gpsrv.com
URL
{corename}.risk.{env}.gpsrv.com/ivs/2.0/verifyCustomer
Auth
none declared

Headers

authorizationstring

Example:Basic eW91cl9hcGlsb2dpbjp5b3VyX2FwaXRyYW5za2V5

Basic authentication token (base64-encoded {apilogin}:{apitranskey} credentials provided by SoFi Tech Solutions)

X-Request-Idstring

Example:1234567890

Unique identifier for the request

Request body

providerIdstring required

The system-generated identifier for the IVS provider. Pattern: Up to 10 digits Example: "9999"

customerType'Person' | 'Business' required

Specifies the category of customer undergoing verification. Pattern: Person or Business Example: Person

customerIdstring required

ID generated by you or SoFi Tech Solutions for the top-level customer (person or business) undergoing verification. Use this to correlate this event with the specific customer record in your system. Pattern: Alphanumeric identifier Example: 789XYZ2025

eventTsstring date-time required

Timestamp for when the verification event occurred. Pattern: ISO 8601 date-time (YYYY-MM-DDTHH:MM:SS) Example: 2025-01-01T00:00:00

riskServiceIdstring required

System-generated identifier that specifies the IVS configuration strategy assigned during IVS setup. Pattern: EPRP or GCORE prefix followed by colon-separated identifiers, up to 50 characters Example: EPRP-test-1231231:1

prodIdstring required

The product ID of the account. Pattern: One or more digits Example: 9999

Example request

{
  "providerId": "\"9999\"",
  "customerType": "Person",
  "customerId": "789XYZ2025",
  "eventTs": "2025-01-01T00:00:00",
  "riskServiceId": "`EPRP-test-1231231:1`",
  "prodId": "9999",
  "persons": [
    {
      "entityId": "789XYZ2025",
      "role": "APPLICANT",
      "firstName": "John",
      "middleName": "M",
      "lastName": "Doe",
      "dateOfBirth": "1990-01-01",
      "residentialAddress": {
        "address1": "123 Main Street",
        "address2": "Apt 4B",
        "city": "New York",
        "state": "NY",
        "zipCode": "10001",
        "countryCode": "USA"
      },
      "ssn": "123456789",
      "nationalIdentificationType": "passport",
      "nationalIdentificationNumber": "A12345678",
      "countryOfIssuance": "USA",
      "phone": "+12125551234",
      "email": "john.doe@example.com",
      "edda1": "Answer text",
      "edda2": "Answer text",
      "edda3": "Answer text",
      "edda4": "Answer text",
      "edda5": "Answer text"
    }
  ],
  "business": {
    "entityId": "789XYZ2025",
    "businessLegalName": "Acme Corporation",
    "businessDBA": "Acme Co",
    "businessLegalStructure": "LLC",
    "businessRegAddress": {
      "businessRegAddress": "456 Business Blvd",
      "businessRegAddress2": "Suite 200",
      "businessRegCity": "San Francisco",
      "businessRegState": "CA",
      "businessRegZip": "94105",
      "businessRegCountryCode": "USA"
    },
    "companyMailingAddress": {
      "businessMailingAddress": "456 Business Blvd",
      "businessMailingAddress2": "Suite 200",
      "businessMailingCity": "San Francisco",
      "businessMailingState": "CA",
      "businessMailingZip": "94105",
      "businessMailingCountryCode": "USA"
    },
    "businessDateOfIncorporation": "2010-01-01",
    "businessTaxId": "123456789",
    "businessSPDateOfBirth": "1980-01-01",
    "thirdPartyOwnershipStructure": "Private",
    "thirdPartyBusinessActivities": "Software development",
    "thirdPartyBusinessTenure": "5 years",
    "businessWebsite": "https://www.acmecorp.com",
    "businessParentLegalName": "Acme Holdings Inc",
    "businessParentRegState": "DE",
    "businessParentRegCountry": "USA",
    "phone": "+14155551234",
    "email": "contact@acmecorp.com",
    "edda1": "Answer text",
    "edda2": "Answer text",
    "edda3": "Answer text",
    "edda4": "Answer text",
    "edda5": "Answer text"
  }
}

Response

Successful Response

ivsProfileIdinteger

The third-party provider supplies this identifier to reference the account status across other endpoints.

customerIdstring required

ID generated by you or SoFi Tech Solutions for the customer undergoing verification. Use this to correlate this event with the specific entity record in your system.

customerTypestring required

Specifies the category of customer undergoing verification: Person or Business.

riskServiceIdstring required

System-generated identifier that specifies the IVS configuration strategy assigned during IVS setup.

customerStatusstring

Overall status of the customer identity-verification process.

customerDecisionstring

Final decision for identity verification. The system returns this field only when the verification is complete.

customerVerificationResult'Pass' | 'Fail' | 'Refer' | 'In Progress'

Derived identity verification result based on the customer_status and customer_decision.

Changes

No recorded changes to this operation across all 1 revision of this API.