VRPlatformVRPlatform
PartnerAudit

/partner/audit-events

List redacted public audit events for authorized managed teams in one region. Team filters narrow stored partner reach, and opaque cursors preserve revision-safe traversal.

Required scope: audit:read

GET
/partner/audit-events
X-API-Key<token>

API key provided in dashboard

In: header

Query Parameters

cursor?string
Length1 <= length
limit?integer
Default50
Range1 <= value <= 100
order?string
Default"desc"
Value in"asc" | "desc"
occurredFrom?string

Timestamp string with date, time, milliseconds, and timezone.

Formatdate-time
occurredTo?string

Timestamp string with date, time, milliseconds, and timezone.

Formatdate-time
updatedFrom?string

Timestamp string with date, time, milliseconds, and timezone.

Formatdate-time
updatedTo?string

Timestamp string with date, time, milliseconds, and timezone.

Formatdate-time
entityType?string
Value in"account" | "accountConnection" | "apiToken" | "bankRecord" | "bankRule" | "connection" | "contact" | "emailTemplate" | "flowMapping" | "flowSetting" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "ownerStatementLayout" | "ownerStatementLayoutListing" | "ownerUserAccess" | "recurringFee" | "recurringFeeListingSubscription" | "recurringTransactionTemplate" | "reservation" | "reservationLineMapping" | "taxRate" | "team" | "teamMember" | "transaction" | "webhookSubscription"
entityId?string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
actionId?string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
actionCode?string
Length1 <= length
operation?string
Value in"create" | "update" | "delete" | "archive" | "restore" | "execute" | "recalculate"
actorType?string
Value in"user" | "api_key" | "sync" | "automation" | "system"
actorId?string
Length1 <= length
accountingStatus?string
accountId?string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
hasChanges?boolean

Whether any committed or attempted public entity or journal-entry change exists

changedEntityType?string

Public subject participating in a committed or attempted change

Value in"account" | "accountConnection" | "apiToken" | "bankRecord" | "bankRule" | "connection" | "contact" | "emailTemplate" | "flowMapping" | "flowSetting" | "listing" | "listingOwnershipPeriod" | "ownerStatement" | "ownerStatementLayout" | "ownerStatementLayoutListing" | "ownerUserAccess" | "recurringFee" | "recurringFeeListingSubscription" | "recurringTransactionTemplate" | "reservation" | "reservationLineMapping" | "taxRate" | "team" | "teamMember" | "transaction" | "webhookSubscription" | "paymentLine"
changedPath?string

Exact public registry path for changedEntityType

Length1 <= length
teamId?string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Header Parameters

x-data-region?string

Selects the regional data partition for this regional collection read. It does not change the authenticated team context.

Value in"ap" | "crunchy" | "eu" | "hostaway" | "us"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.vrplatform.app/partner/audit-events"
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "revision": 9007199254740991,
      "actionId": "4a2794ff-94cb-4bac-8d36-d5fb36c563a0",
      "team": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "uniqueRef": "string",
        "name": "string"
      },
      "occurredAt": "2024-01-15T12:30:00.000+00:00",
      "updatedAt": "2024-01-15T12:30:00.000+00:00",
      "actor": {
        "type": "user",
        "id": "string",
        "name": "string",
        "email": "user@example.com",
        "label": "string",
        "organization": {
          "type": "vrplatform",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "name": "string"
        }
      },
      "source": {
        "type": "portal",
        "requestId": "string"
      },
      "action": {
        "code": "string",
        "summary": "string",
        "operation": "create"
      },
      "rootEntity": {
        "type": "account",
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "uniqueRef": "string",
        "name": "string"
      },
      "entityChanges": [
        {
          "entity": {
            "type": "account",
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "uniqueRef": "string",
            "name": "string"
          },
          "operation": "create",
          "changes": [
            {
              "path": "string",
              "before": {
                "type": "string",
                "value": "string"
              },
              "after": {
                "type": "string",
                "value": "string"
              }
            }
          ],
          "redactedFields": [
            "string"
          ]
        }
      ],
      "attemptedEntityChanges": [
        {
          "entity": {
            "type": "account",
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "uniqueRef": "string",
            "name": "string"
          },
          "operation": "create",
          "changes": [
            {
              "path": "string",
              "before": {
                "type": "string",
                "value": "string"
              },
              "after": {
                "type": "string",
                "value": "string"
              }
            }
          ],
          "redactedFields": [
            "string"
          ]
        }
      ],
      "accountingImpact": {
        "status": "not_applicable",
        "netEffect": [
          {
            "account": {
              "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
              "name": "string",
              "category": {
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "name": "string",
                "classification": "string"
              }
            },
            "amount": {
              "type": "money",
              "centTotal": -9007199254740991,
              "currency": "string"
            }
          }
        ],
        "blockedBy": [
          {
            "code": "booksClosed",
            "booksClosedAt": "string"
          }
        ],
        "recovery": [
          {
            "action": "createReservationAdjustment",
            "href": "string"
          }
        ]
      }
    }
  ],
  "page": {
    "limit": 9007199254740991,
    "hasMore": true,
    "nextCursor": "string"
  }
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "MISDIRECTED_REQUEST",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": {
    "teamId": "a4ede8ba-7c0a-4485-8763-cbd9b282fbec",
    "dataRegion": "ap",
    "apiBaseUrl": "http://example.com"
  }
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}
{
  "code": "AUDIT_CURSOR_EXPIRED",
  "message": "string",
  "links": {
    "docs": "string",
    "schema": "string"
  },
  "issues": [
    {
      "message": "string",
      "path": [
        "string"
      ],
      "schema": "string"
    }
  ],
  "retryable": true,
  "context": null
}