Skip to main content
GET
/
audit-logs
List audit logs
curl --request GET \
  --url https://api.matia.io/v1/audit-logs \
  --header 'x-api-key: <api-key>'
{
  "code": "<string>",
  "data": {
    "totalItems": 1250,
    "items": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "timestamp": "2025-12-27T16:20:00Z",
        "event": "user.roles_removed",
        "actor": {
          "type": "user",
          "email": "[email protected]"
        },
        "context": {
          "ipAddress": "192.168.1.1",
          "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)..."
        }
      }
    ]
  }
}
This API is in Beta. Please report any issues to our support team.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
limit
integer
default:20

Max number of audit logs to return.

Required range: x <= 100
​
offset
integer
default:0

Number of audit logs to skip for pagination.

​
sortBy
enum<string>
default:timestamp

The field to sort the audit logs by.

Available options:
timestamp
​
sortOrder
enum<string>
default:desc

The direction of the sort.

Available options:
asc,
desc
​
startAt
string<date-time>

Filter for audit logs AFTER this timestamp (inclusive).

Example:

"2025-12-27T00:00:00Z"

​
endAt
string<date-time>

Filter for audit logs BEFORE this timestamp (exclusive).

Example:

"2025-12-27T23:59:59Z"

Response

Successfully listed audit logs

​
code
string
​
data
object