# Verify User Exists

<mark style="color:blue;">`GET`</mark> /v3/user-exists

## Request

The details below help you form your HTTP requests to this endpoint.

### Query

You may provide query parameters to filter the output.

<table><thead><tr><th>Name</th><th>Type</th><th data-type="checkbox">Required</th><th>Description</th></tr></thead><tbody><tr><td>email</td><td>string</td><td>true</td><td>N/A</td></tr></tbody></table>

## Response

The details below help you understand the responses you could get from this endpoint.

### Samples

Below are samples of responses, with tabs corresponding to returned status code.

{% tabs %}
{% tab title="200" %}

```javascript
{
    "data": {
        "userId": "1234-asdf-4321-fdsa",
        "exists": true
    }
}
```

{% endtab %}

{% tab title="400" %}

```javascript
{
    "error": {
        "statusCode": 400,
        "code": "UserAlreadyExists",
        "message": "User already exists with email ex@example.com",
        "data": {}
    }
}
```

{% endtab %}
{% endtabs %}

### Schema

The response's schema is outlined below.

<table><thead><tr><th>Name</th><th>Type</th><th data-type="checkbox">Required</th><th>Description</th></tr></thead><tbody><tr><td>data</td><td>object</td><td>false</td><td>N/A</td></tr><tr><td>data.userId</td><td>string</td><td>true</td><td>User Id</td></tr><tr><td>data.exists</td><td>boolean</td><td>true</td><td>Determines if the user exists or not</td></tr></tbody></table>