# Check a login for suspicious behaviour

**POST /login/check**




## Servers
- https://loginllama.app/api/v1: https://loginllama.app/api/v1 ()



## Parameters



### Body: application/json (object)
Login request to check for suspicious behaviour
- **ip_address** (string(ip))

- **user_agent** (string)

- **identity_key** (string)
  Your user identity key - not an email
- **email_address** (string)
  The customers email address, for sending login notification emails.
- **geo_country** (string)
  The country the person should be logging in from. If not provided, it is taken from the IP address.
- **geo_city** (string)
  The city the person should be logging in from. If not provided, it is taken from the IP address.
- **user_time_of_day** (string)
  The time of day from the customer. This can be passed by doing new Date().toString()


## Responses
### 200
Login check succeeded

#### Body: application/json (object)
- **status** (string)

- **message** (string)

- **codes** (array[string])


### 400
Login check invalid

#### Body: application/json (object)
- **status** (string)

- **message** (string)

- **code** (array[string])
  Array of error codes

### 401
Invalid API key

#### Body: application/json (object)
- **error** (string)


### 402
Payment required. You have reached your API usage quota.

#### Body: application/json (object)
- **error** (string)



[Powered by Bump.sh](https://bump.sh)