Skip to main content
GET
Query project logs

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Path Parameters

project_reference
string
required

Project slug, UUID, or domain that identifies the project.

Query Parameters

start
string<date-time>

Start time (ISO 8601). Defaults to 1 hour ago. Logs are kept for 31 days and one query spans at most 30 days; an older start or a wider range returns 400.

end
string<date-time>

End time (ISO 8601). Defaults to now.

cursor
string

Pagination cursor from a previous response (next_cursor).

limit
number
default:100

Max entries to return (default: 100, max: 1000)

Required range: 1 <= x <= 1000
direction
enum<string>
default:backward

Sort order (default: backward, with newest first)

Available options:
forward,
backward
sort_by
enum<string>

Sort field. Defaults to "timestamp".

Available options:
timestamp
sort_order
enum<string>

Sort order. Defaults to "desc". When provided, overrides the legacy direction parameter.

Available options:
asc,
desc
level
enum<string>

Filter by log level

Available options:
error,
warn,
info,
debug

Free-text search over the fields each entry shows

Maximum string length: 200
service
enum<string>

Filter by service: veryfront-server, veryfront-api or veryfront-proxy.

Available options:
veryfront-server,
veryfront-api,
veryfront-proxy
trace_id
string

Filter by exact trace ID to correlate logs with a distributed trace.

Required string length: 1 - 64
Pattern: ^[A-Za-z0-9._-]+$
request_id
string

Filter by exact request ID.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9._-]+$
run_id
string

Filter by exact run ID to see every service line that belongs to one run.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9._-]+$

Response

Log query results

entries
object[]
required
next_cursor
string | null
required
stats
object
required