Audit log

When records are created, updated or deleted within your account, an audit log is created. Use the audit log API to retrieve the last 30 days worth of data corresponding to changes within your account.

List audit logs

Returns a list of audit logs.

Request

query Parameters

q	string <string> Filter by any audit log value. Example: q=audit_table:staff;sp_member,user_name:john@example.com,audit_timestamp>2022-05-01
limit	integer <int32> Limits the amount of records to return (maxiumum 5000). Example: limit=10

Responses

200

List of audit logs

403

Access denied to this resource

404

Resource not found

get/audit

Request samples

curl
JavaScript
Node.js

curl -i -X GET \
  'https://api.whosonlocation.com/v1/audit?q=string&limit=0'

Response samples

[{"id": 823431,
"audit_timestamp": "2021-08-12T10:54:13+12:00",
"audit_event": "UPDATE",
"audit_table": "staff",
"user_name": "john@example.com",
"user_type": "staff",
"record_id": 823431,
"data_changed": [{"column_name": "name",
"change_from": "John Smith",
"change_to": "John B Smith"
},
{"column_name": "from",
"change_from": "Smith Corp",
"change_to": "Smith Corporation"
}
],
"data_old": {"id": 588,
"from": "Smith Corp",
"name": "John Smith",
"created": "2022-05-06 00:23:48.000000",
"modified": null
},
"data_new": {"id": 588,
"from": "Smith Corporation",
"name": "John B Smith",
"created": "2022-05-06 00:23:48.000000",
"modified": "2022-05-07 10:33:19.000000"
}
}
]

Retrieve available audit settings

Retrieves an audit settings object.

Responses

200

Audit settings

403

Access denied to resource

404

Resource not found

500

Internal server error

get/audit/settings

Request samples

curl
JavaScript
Node.js

curl -i -X GET \
  https://api.whosonlocation.com/v1/audit/settings