# User Status

##  Retrieve User Status

<mark style="color:green;">`POST`</mark> `https://dcams.app/v3/stable/user/status`

This endpoint allows you to get the status of the user.&#x20;

#### Request Body

| Name  | Type   | Description              |
| ----- | ------ | ------------------------ |
| user  | string | Veratad API Username     |
| pass  | string | Veratad API Password     |
| email | string | The user's email address |

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

```javascript
{
    "fn": "TIM",
    "ln": "SMITH",
    "addr": "123 MAIN ST",
    "city": "STRATFORD",
    "state": "CT",
    "zip": "06614",
    "dob": "19870203",
    "email": "test15847@veratad.com",
    "reference": "12344",
    "status": "PENDING",
    "additionalData": {
        "value_1": "rangers",
        "value_2": "test2"
    },
    "dcams_plus": {
        "document_data": {
            "FirstName": "STEVE",
            "LastName": "JONES",
            "MiddleName": "JIM",
            "Address": "123 MAIN ST",
            "City": "STRATFORD",
            "State": "CT",
            "Zip": "06614",
            "DateOfBirth": "19630203",
            "Height": "5-03",
            "Sex": "M",
            "EyeColor": "BRO",
            "DocumentNumber": "D485995948833",
            "IssueDate": "20190812",
            "ExpirationDate": "20230203"
        },
        "confirmation": 93239228,
        "action": "PENDING",
        "detail": "MORE INFORMATION IS REQUIRED",
        "issues": [
            "LAST NAME DOES NOT MATCH DOCUMENT",
            "DOB DOES NOT MATCH DOCUMENT",
            "FIRST NAME DOES NOT MATCH DOCUMENT"
        ]
    },
    "documents": null,
    "found": true
}
```

{% endtab %}

{% tab title="400 Missing a required input" %}

```
{
    "result": "Error",
    "message": "Missing a required input"
}
```

{% endtab %}

{% tab title="401 Bad login" %}

```
{
    "result": "Error",
    "message": "Either your username or password is incorrect",
}
```

{% endtab %}

{% tab title="404 User not found" %}

```javascript
{
    "fn": null,
    "ln": null,
    "addr": null,
    "city": null,
    "state": null,
    "zip": null,
    "dob": null,
    "email": null,
    "reference": null,
    "status": null,
    "additionalData": false,
    "dcams_plus": {
        "document_data": false,
        "confirmation": 0,
        "action": null,
        "detail": null,
        "issues": false
    },
    "documents": null,
    "found": false
}
```

{% endtab %}
{% endtabs %}

#### Request Body

```javascript
{
	"user": "USERNAME",
	"pass": "PASSWORD", 
	"email": "test15847@veratad.com"
}
```

{% hint style="info" %}
**NOTE:** After 2 hours certain elements will be purged. This includes:&#x20;

* fn&#x20;
* ln&#x20;
* addr
* city
* state
* zio
* dob
* dcams\_plus.document\_data

This does not apply if you have storage active.&#x20;
{% endhint %}