Return the schema-driven analytics payload for the caller's org.

Requires organization admin role or higher. Window params are validated by FastAPI (bad timestamps / inverted range fail as 422 before this runs).

The Sessions metric's row-level table is not inlined — fetch it from /v2/analytics/{metric}/detail.

get/v2/analytics

Request

  • Base URL
    https://api.traversal.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.traversal.com/v2/analytics
  • Auth
    none declared

Query parameters

start_timestring date-time nullable

Start timestamp (inclusive), ISO 8601 with timezone. Defaults to 30 days ago.

Example:2025-01-15T00:00:00.000Z
end_timestring date-time nullable

End timestamp (exclusive), ISO 8601 with timezone. Defaults to now.

Example:2025-02-15T23:59:59.999Z
granularity'day'

Timeseries bucket granularity.

actor_type'user' | 'service_account'

Count only this kind of actor. Omit to count users and service accounts together.

Response

Successful Response

generated_atstring date-time required

Changes

    • warning

      added the new actor enum value to the ///////// response property for the response status

    • warning

      added the new actor enum value to the /////////// response property for the response status

    • info

      added the new optional query request parameter actor_type

    • info

      added the required property ///////// to the response with the status

    • info

      added the required property ///////// to the response with the status

    • info

      added the required property ///////// to the response with the status

    • info

      added the required property /////////// to the response with the status