Skip to content
API status
API reference

List account orders

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

Returns a newest-first page of orders for one trading account, including creation and execution timestamps when available. Requires accounts:read.

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
X-Request-Id
string

Optional correlation ID used for API request billing and logs.

Example
onboarding-client-1042
page
integer
default: 1 >= 1

One-based page number.

limit
integer
default: 20 >= 1 <= 100

Maximum records returned on one page.

Order page returned.

Media typeapplication/json
object
orders
required
Array<object>

Order record. Execution time is distinct from order creation time.

object
id
string
symbol
string
side
string
orderType
string
volume
number
status
string
createdAt

Date and time the order record was created, not webhook delivery time.

string format: date-time
executedAt
One of:
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
Examplegenerated
{
"orders": [
{
"id": "example",
"symbol": "example",
"side": "example",
"orderType": "example",
"volume": 1,
"status": "example",
"createdAt": "2026-04-15T12:00:00Z",
"executedAt": "2026-04-15T12:00:00Z"
}
],
"pagination": {
"page": 1,
"limit": 1,
"total": 1,
"totalPages": 1
}
}

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": [
{}
]
}

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

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

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

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": [
{}
]
}

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