Skip to main content
GET
/
projects
/
{project_reference}
/
logs
Query Project Logs
curl --request GET \
  --url https://api.veryfront.com/projects/{project_reference}/logs \
  --header 'Authorization: Bearer <token>'
{
  "entries": [
    {
      "timestamp": "<string>",
      "level": "<string>",
      "message": "<string>",
      "service": "<string>",
      "trace_id": "<string>",
      "request_id": "<string>",
      "metadata": {}
    }
  ],
  "next_cursor": "<string>",
  "stats": {
    "bytes_processed": 123,
    "lines_processed": 123,
    "query_time_ms": 123
  }
}

Authorizations

Authorization
string
header
required

Authentication via JWT token or API key. JWT: Get from Veryfront dashboard. API Key: Format "vf__" - create via /api-keys endpoint.

Path Parameters

project_reference
string
required

Project ID or slug

Query Parameters

start
string<date-time>

Start time (ISO 8601). Defaults to 1 hour ago.

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 — newest first)

Available options:
forward,
backward
level
enum<string>

Filter by log level

Available options:
error,
warn,
info,
debug

Free-text search within log messages

Maximum string length: 200

Response

Log query results

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