Audit Log

List privacy audit logs

Returns paginated privacy audit ledger entries for the authenticated organization: who accessed whose personal data, when, from which IP addresses, and through which product area. Reads of this ledger are themselves recorded in the API and MCP audit ledgers. Requires the audit_logs:read scope and an acting user with the owner-only READ_AUDIT_LOGS permission; other callers receive PERMISSION_DENIED. Results are newest first. Requires a timestamp window of at most 366 days; use the cursor to continue the same filtered result set.

GET

audit-logs

privacy

curl --request GET \
  --url https://api.modernloop.io/v1/audit-logs/privacy \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.modernloop.io/v1/audit-logs/privacy', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.modernloop.io/v1/audit-logs/privacy",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.modernloop.io/v1/audit-logs/privacy"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.modernloop.io/v1/audit-logs/privacy")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "pal_a1b2c3d4e5f64789a1b2c3d4e5f64789",
      "access_time": "2023-11-07T05:31:56Z",
      "account_id": "<string>",
      "ip_addresses": [
        "<string>"
      ],
      "data_subject": {
        "type": "EMPLOYEE",
        "user": "usr_a1b2c3d4e5f64789a1b2c3d4e5f64789"
      },
      "access_data": [
        "NAME"
      ],
      "access_menu": "<string>",
      "access_menu_path": "<string>",
      "activity_category": "CREATE"
    }
  ],
  "pagination": {
    "next_cursor": "<string>"
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

Beta: this endpoint may change or be removed without notice while in beta. There is no compatibility promise until it reaches general availability.

Authorizations

Authorization

string

header

required

API tokens are passed as Bearer tokens.

Query Parameters

cursor

string

Opaque pagination cursor from the previous page's pagination.next_cursor, bound to the same query filters.

limit

integer

default:25

Page size. Must be between 1 and 100; defaults to 25.

Required range: 1 <= x <= 100

ids

string[]

Comma-separated list of IDs; maximum 100 values.

Minimum array length: 1

a privacy audit log entry ID. Accepts the canonical prefixed compact UUID, a prefixed dashed UUID, a bare dashed UUID, or a bare compact UUID; input is case-insensitive.

Pattern: ^(?:pal_)?(?:[0-9a-fA-F]{32}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

timestamp_gte

string<date-time>

required

Includes entries recorded at or after this timestamp. Required.

timestamp_lt

string<date-time>

required

Includes entries recorded before this timestamp. Required.

Response

Success

data

object[]

required

Show child attributes

pagination

object

required

Show child attributes

⌘I

List privacy audit logs

curl --request GET \
  --url https://api.modernloop.io/v1/audit-logs/privacy \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.modernloop.io/v1/audit-logs/privacy', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.modernloop.io/v1/audit-logs/privacy",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.modernloop.io/v1/audit-logs/privacy"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.modernloop.io/v1/audit-logs/privacy")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "pal_a1b2c3d4e5f64789a1b2c3d4e5f64789",
      "access_time": "2023-11-07T05:31:56Z",
      "account_id": "<string>",
      "ip_addresses": [
        "<string>"
      ],
      "data_subject": {
        "type": "EMPLOYEE",
        "user": "usr_a1b2c3d4e5f64789a1b2c3d4e5f64789"
      },
      "access_data": [
        "NAME"
      ],
      "access_menu": "<string>",
      "access_menu_path": "<string>",
      "activity_category": "CREATE"
    }
  ],
  "pagination": {
    "next_cursor": "<string>"
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "<string>",
    "docs_url": "<string>",
    "details": [
      {}
    ]
  }
}

Activity

Application

Audit Log

Candidate

Interview Event

Interview Module

Job Stage

Job

Me

Organization

Schedule

Task Queue

Scheduling Task

Template

User

List privacy audit logs

Authorizations

Query Parameters

Response