Monitor logins across a server

GET

/api/v1/management/servers/{serverId}/logins

curl --request GET \
  --url 'https://api.koneth.com/api/v1/management/servers/6be9a699-2f28-402e-b64e-93ba6bdafe1b/logins?outcome=all&limit=100' \
  --header 'Authorization: <Authorization>' \
  --header 'X-Request-Id: onboarding-client-1042'

• Production
• Local development

Returns recent logins for every account on one server, newest first, including rejected attempts. The feed is kept in Koneth Main rather than on the server, so it survives independently of the account’s own data. Requires accounts:read.

Authorizations

• managementKey

Parameters

Path Parameters

serverId

required

string format: uuid

UUID of a trading server owned by your organization.

Example

6be9a699-2f28-402e-b64e-93ba6bdafe1b

Header Parameters

X-Request-Id

string

Optional correlation ID used for API request billing and logs.

Example

onboarding-client-1042

Query Parameters

accountNumber

string

<= 32 characters

Restrict the feed to one trading account.

outcome

string

default: all

Allowed values: all succeeded failed

Restrict the feed to accepted or rejected attempts.

since

string format: date-time

Only return attempts recorded at or after this timestamp.

limit

integer

default: 100 >= 1 <= 500

Maximum entries returned.

Responses

200

Login feed 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

string

Allowed values: trade read_only

null

null

ipAddress

One of:

string

string

null

null

countryCode

One of:

string

string

>= 2 characters <= 2 characters

null

null

userAgent

One of:

string

string

null

null

deviceId

One of:

string

string

null

null

deviceName

One of:

string

string

null

null

devicePlatform

One of:

string

string

null

null

appVersion

One of:

string

string

null

null

failureReason

One of:

string

string

null

null

resumed

True when the terminal signed in with a saved session.

boolean

occurredAt

required

string format: date-time

key

additional properties

any

Example

{
  "logins": [
    {
      "outcome": "succeeded",
      "accessMode": "trade",
      "deviceName": "ios Version 18.2 (Build 22C152)",
      "devicePlatform": "ios",
      "appVersion": "1.0.0+1"
    }
  ]
}

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

Example^generated

{
  "error": "example",
  "issues": [
    {}
  ]
}

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

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

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

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

Example^generated

{
  "error": "example",
  "issues": [
    {}
  ]
}

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"
}