List conversation identity events

GET

/api/conversations/{id}/identity-events

• Production

Returns the identity and verification events recorded during a conversation. These form the audit trail for how a caller was identified and verified across turns, including factor collection and assurance decisions.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

The unique identifier of the conversation.

Responses

200

The identity events for the conversation.

The list of identity events recorded for a conversation.

object

events

required

The identity events for the conversation.

Array<object>

A single identity or verification event recorded during a conversation. Events capture how a caller was identified and verified across turns, forming the audit trail for factor collection and assurance decisions.

object

id

required

Unique identifier for the event.

string format: uuid

Example

ie1a2b3c-5678-9abc-def0-1234567890ab

tenantId

required

The tenant this event belongs to.

string format: uuid

Example

a0b1c2d3-4567-89ab-cdef-0123456789ab

conversationId

required

The conversation this event belongs to.

string format: uuid

Example

c1a2b3c4-5678-9abc-def0-1234567890ab

turnId

The conversation turn during which the event occurred, when applicable.

string | null format: uuid

occurredAt

required

Timestamp when the event occurred.

string format: date-time

Example

2026-03-25T11:40:00.000Z

eventType

required

The kind of identity event, such as a factor being collected or a verification being evaluated.

string

Example

factor_collected

factorCategory

The category of the identity factor involved, when applicable.

string | null

Example

knowledge

factorType

The specific factor type involved, when applicable.

string | null

Example

order_number

factorBoundToPrincipal

The principal the factor was bound to, when applicable.

string | null

derivedAssuranceLevel

The assurance level derived from the collected factors, when computed.

string | null

Example

medium

scopeDimension

The dimension the resulting scope applies to, when applicable.

string | null

Example

account

scopeValues

Free-form values describing the scope granted, when present.

object

key

additional properties

Example

{
  "accountId": "ac1a2b3c-5678-9abc-def0-1234567890ab"
}

evidenceRef

Reference to supporting evidence for the event, when recorded.

string | null

promptVersion

The prompt version used when the event was produced, when applicable.

string | null

questionText

The verification question presented, when applicable.

string | null

Example

Can you confirm the order number?

sourceToolName

The tool that produced the event, when applicable.

string | null

evaluationSummary

A short summary of the evaluation outcome, when applicable.

string | null

Example

Order number matched an active order.

createdAt

required

Timestamp when the event row was created.

string format: date-time

Example

2026-03-25T11:40:00.000Z

404

No conversation exists with the given ID in the authenticated tenant.

Standard error response returned by all endpoints on failure.

object

error

required

A human-readable error message describing what went wrong.

string

Example

Conversation not found