Skip to main content
GET
/
storage
/
streams
/
{stream}
/
search-by-subject
Search stream messages by subject pattern
curl --request GET \
  --url https://api.quiva.ai/storage/streams/{stream}/search-by-subject \
  --header 'Authorization: Bearer <token>'
{ "body": { "results": [ { "subject": "events.user.login", "value": "{\"user_id\":\"usr_abc123\",\"timestamp\":\"2024-03-15T14:30:00Z\"}", "created": "2024-03-15T14:30:00Z" }, { "subject": "events.user.logout", "value": "{\"user_id\":\"usr_abc123\",\"timestamp\":\"2024-03-15T16:45:00Z\"}", "created": "2024-03-15T16:45:00Z" }, { "subject": "events.user.profile_update", "value": "{\"user_id\":\"usr_def456\",\"field\":\"email\",\"timestamp\":\"2024-03-15T17:00:00Z\"}", "created": "2024-03-15T17:00:00Z" } ], "results_total": 3 }, "metadata": { "stream": "user-events", "search": "events.user.*", "hits": 3, "duration": "8ms" } }

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
stream
string
required

Name of the stream

Query Parameters

​
search
string
required

Subject pattern to search for (supports wildcards)

​
limit
integer
default:10

Maximum number of results to return

Required range: 1 <= x <= 1000

Response

Search results

​
body
object
​
metadata
object