List Audit Logs
Lists audit logs for the API token organisation in descending occurred_at order. Every valid API token may read these logs, and entity permissions do not filter events. Queries for one subject require both subject_type and subject_id; all other queries require an RFC 3339 time range in occurred_at[gte] and occurred_at[lte]. Follow next_page_url until it is null and treat event IDs as stable deduplication keys.
Authorization
bearerAuth In: header
Query Parameters
Filters resources by subject type.
Unique identifier of the related subject.
Filters resources by subject role.
Filters resources by action.
Filters by any of the supplied action values.
Type of entity that performed the event.
Unique identifier of the related actor.
Filters resources by occurred at using the gte operator.
date-timeFilters resources by occurred at using the lte operator.
date-timeMaximum number of resources to return.
100 <= value <= 100Opaque token returned by a previous page request.
1 <= lengthAdditional fields to include in the response. Use repeated query syntax: include=foo&include=bar.
Response Body
application/json
curl -X GET "https://api.getmateo.com/v1/audit-logs"{ "object": "list", "data": [ { "occurred_at": "2019-08-24T14:15:22Z", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "action": "opt_in.created", "actor": { "type": "employee", "id": "string" }, "actor_type": "employee", "actor_id": "string", "changes": [ { "field": "string", "before": {}, "after": {} } ], "subjects": [ { "subject_type": "opt_in", "subject_id": "string", "subject_role": "primary", "external_id": "string", "secondary_external_id": "string" } ] } ], "next_page_url": "string", "previous_page_url": "string"}