Skip to main content
GET
/
v1
/
organization
/
logs
/
{request_id}
Get Request Log
curl --request GET \
  --url https://api.signa.so/v1/organization/logs/{request_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "req_01HXYA...",
  "object": "request_log",
  "method": "GET",
  "path": "/v1/trademarks/tm_bogus",
  "status_code": 404,
  "duration_ms": 18,
  "endpoint_type": "read",
  "billed_units": 0,
  "api_key_prefix": "sig_7kMn",
  "error_type": "not_found",
  "error_detail": "Trademark tm_bogus does not exist.",
  "created_at": "2026-04-18T10:11:05Z",
  "request_id": "req_01HXYZ_currentCall"
}
Beta. The request logs schema is new and may evolve. Field names should be stable, but we reserve the right to add fields or adjust response shape before general availability.

​
Overview

Returns a single request log entry by its request_id. Useful for looking up the full context of a request when a caller reports an error and includes the request_id header. Per-plan access control limits how far back you can retrieve logs:
PlanRetention window
freeLast 7 days
starterLast 30 days
beta, pro, enterpriseLast 90 days
Requires the billing:read scope.

​
Path Parameters

​
request_id
string
required
Request identifier from the X-Request-Id response header (e.g. req_01HXYZ...).

​
Response

​
id
string
The logged request’s identifier (matches the request_id path parameter).
​
object
string
Always "request_log".
​
method
string
HTTP method.
​
path
string
Request path.
​
status_code
integer
HTTP status code returned.
​
duration_ms
integer
Request duration in milliseconds.
​
endpoint_type
string
Classified endpoint type (e.g. search, read, utility).
​
billed_units
integer
Units billed against your plan for this request.
​
api_key_prefix
string
Prefix of the API key used.
​
error_type
string
Error type slug (null on success).
​
error_detail
string
Error detail message (null on success).
​
created_at
string
ISO timestamp when the request was logged.
​
request_id
string
The request ID of this lookup call (per the standard envelope convention). To identify the logged request being retrieved, use the top-level id field.
{
  "id": "req_01HXYA...",
  "object": "request_log",
  "method": "GET",
  "path": "/v1/trademarks/tm_bogus",
  "status_code": 404,
  "duration_ms": 18,
  "endpoint_type": "read",
  "billed_units": 0,
  "api_key_prefix": "sig_7kMn",
  "error_type": "not_found",
  "error_detail": "Trademark tm_bogus does not exist.",
  "created_at": "2026-04-18T10:11:05Z",
  "request_id": "req_01HXYZ_currentCall"
}

​
Code Examples

curl "https://api.signa.so/v1/organization/logs/req_01HXYA..." \
  -H "Authorization: Bearer sig_xxxxxxxxxxxx"

​
Errors

StatusTypeDescription
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks billing:read
404not_foundRequest log does not exist, belongs to another org, or is outside your plan’s retention window