BizKitHub
DocsAPI ReferenceAccount/bff/account/audit-login-attempts
getAccountAdmin BFF

/bff/account/audit-login-attempts

Returns audit log of login attempts for the authenticated user with geo/threat context. Same row shape as /bff/contact/detail-login-attempts so the same UI grid can render both.

AccountgetBffAccountAudit-login-attempts

Parameters

No parameters required

This endpoint takes no path, query, header or body parameters.

Response schema

1 status code documented

200Success
currentIpstringRequired

IP address of the current request.

currentLocationstringRequired

Resolved location string for the current request.

itemCountnumberRequired

Total number of login attempts.

itemsobject[]Required
Each array item:
idstringRequired

Masked attempt identifier.

committedbooleanRequired

True if the attempt succeeded and issued a session.

riskScorenumberRequired

Risk score computed at the moment of the attempt (0 = clean, 100 = maximum).

Range: 0–100
insertedDatestringRequired

Absolute date the attempt was made.

relativeDatestringRequired

Human-relative date (e.g. "3 hours ago").

ipstringRequired

IP address the attempt came from (may be empty for legacy rows).

hostnamestringOptional

Reverse-DNS hostname of the IP, if resolved.

citystringOptional

City resolved from GeoIP.

countrystringOptional

ISO country code resolved from GeoIP.

countryRegionstringOptional

Region/state code resolved from GeoIP.

asnstringOptional

Autonomous System Number of the network owning the IP.

asnOrganizationstringOptional

Organisation owning the ASN (e.g. Cloudflare).

ispstringOptional

ISP name from the GeoIP database.

mobilebooleanRequired

True if the IP belongs to a mobile carrier.

proxybooleanRequired

True if the IP is a known anonymising proxy.

hostingbooleanRequired

True if the IP belongs to a hosting/cloud provider.

torbooleanRequired

True if the IP is a known Tor exit node.

Response example

application/json
{
  "currentIp": "example_currentIp",
  "currentLocation": "example_currentLocation",
  "itemCount": 0,
  "items": [
    {
      "id": "example_id",
      "committed": false,
      "riskScore": 0,
      "insertedDate": "example_insertedDate",
      "relativeDate": "example_relativeDate",
      "ip": "example_ip",
      "hostname": "example_hostname",
      "city": "example_city",
      "country": "example_country",
      "countryRegion": "example_countryRegion",
      "asn": "example_asn",
      "asnOrganization": "example_asnOrganization",
      "isp": "example_isp",
      "mobile": false,
      "proxy": false,
      "hosting": false,
      "tor": false
    }
  ]
}

Request example

GET /bff/account/audit-login-attempts

get
curl -X GET "https://api.bizkithub.com/bff/account/audit-login-attempts" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key