Skip to content
API status
API reference

List account logins

GET
/api/v1/management/servers/{serverId}/accounts/{accountNumber}/logins
curl --request GET \
  --url 'https://api.koneth.com/api/v1/management/servers/6be9a699-2f28-402e-b64e-93ba6bdafe1b/accounts/7001042/logins?page=1&limit=20' \
  --header 'Authorization: <Authorization>' \
  --header 'X-Request-Id: onboarding-client-1042'

Returns the login monitor log for one trading account: every accepted and rejected terminal sign-in, newest first, with the client IP address, the resolved country, and the device that signed in.

Entries are recorded by the server that hosts the account, including sign-ins that resume a saved session. Use this to investigate shared, resold, or automated account access. Requires accounts:read.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
serverId
required
string format: uuid

UUID of a trading server owned by your organization.

Example
6be9a699-2f28-402e-b64e-93ba6bdafe1b
accountNumber
required
string
>= 4 characters <= 32 characters /^[A-Za-z0-9_-]+$/

Trading account number.

Example
7001042

Header Parameters

Section titled “Header Parameters”
X-Request-Id
string

Optional correlation ID used for API request billing and logs.

Example
onboarding-client-1042

Query Parameters

Section titled “Query Parameters”
page
integer
default: 1 >= 1

One-based page number.

limit
integer
default: 20 >= 1 <= 100

Maximum records returned on one page.

Responses

Section titled “Responses”

200

Section titled “200”

Login page returned.

Media typeapplication/json
object
logins
required
Array<object>
object
id
required
string
accountNumber
required
string
outcome
required
string
Allowed values: succeeded failed
accessMode
One of:
string
Allowed values: trade read_only
ipAddress
One of:
string
countryCode
One of:
string
>= 2 characters <= 2 characters
userAgent
One of:
string
deviceId
One of:
string
deviceName
One of:
string
devicePlatform
One of:
string
appVersion
One of:
string
failureReason
One of:
string
resumed

True when the terminal signed in with a saved session.

boolean
occurredAt
required
string format: date-time
key
additional properties
any
pagination
required
object
page
required
integer
>= 1
limit
required
integer
>= 1 <= 100
total
required
integer
totalPages
required
integer
Example
{
  "logins": [
    {
      "outcome": "succeeded",
      "accessMode": "trade",
      "deviceName": "ios Version 18.2 (Build 22C152)",
      "devicePlatform": "ios",
      "appVersion": "1.0.0+1"
    }
  ]
}

400

Section titled “400”

Invalid request.

Media typeapplication/json
object
error
required
string
issues

Validation issue details when the request fails schema validation.

Array<object>
object
key
additional properties
any
Examplegenerated
{
  "error": "example",
  "issues": [
    {}
  ]
}

401

Section titled “401”

Management API authentication is missing or invalid.

Media typeapplication/json
object
error
required
string
issues

Validation issue details when the request fails schema validation.

Array<object>
object
key
additional properties
any
Example
{
  "error": "Management API authentication required"
}

402

Section titled “402”

The organization cannot cover the active API request price.

Media typeapplication/json
object
error
required
string
issues

Validation issue details when the request fails schema validation.

Array<object>
object
key
additional properties
any
Example
{
  "error": "Insufficient API credits"
}

403

Section titled “403”

The key lacks the required scope or server access.

Media typeapplication/json
object
error
required
string
issues

Validation issue details when the request fails schema validation.

Array<object>
object
key
additional properties
any
Example
{
  "error": "Missing API scope: accounts:read"
}

404

Section titled “404”

The requested resource was not found.

Media typeapplication/json
object
error
required
string
issues

Validation issue details when the request fails schema validation.

Array<object>
object
key
additional properties
any
Examplegenerated
{
  "error": "example",
  "issues": [
    {}
  ]
}

500

Section titled “500”

Unexpected server error.

Media typeapplication/json
object
error
required
string
issues

Validation issue details when the request fails schema validation.

Array<object>
object
key
additional properties
any
Example
{
  "error": "Internal server error"
}