List Request Logs

List API request logs for the organization

GET /v1/organization/logs

List Request Logs

cURL

curl --request GET \
  --url https://api.signa.so/v1/organization/logs \
  --header 'Authorization: Bearer <token>'

{
  "object": "list",
  "data": [
    {
      "id": "req_01HXYZ...",
      "object": "request_log",
      "method": "GET",
      "path": "/v1/trademarks",
      "status_code": 200,
      "duration_ms": 142,
      "endpoint_type": "search",
      "billed_units": 1,
      "api_key_prefix": "sig_7kMn",
      "error_type": null,
      "error_detail": null,
      "created_at": "2026-04-18T10:12:33Z"
    },
    {
      "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"
    }
  ],
  "has_more": true,
  "pagination": {
    "cursor": "eyJpZCI6I..."
  },
  "request_id": "req_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 paginated list of API request logs for the authenticated organization. Filterable by date range, HTTP status code, success/failure outcome, method, API key, endpoint type, and path. Per-plan access control limits the historical window:

Plan	Retention window
free	Last 7 days
starter	Last 30 days
beta, pro, enterprise	Last 90 days

Requires the billing:read scope. Querying logs does not consume metered usage.

Query Parameters

start_date · string

Start of date range (ISO 8601). Accepts YYYY-MM-DD or full ISO datetime. Defaults to 24 hours ago.

end_date · string

End of date range (ISO 8601). Accepts YYYY-MM-DD or full ISO datetime. Defaults to now.

from · string

Alias for start_date. If both are sent, start_date wins.

to · string

Alias for end_date. If both are sent, end_date wins.

status_code · integer

Filter to a specific HTTP status code (100—599).

success · boolean

Filter by outcome: true returns succeeded requests (status < 400), false returns failed requests (status >= 400).

method · string

Filter by HTTP method (GET, POST, PATCH, DELETE, etc.).

api_key_id · string

Filter to requests made with a specific API key (key_...).

endpoint_type · string

Filter by classified endpoint type. One of search, read, monitoring, screening, clearance, check, image_search, export, reference, utility.

search · string

Case-insensitive substring match against path or request ID (max 200 characters).

limit · integer · default: "50"

Items per page (1—100).

cursor · string

Pagination cursor from a previous response.

Response

object · string

Always "list".

data · object[]

Show Request log object

id · string

The logged request’s identifier (req_...).

object · string

Always "request_log".

method · string

HTTP method (GET, POST, etc.).

path · string

Request path (e.g. /v1/trademarks).

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 (null if the request predates prefix capture).

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.

has_more · boolean

Whether more pages are available.

pagination · object

Show Pagination

cursor · string

Cursor for the next page (null if this is the last page).

{
  "object": "list",
  "data": [
    {
      "id": "req_01HXYZ...",
      "object": "request_log",
      "method": "GET",
      "path": "/v1/trademarks",
      "status_code": 200,
      "duration_ms": 142,
      "endpoint_type": "search",
      "billed_units": 1,
      "api_key_prefix": "sig_7kMn",
      "error_type": null,
      "error_detail": null,
      "created_at": "2026-04-18T10:12:33Z"
    },
    {
      "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"
    }
  ],
  "has_more": true,
  "pagination": {
    "cursor": "eyJpZCI6I..."
  },
  "request_id": "req_currentCall"
}

Code Examples

cURL

curl "https://api.signa.so/v1/organization/logs?limit=50&status_code=429" \
  -H "Authorization: Bearer sig_xxxxxxxxxxxx"

Errors

Status	Type	Description
400	validation_error	Invalid date format or start_date > end_date
401	unauthorized	Missing or invalid API key
403	forbidden	API key lacks billing:read
403	plan_limit_exceeded	Requested window exceeds your plan’s log retention
429	rate_limited	Too many requests

Related Endpoints

• Get Request Log — single request log detail
• Get Usage Summary — aggregate usage by day, endpoint type, or API key