---
title: "Close Customer Account"
method: POST
path: "/ivs/2.0/closeCustomer"
tags: ["IVS"]
---

# Close Customer Account

`POST /ivs/2.0/closeCustomer`

## Request

- Base URL: `{corename}.risk.{env}.gpsrv.com`
- URL: `{corename}.risk.{env}.gpsrv.com/ivs/2.0/closeCustomer`
- Auth: none declared

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

## Headers

- `authorization` string
- `X-Request-Id` string

## Request body

- object
  - `requestTs` string, date-time, required: The date and time when the customer closure request was initiated in <a href="ref:system-time" target="_blank">our system time</a>, formatted as an ISO 8601 string. Pattern: ISO 8601 date-time (YYYY-MM-DDTHH:MM:SS) Example: `2025-01-01T00:00:00`
  - `riskServiceId` string, 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` or `GCORE:1:2:3``
  - `providerId` string, required: The system-generated identifier for the IVS provider. Pattern: Up to 10 digits Example: `1234567890`
  - `customerId` string: 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`
  - `ivsProfileId` string: The third-party provider supplies this identifier to reference the account status across other endpoints. Pattern: Numeric characters only Example: `22262843`
  - `reasonId` '61' | '62' | '63', required: The reason code for closing the application: * `61` — Applicant requested * `62` — Abandoned * `63` — Terminated by provider Pattern: `61`, `62`, or `63` Example: `61`

## Response `200`

Successful Response

- object: Successful Response
  - `customerId` string: 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.
  - `ivsProfileId` string: Identifier for the IVS profile. Use this ID to reference the account's status in other endpoint requests. This identifier is supplied by the third-party provider, not SoFi Tech Solutions.
  - `date` string, date-time: Date-time when the customer account was officially closed.
  - `status` string: The condition of the customer account following the closure request: `COMPLETE`, `REFERRED`, `AWAITING RESPONSE`, or `IN PROGRESS`.
  - `decision` string: The final decision applied to the customer account upon closure: `DECLINE` or `CLOSE`. This field is returned only when verification is complete.
  - `riskServiceId` string, required: System-generated identifier that specifies the IVS configuration strategy assigned during IVS setup.
  - `systemTs` string, date-time, required: Date-time when the system generated this response in <a href="ref:system-time" target="_blank">our system time</a>, formatted as an ISO 8601 string.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `429`: Too Many Requests
- `500`: Internal Service Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/galileo-ft/apis/risk-api-2-0.md) - [All operations](https://skmtc.dev/galileo-ft/apis/risk-api-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo-ft/apis/risk-api-2-0/revisions/cdc4ada03981?raw)