Saved Searches

List Saved Searches

Changed on

Retrieves saved searches for the authenticated team (paginated). Results are capped at limit (default and maximum 1000). When more records exist than are returned, meta.total exceeds data.length; clients with large collections must page with limit/offset to retrieve them all.

get/api/v2/saved-searches

Request

  • Base URL
    / (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/v2/saved-searches
  • Auth
    HTTP bearer

Query parameters

limitinteger

Maximum number of saved searches to return.

offsetinteger

Number of saved searches to skip before returning results.

Response

Successfully retrieved saved searches

Example response

{
  "data": [
    {
      "id": "507f1f77bcf86cd799439011",
      "name": "Production Errors",
      "sourceId": "507f1f77bcf86cd799439012",
      "select": "Timestamp, ServiceName, Body",
      "where": "SeverityText:ERROR",
      "whereLanguage": "lucene",
      "orderBy": "Timestamp DESC",
      "tags": [
        "production",
        "errors"
      ],
      "filters": [
        {
          "type": "sql",
          "condition": "ServiceName IN ('checkout', 'payments')"
        }
      ],
      "teamId": "507f1f77bcf86cd799439013",
      "createdAt": "2025-01-01T00:00:00.000Z",
      "updatedAt": "2025-06-15T10:30:00.000Z"
    }
  ],
  "meta": {
    "total": 142,
    "limit": 50,
    "offset": 100
  }
}

Changes