Skip to main content
GET
/
api
/
v2
/
logs
Query conversation logs
curl --request GET \
  --url 'https://api.vida.dev/api/v2/logs?token='
{
  "success": true,
  "message": "Success",
  "logs": [
    {
      "id": "log_001",
      "timestamp": "2025-09-30T12:34:56.789Z",
      "account_id": "acct_123",
      "org_id": "org_456",
      "eventType": "message.created",
      "metadata": {
        "convoId": "c_abc",
        "tokens": 1234
      }
    }
  ],
  "count": 20,
  "totalCount": 5231,
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "totalPages": 262,
    "totalCount": 5231,
    "hasMore": true,
    "pageCount": 262
  },
  "schema": [
    "id",
    "timestamp",
    "account_id",
    "org_id",
    "eventType",
    "metadata"
  ]
}

Authorizations

​
token
string
query
required

Vida API Token

Query Parameters

​
start
object

Start time as Unix seconds. Defaults to 7 days ago.

​
end
object

End time as Unix seconds. Defaults to current time.

​
fields
object

Comma separated list of fields to include. Restricted fields are always removed.

​
format
object

Response format. json returns a JSON envelope. csv streams a CSV file.

​
pageSize
object

Page size for pagination. Max 10000. Defaults to 20.

​
page
object

Page number starting at 1. Defaults to 1.

​
includeFields
object

When truthy, include an inferred schema array in the JSON response.

​
token
object

Opaque pagination or access token if supported by upstream systems.

​
targetAccountId
object

Optional target account context. May be ignored based on caller scope.

​
...additional filters...
object

Any other query parameters are treated as filters. Supports explicit type hints with

Response

Successful JSON response. When format=csv, a CSV file is streamed with status 200.

​
success
boolean
Example:

true

​
message
string
Example:

"Success"

​
logs
object[]

Array of log entries with restricted fields removed based on caller scope.

​
count
integer
Example:

20

​
totalCount
integer
Example:

5231

​
pagination
object
​
schema
string[]

Returned only when includeFields is truthy. The inferred list of available fields.

Example:
[
  "id",
  "timestamp",
  "account_id",
  "org_id",
  "eventType",
  "metadata"
]