Skip to main content
GET
/
v1
/
saved-searches
List Saved Searches
curl --request GET \
  --url https://api.example.com/v1/saved-searches
{
  "object": "list",
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "object": "saved_search",
      "name": "Nike clearance watch",
      "description": "Apparel marks similar to NIKE",
      "query": { "query": "nike", "filters": { "nice_classes": [18, 25] } },
      "metadata": { "team": "brand-protection" },
      "last_executed_at": "2026-04-09T18:12:00Z",
      "result_count": 142,
      "created_at": "2026-03-01T10:00:00Z",
      "updated_at": "2026-04-09T18:12:00Z"
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "request_id": "req_xyz"
}

​
Overview

Returns a paginated list of saved searches owned by the calling organization. Requires the portfolios:manage scope.

​
Query Parameters

​
limit
integer
default:"20"
Page size (1-100).
​
cursor
string
Pagination cursor from a previous response.

​
Response

​
data
object[]
Array of saved search records. See Get Saved Search for the field list.
{
  "object": "list",
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "object": "saved_search",
      "name": "Nike clearance watch",
      "description": "Apparel marks similar to NIKE",
      "query": { "query": "nike", "filters": { "nice_classes": [18, 25] } },
      "metadata": { "team": "brand-protection" },
      "last_executed_at": "2026-04-09T18:12:00Z",
      "result_count": 142,
      "created_at": "2026-03-01T10:00:00Z",
      "updated_at": "2026-04-09T18:12:00Z"
    }
  ],
  "has_more": false,
  "pagination": { "cursor": null },
  "request_id": "req_xyz"
}

​
Code Examples

curl "https://api.signa.so/v1/saved-searches?limit=20" \
  -H "Authorization: Bearer sig_live_YOUR_KEY_HERE"

​
Errors

StatusTypeDescription
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks portfolios:manage