Close Customer Account

post

https://{corename}.risk.{env}.gpsrv.com/ivs/2.0/closeCustomer

Use the Close Customer endpoint to terminate a customer's account and halt all associated identity-verification processes.

Body Params

requestTs

date-time

required

The date and time when the customer closure request was initiated in Galileo System Time, formatted as an ISO 8601 string.
Pattern: ISO 8601 format
Example: 2025-01-01T00:00:00

riskServiceId

string

required

Galileo-issued identifier that specifies the IVS configuration strategy assigned during IVS setup.
Pattern: Max 50 characters
Example: EPRP-test-1231231:1` or `GCORE:1:2:3

providerId

string

required

The Galileo-issued identifier for the IVS provider.
Pattern: Max 10 digits
Example: 1234567890

customerId

string

Galileo-generated ID 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 string
Example: 789XYZ2025

ivsProfileId

string

The third-party provider supplies this identifier to reference the account status across other endpoints.
Pattern: Alphanumeric string
Example: 22262843

reasonId

string

enum

required

The reason code for closing the application:

61 — Applicant requested
62 — Abandoned
63 — Terminated by provider
Pattern: "61", "62", or "63"
Example: 61

Allowed:

Headers

authorization

string

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

X-Request-Id

string

Unique identifier for the request

Responses

200Successful Response

400Bad Request

401Unauthorized

403Forbidden

404Not Found

503Service Unavailable