Audit Logs

OpenMeter Cloud maintains comprehensive audit logs to record all user and system actions within your organization. Audit logs help you track changes, investigate issues, and meet compliance requirements.

#How to enable audit logs?

• Write Logs: All write operations (create, update, delete) are logged automatically, no setup required.
• Read Logs: To enable read-operation logs, please contact our support team at .

#Logged Events

OpenMeter audit logs capture the following event types:

• Create: New entity creation (e.g., billing profile, user, API key)
• Update: Changes to existing entities
• Delete: Removal of entities
• Read: Entity retrieval operations (logged if enabled)
• Authentication: Login and logout attempts
• Permission Changes: Role assignments or RBAC configuration updates

#Audit Log Integrations

You can consume audit logs via our API. Please contact our support team at

for additional integration options.

#API

You can get the audit logs via the RESt API.

#Request

Example request to get the audit logs:

curl  -X GET \
  'https://openmeter.cloud/api/v1/audit \
  --header 'Accept: */*' \
  --header 'Authorization: Bearer API_TOKEN'

#Authentication

The API is protected by a bearer token. You can get your API token from the API Dashboard. Enterprise users also can get an Audit Log read-only API token via Role-based access control (RBAC).

Add the Bearer token in HTTP Request Header: Authorization: Bearer API_TOKEN

#Pagination

Pagination is done via cursor. The API response returns the next cursor that you need to pass into the API as a query parameter:

curl  -X GET \
  'https://openmeter.cloud/api/v1/audit?cursor=NEXT_CURSOR' \
  --header 'Accept: */*' \
  --header 'Authorization: Bearer API_TOKEN'

#Example Response

The API returns a JSON object with the following fields:

• items: An array of audit log items
• nextCursor: The next cursor to use for pagination

{
  "items": [
    {
      {
        "id": "01f2bf2aac9c322362ac0361f9476e04",
        "time": "2025-01-01T00:00:00Z",
        "resourceKind": "meter",
        "resourceId": "01J4Q2BSK8RBB784DPJ0XRT5CF",
        "action": "create",
        "authorized": true,
        "operation": "createMeter",
        "userId": "user_123",
        "url": "https://openmeter.cloud/api/v1/meters",
        "sourceIp": "192.168.1.1",
        "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36",
        "data": {}
      }
    }
  ],
  "nextCursor": "MjAyNS0wNS0xNFQwODo1MDo0MVosOTdhNmExYzVmYzRiODAwZTA4MWEyMmRhNTdiOGEzYTQ="
}