Skip to main content
GET
/
telemetry
/
projects
/
{projectId}
/
logs
Query logs for a project
curl --request GET \
  --url https://api.specular.dev/telemetry/projects/{projectId}/logs \
  --header 'Authorization: Bearer <token>'
{
  "logs": [
    {
      "timestamp": "2023-11-07T05:31:56Z",
      "traceId": "<string>",
      "spanId": "<string>",
      "severityText": "<string>",
      "severityNumber": 123,
      "body": "<string>",
      "attributes": {
        "req": {},
        "res": {}
      }
    }
  ],
  "total": 123,
  "limit": 123,
  "offset": 123
}

Authorizations

Authorization
string
header
required

Bearer authentication with API key (format: Bearer sk_xxx)

Path Parameters

projectId
string
required

Project ID

Query Parameters

branchId
string

Branch ID. If omitted, returns production logs.

startTime
string<date-time>

Start of time range (ISO 8601). Defaults to 24 hours ago.

endTime
string<date-time>

End of time range (ISO 8601). Defaults to now.

limit
integer
default:100

Maximum number of logs to return (1-1000)

Required range: 1 <= x <= 1000
offset
integer
default:0

Number of logs to skip

Required range: x >= 0
severity
enum<string>

Filter by severity level

Available options:
TRACE,
DEBUG,
INFO,
WARN,
ERROR,
FATAL

Response

Logs retrieved successfully

Logs retrieved successfully

logs
object[]
total
integer

Total number of matching logs

limit
integer
offset
integer