Account Defender APIAccount Info

Get account info v1

Access the attack status and risk score of an account on your application.

This endpoint will be deprecated in a few months. We recommend transitioning to our v2 Account Info API

Path parameters

account_idstringRequired
ID for an account

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

attack_typeslist of enumsOptional
The type(s) of attack(s) to check for on the account. * If the parameter is not sent, then all available attack types will be checked. The returned response will be based on your available attack types. * If two `attack_types` are sent, then the response will prioritize returning the attack with a **Pending** status. * If both are **Pending**, then the response will return the attack with the higher risk score. * Otherwise, the response will return the **Resolved** or **Archived** attack with the highest risk score. For example, if the account has a **Pending** attack with a risk score of 60 and an **Archived** attack with a risk score of 100, then the response will return the Pending attack.
Allowed values:

Response

Success
account_idstring or null
The ID for the account.
is_under_attackboolean or null
The status for the attack corresponding to the statuses displayed in the **Account Defender** portal. `true` corresponds to **Pending** attacks. `false` corresponds to: * **Resolved** or **Archived** attacks * The account does not exist * The account exists, but was never under attack.
is_manually_createdboolean or null

Whether the account was manually changed to be under attack. This response is only returned if the value is true.

risk_scoreinteger or null>=0<=100
The risk score for the attack.
existsboolean or null
Whether the requested account exists.

Errors