Example Request
**URL:** `https://api-public.bitdrift.io/bitdrift.public.unary.timeline.v1.TimelineService/AdvancedSearchSession` See [calling the API](../api-guide/calling-the-api.md) for authentication and request details. ```json { "end_time": "2024-01-15T09:30:00Z", "include_internal_logs": true, "limit": 25, "offset": 0, "or_query": [ { "conditions": [ { "field_match": { "json_path": "$.fields.os_version", "operator": "EQUAL", "value": "14.0" } } ] } ], "session_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "start_time": "2024-01-15T09:30:00Z" } ```Example Response
```json { "results": [ { "log": { "fields": { "fields": { "key": { "string_data": "" } } }, "listener_ids": [ "abc-123-def" ], "log_level": "DEBUG", "log_type": "REPLAY", "message": "Example text", "timestamp": "2024-01-15T09:30:00Z" }, "matches": [ { "fields_json_path": "$.fields.os_version" } ], "row_number": 5 } ], "total_pages": 3, "total_results": 42 } ``` ### GetHydrationStatus Retrieves the hydration status of a session. Returns the gRPC NOT_FOUND status if hydration has not been triggered for the session yet.Example Request
**URL:** `https://api-public.bitdrift.io/bitdrift.public.unary.timeline.v1.TimelineService/GetHydrationStatus` See [calling the API](../api-guide/calling-the-api.md) for authentication and request details. ```json { "session_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" } ```Example Response
```json { "status": { "created_at": "2024-01-15T09:30:00Z", "expiration_time": "2024-01-15T09:30:00Z", "finished_at": "2024-01-15T09:30:00Z", "hydration_status": "HYDRATING", "incremental": false, "started_at": "2024-01-15T09:30:00Z" } } ``` ### GetSessionInfo Retrieves metadata and attributes for a session. Returns the gRPC NOT_FOUND status if the session has not been hydrated yet.Example Request
**URL:** `https://api-public.bitdrift.io/bitdrift.public.unary.timeline.v1.TimelineService/GetSessionInfo` See [calling the API](../api-guide/calling-the-api.md) for authentication and request details. ```json { "session_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" } ```Example Response
```json { "device_id": "device-123", "device_model": "iPhone15,2", "end_time": "2024-01-15T09:30:00Z", "os": "iOS", "os_version": "17.4.1", "platform": { "apple": { "apps": [ { "app_id": "com.example.app" } ] } }, "start_time": "2024-01-15T09:30:00Z", "user_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" } ``` ### GetSessionLogs Retrieves the logs for a session. Returns the gRPC NOT_FOUND status if the session has not been hydrated yet.Example Request
**URL:** `https://api-public.bitdrift.io/bitdrift.public.unary.timeline.v1.TimelineService/GetSessionLogs` See [calling the API](../api-guide/calling-the-api.md) for authentication and request details. ```json { "end_time": "2024-01-15T09:30:00Z", "include_internal_logs": true, "log_type": { "screen_capture": {} }, "page": 1, "per_page": 25, "session_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "start_time": "2024-01-15T09:30:00Z" } ```Example Response
```json { "logs": [ { "fields": { "fields": { "key": { "string_data": "" } } }, "listener_ids": [ "abc-123-def" ], "log_level": "DEBUG", "log_type": "REPLAY", "message": "Example text", "timestamp": "2024-01-15T09:30:00Z" } ], "total_pages": 3 } ``` ### HydrateSession Triggers hydration of a session. Hydration prepares session data for querying. Can also be used to force re-hydration of an already hydrated session.Example Request
**URL:** `https://api-public.bitdrift.io/bitdrift.public.unary.timeline.v1.TimelineService/HydrateSession` See [calling the API](../api-guide/calling-the-api.md) for authentication and request details. ```json { "force": true, "session_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890" } ```Example Response
```json { "ignored": false, "last_hydration_state": { "created_at": "2024-01-15T09:30:00Z", "expiration_time": "2024-01-15T09:30:00Z", "finished_at": "2024-01-15T09:30:00Z", "hydration_status": "HYDRATING", "incremental": false, "started_at": "2024-01-15T09:30:00Z" }, "success": true } ```