Audit

Read security and integration activity recorded for the account.

List account audit events

GET

https://api.legitgrails.com/v1/integrations

/audit/events

Bearer

Returns security and integration activity for the authenticated account, newest first. Events are retained for 365 days. Date boundaries are inclusive; from must be earlier than or equal to to.

List account audit events › query Parameters

from

string · date-time

Include events at or after this timestamp.

to

string · date-time

Include events at or before this timestamp.

event

AccountAuditEventCode · enum

Restrict results to one audit event code.

Enum values:

auth.login.succeeded

auth.login.failed

auth.password.changed

auth.email.changed

api-key.created

api-key.renamed

api-key.revoked

webhook.created

actor_type

AccountAuditActorType · enum

Restrict results to one actor type.

Enum values:

user

api-key

system

source

AccountAuditSource · enum

Restrict results to one request or system source.

Enum values:

portal-web

mobile

integration-api

system

page

integer · min: 1

Default: 1

limit

integer · min: 1 · max: 100

Default: 20

List account audit events › Responses

A page of account audit events, ordered newest first.

AccountAuditEventsResponse

AccountAuditEvent[] · required

page

integer · min: 1 · required

limit

integer · min: 1 · max: 100 · required

total

integer · min: 0 · required

GET/audit/events

curl https://api.legitgrails.com/v1/integrations/audit/events \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "id": "5b86c815-8d31-4125-a47d-d5b153ad615c",
      "account_user_id": "b303462c-ddd6-4ff1-8ee2-bd1a56a06bf2",
      "occurred_at": "2026-08-17T13:39:06.000Z",
      "event_code": "webhook.delivery.failed",
      "actor_type": "system",
      "actor_id": null,
      "actor_name": "Webhook delivery worker",
      "source": "system",
      "target_type": "webhook-delivery",
      "target_id": "e3aa9b91-a33e-4884-a66d-ef45b40221f8",
      "ip_address": null,
      "user_agent": null,
      "metadata": {
        "event": "order-outcome",
        "attempts": 4,
        "response_status": 503
      }
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1
}

json

application/json

Orders Webhooks

List account audit events

GET

https://api.legitgrails.com/v1/integrations

/audit/events

Bearer

Returns security and integration activity for the authenticated account, newest first. Events are retained for 365 days. Date boundaries are inclusive; from must be earlier than or equal to to.

List account audit events › query Parameters

from

string · date-time

Include events at or after this timestamp.

to

string · date-time

Include events at or before this timestamp.

event

AccountAuditEventCode · enum

Restrict results to one audit event code.

Enum values:

auth.login.succeeded

auth.login.failed

auth.password.changed

auth.email.changed

api-key.created

api-key.renamed

api-key.revoked

webhook.created

actor_type

AccountAuditActorType · enum

Restrict results to one actor type.

Enum values:

user

api-key

system

source

AccountAuditSource · enum

Restrict results to one request or system source.

Enum values:

portal-web

mobile

integration-api

system

page

integer · min: 1

Default: 1

limit

integer · min: 1 · max: 100

Default: 20

List account audit events › Responses

A page of account audit events, ordered newest first.

AccountAuditEventsResponse

AccountAuditEvent[] · required

page

integer · min: 1 · required

limit

integer · min: 1 · max: 100 · required

total

integer · min: 0 · required