GET
Get server logs

Authorizations

api-key
string
header
required

Per-project server key, prefixed sk_live_. Full access to every endpoint. Keep it on your backend: never ship it in a game binary.

Path Parameters

instance_id
string
required

Server instance identifier.

Example:

"abc123"

Query Parameters

limit
integer
default:100

Maximum number of log lines to return.

Required range: 1 <= x <= 1000
since
string<date-time>

Only return log lines at or after this timestamp.

Example:

"2026-09-21T14:00:00Z"

until
string<date-time>

Only return log lines before this timestamp.

Example:

"2026-09-21T15:00:00Z"

level
enum<string>

Only return log lines at exactly this level.

Available options:
info,
warn,
error

Case-insensitive substring filter applied to the log message. % and _ are matched literally.

Maximum string length: 200
Example:

"port 7777"

cursor
string

Pagination cursor. Pass next_token from a previous response to page towards newer lines, or older_token to page towards older lines.

Example:

"cursor_abc"

Response

A page of log lines.

Cursor-paginated logs, oldest line first. next_token pages towards newer lines, older_token towards older lines. Both are absent when no more lines exist in that direction. For live output use the SSE stream instead of polling.

data
object[]
required
retention_days
integer
required

How many days lines are kept. Older lines are deleted and never returned.

Example:

3

next_token
string
Example:

"bnwyMDI2LTA5LTIxVDE0OjAwOjAwLjEyMzQ1Nlp8MTA0Mg"

older_token
string
Example:

"b3wyMDI2LTA5LTIxVDE0OjAwOjAwLjEyMzQ1Nlp8MTA0Mg"

log_cap
object

Present when a log cap stopped Simpl storing this server's output within the retention window: the server's cap (25,000 lines or 5 MiB over its life) or the project's daily cap (250 MiB per UTC day). Lines the game printed after at (until until, for the daily cap) were not stored.