Skip to content
HalvorAI mark HalvorAI mark HalvorAI

Get one event

GET
/v1/events/{id}

The event as received, its place in the hash chain and its evidence. Evidence values are shown to analysts and above, and to keys with events:read.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string
>= 1 characters <= 128 characters

Responses

Section titled “ Responses ”

200

Section titled “200 ”

The event

object
id
required
string
event
required

The APE event as received.

object
key
additional properties
signature
required
string
received_at
required
string format: date-time
Example
2026-10-17T09:14:03.218Z
agent_id
required
string
owner_id
required
string
payee_id
required
string | null
chain
required
object
seq
required
integer
prev_hash
required
string | null
hash
required
string
canonical_sha256
required
string
evidence
required
Array<object>
object
id
required
string
kind
required
string
format
required
string
sha256
required
string
redacted
required

True when your role may not see evidence values.

boolean
value
value_uri
required
string | null
verifications
required
Array<object>
object
id
required
string
evidence_item_id
required
string
kind
required
string
result
required
string
Allowed values: valid invalid expired unverifiable
checks
required
Array<object>
object
check
required
string
ok
required
boolean
detail
string
verifier_version
required
string
at
required
string format: date-time
Example
2026-10-17T09:14:03.218Z
mandate_evaluations
required
Array<object>
object
id
required
string
mandate_id
required
string
result
required
string
Allowed values: within outside not_evaluable
findings
required
Array
at
required
string format: date-time
Example
2026-10-17T09:14:03.218Z

400

Section titled “400 ”

The request is not valid

object
error
required
object
code
required
string
Example
invalid_request
message
required
string
details
Array
request_id
required
string
Example
req_01J9ZK6V3S4Q8Y2M7N5P0R1T2W

401

Section titled “401 ”

Not signed in, or the API key is not valid

object
error
required
object
code
required
string
Example
invalid_request
message
required
string
details
Array
request_id
required
string
Example
req_01J9ZK6V3S4Q8Y2M7N5P0R1T2W

403

Section titled “403 ”

Not allowed for this role or key

object
error
required
object
code
required
string
Example
invalid_request
message
required
string
details
Array
request_id
required
string
Example
req_01J9ZK6V3S4Q8Y2M7N5P0R1T2W

404

Section titled “404 ”

Not found in your organization

object
error
required
object
code
required
string
Example
invalid_request
message
required
string
details
Array
request_id
required
string
Example
req_01J9ZK6V3S4Q8Y2M7N5P0R1T2W