Skip to main content
GET
/
membership-audit-log
/
{org}
List membership/role change history for an org
curl --request GET \
  --url https://app.kosli.com/api/v2/membership-audit-log/{org} \
  --header 'Authorization: Bearer <token>'
{
  "page": 123,
  "per_page": 123,
  "total_pages": 123,
  "total_count": 123,
  "events": [
    {
      "id": "<string>",
      "user": "<string>",
      "changed_by": "<string>",
      "role": "<string>",
      "previous_role": "<string>",
      "source": "<string>",
      "created_at": 123
    }
  ],
  "_links": {}
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

org
string
required

Query Parameters

page
integer
default:1

Page number

Required range: x >= 1
per_page
integer
default:15

Number of events per page

Required range: 1 <= x <= 100
search
string | null

Filter by affected user or actor (name substring)

event_type
enum<string> | null

Filter by event type: added, changed, or removed

Available options:
added,
changed,
removed
role
string[] | null

Filter by new role. Can be repeated.

source
string[] | null

Filter by source (app/scim/invitation/script). Repeatable.

from_timestamp
number | null

Only events at or after this unix timestamp

to_timestamp
number | null

Only events at or before this unix timestamp

sort_by
enum<string>
default:when

Column to sort by

Available options:
when,
user,
role,
changed_by,
source
sort_dir
enum<string>
default:desc

Sort direction

Available options:
asc,
desc

Response

Successful Response

page
integer
required
per_page
integer
required
total_pages
integer
required
total_count
integer
required
events
AuditLogListItemResponse · object[]
required
Last modified on June 25, 2026