Skip to content
HalvorAI mark HalvorAI mark HalvorAI

List events

GET
/v1/events

Newest first. Needs the events:read scope for API keys.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
q
string
>= 1 characters <= 200 characters
agent_id
string
<= 128 characters
owner_id
string
<= 128 characters
payee_id
string
<= 128 characters
rail
string
Allowed values: stripe card x402 mpp stablecoin bank_transfer
status
string
Allowed values: requested authorized settled failed refunded disputed
verification
string
Allowed values: invalid
from
string format: date-time
to
string format: date-time
limit

Page size, 1 to 200.

integer
default: 50 >= 1 <= 200

Page size, 1 to 200.

cursor

Opaque cursor from the previous page.

string
>= 1 characters <= 500 characters

Opaque cursor from the previous page.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

A page of events

object
data
required
Array<object>
object
id
required
string
type
required
string
environment
required
string
Allowed values: test live
occurred_at
required
string format: date-time
Example
2026-10-17T09:14:03.218Z
received_at
required
string format: date-time
Example
2026-10-17T09:14:03.218Z
source_id
required
string
agent_id
required

HalvorAI agent id (agt_…).

string
owner_id
required
string
payee_id
required
string | null
chain_seq
required
integer
payment
required
object
payment_id
required
string
rail
required
string
status
required
string
amount
required
object
value
required

Decimal integer in minor or atomic units.

string
unit
required
string
Allowed values: minor atomic
currency
string
asset
object
network
required
string
address
required
string
symbol
string
decimals
integer
amount_usd_minor
required

US cents, or null when the amount cannot be priced.

string | null
payee
required
object
key
required
string
type
string
name
string
country
string
evidence_count
required
integer
verification
required

Latest verification summary, when present.

object
result
required
string
Allowed values: valid invalid expired unverifiable
kind
required
string
mandate_evaluation
required

Latest mandate evaluation summary, when present.

object
result
required
string
Allowed values: within outside not_evaluable
mandate_id
required
string
next_cursor
required

Pass as ?cursor= for the next page. Null on the last page.

string | null

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