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