Skip to main content
GET
/
v1
/
saved-searches
/
{id}
Get Saved Search
curl --request GET \
  --url https://api.example.com/v1/saved-searches/{id}
{
  "id": "<string>",
  "object": "<string>",
  "name": "<string>",
  "description": "<string>",
  "query": {},
  "metadata": {},
  "last_executed_at": "<string>",
  "result_count": 123,
  "created_at": "<string>",
  "updated_at": "<string>"
}

Overview

Returns the full saved search record, including the stored query, metadata, and last execution stats. Requires the portfolios:manage scope.

Path Parameters

id
string
required
Saved search UUID.

Response

id
string
Saved search UUID.
object
string
Always saved_search.
name
string
Saved search name.
description
string
Optional description.
query
object
Stored search query (same shape as POST /v1/trademarks/search body).
metadata
object
Key-value metadata.
last_executed_at
string
ISO 8601 timestamp of the last execution.
result_count
integer
Result count from the last execution.
created_at
string
ISO 8601 creation timestamp.
updated_at
string
ISO 8601 last-updated timestamp.

Code Examples

curl "https://api.signa.so/v1/saved-searches/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer sig_live_YOUR_KEY_HERE"

Errors

StatusTypeDescription
400validation_errorInvalid UUID format
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks portfolios:manage
404not_foundSaved search does not exist or belongs to another org