---
title: Mengkueri Activity Feed
url: https://platform.claude.com/docs/id/manage-claude/compliance-activity-feed
description: Ambil, filter, dan paginasi Activity Feed Compliance API organisasi Anda.
---
Untuk mengaktifkan Compliance API, lihat [Menyiapkan Compliance API](https://platform.claude.com/docs/id/manage-claude/compliance-api-access).
**Scope yang diperlukan:** `read:compliance_activities` pada Compliance Access Key atau kunci Admin API.
Baik Compliance Access Key (`sk-ant-api01-...`) yang membawa scope ini maupun kunci Admin API (`sk-ant-admin01-...`) dapat memanggil Activity Feed. Lihat [Menyiapkan Compliance API](https://platform.claude.com/docs/id/manage-claude/compliance-api-access) untuk kondisi di mana setiap jenis kunci membawa scope tersebut.
Activity Feed mencatat aktivitas autentikasi, chat, file, proyek, administratif, dan platform di seluruh organisasi Anda dan mengembalikannya dalam urutan kronologis terbalik. Aktivitas dapat dikueri dalam waktu 1 menit setelah terjadi dan disimpan selama 6 tahun. Pencatatan tidak bersifat retroaktif: pencatatan dimulai saat Compliance API pertama kali diaktifkan untuk organisasi Anda, dan aktivitas dari sebelum pengaktifan tidak diisi ulang (backfill).
```bash cURL
curl --fail-with-body -sS \
"https://api.anthropic.com/v1/compliance/activities?limit=1" \
--header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
--header "anthropic-version: 2023-06-01"
```
```json Response
{
"data": [
{
"id": "activity_01XyDMpzjS89pFZXqSFUBDr6",
"created_at": "2026-04-10T08:09:10Z",
"organization_id": "org_01Wv6QeBcDfGhJkLmNpQrSt8",
"organization_uuid": "abcdef01-2345-6789-abcd-ef0123456789",
"actor": {
"type": "user_actor",
"email_address": "user@example.com",
"user_id": "user_01TuVwXyZaBcDeFgH2JkLmN4",
"ip_address": "192.0.2.34",
"user_agent": "Mozilla/5.0..."
},
"type": "claude_chat_created",
"claude_chat_id": "claude_chat_01XyDMpzjS89pFZXqSFUBDr6",
"claude_project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq"
}
],
"has_more": true,
"first_id": "activity_01XyDMpzjS89pFZXqSFUBDr6",
"last_id": "activity_01XyDMpzjS89pFZXqSFUBDr6"
}
```
## Memfilter aktivitas
Filter berdasarkan organisasi, aktor, jenis aktivitas, atau jendela waktu `created_at` menggunakan sub-parameter bertitik `created_at.gte`, `.gt`, `.lte`, dan `.lt`. Lihat [referensi API](https://platform.claude.com/docs/id/api/compliance/activities/list) untuk tipe dan nilai yang diterima setiap parameter.
Parameter yang dapat diulang menggunakan sintaks kueri kurung-array: berikan `activity_types[]=...`, `actor_ids[]=...`, atau `organization_ids[]=...` satu kali untuk setiap nilai.
```bash cURL
curl --fail-with-body -sS -G \
"https://api.anthropic.com/v1/compliance/activities" \
--data-urlencode "activity_types[]=claude_file_uploaded" \
--data-urlencode "activity_types[]=claude_chat_created" \
--data-urlencode "created_at.gte=2026-04-01T00:00:00Z" \
--header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
--header "anthropic-version: 2023-06-01"
```
Activity Feed menghasilkan ratusan jenis aktivitas yang berbeda. Lihat [Mengkueri aktivitas kepatuhan](https://platform.claude.com/docs/id/api/compliance/activities/list) di referensi API untuk daftar lengkap nilai yang diterima `activity_types[]`.
## Memaginasi hasil
Aktivitas dikembalikan dari yang terbaru terlebih dahulu, dengan nilai `created_at` yang sama diurutkan berdasarkan ID aktivitas, dan dibatasi hingga `limit` hasil dalam setiap respons (default 100, maksimum 5.000). Lihat [referensi API](https://platform.claude.com/docs/id/api/compliance/activities/list) untuk skema respons lengkap.
Compliance API menggunakan dua skema "pagination" (paginasi) tergantung pada keluarga endpoint:
| Keluarga endpoint | Urutan pengurutan | Skema | Parameter |
| ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- | ------------- | -------------------------------------------------------------------- |
| Aktivitas | Terbaru terlebih dahulu | Cursor | `after_id`, `before_id` (dikembalikan sebagai `first_id`, `last_id`) |
| Chat dan pesan chat | Terlama terlebih dahulu | Cursor | `after_id`, `before_id` (dikembalikan sebagai `first_id`, `last_id`) |
| Organisasi, proyek, lampiran proyek, pengguna, peran, izin peran, grup, anggota grup | Spesifik per endpoint | Token halaman | `page` (dikembalikan sebagai `next_page`) |
| Sesi lokal dan jarak jauh serta pesan sesi | Sesi terbaru terlebih dahulu; pesan terlama terlebih dahulu secara default | Token halaman | `page` (dikembalikan sebagai `next_page`) |
File tidak dipaginasi: file diambil satu per satu berdasarkan ID.
Cursor paginasi dan token halaman adalah string buram (opaque): kirimkan kembali tanpa diubah. Format internalnya tidak stabil, dan mem-parsing-nya akan rusak tanpa pemberitahuan. Hanya salah satu dari `after_id` atau `before_id` yang boleh diatur dalam setiap permintaan, dan kedua skema mengembalikan `has_more` sehingga Anda tahu kapan harus berhenti. Endpoint sesi (lokal dan jarak jauh) adalah pengecualian: endpoint tersebut mengembalikan `next_page` tanpa `has_more`, jadi berhentilah ketika `next_page` bernilai `null`.
Untuk menelusuri halaman aktivitas:
* Berikan `last_id` dari respons sebagai `after_id` untuk maju ke halaman berikutnya dalam urutan hasil. Karena aktivitas diurutkan dari yang terbaru terlebih dahulu, halaman berikutnya berisi entri yang lebih lama.
* Berikan `first_id` sebagai `before_id` untuk kembali ke halaman sebelumnya.
* Berhenti ketika `has_more` bernilai `false`.
Parameter cursor menentukan arah halaman; urutan pengurutan endpoint menentukan arah waktu. Parameter `after_id` yang sama menjangkau aktivitas yang lebih lama di sini. Chat diurutkan dari yang terlama terlebih dahulu; lihat [Mengambil dan menghapus chat, file, dan proyek](https://platform.claude.com/docs/id/manage-claude/compliance-content-data) untuk semantik cursor di sana.
**Cursor aman digunakan kembali saat percobaan ulang.** Cursor atau token halaman dari halaman yang berhasil dikembalikan tetap valid; permintaan yang gagal (5xx, timeout, kesalahan jaringan) tidak memajukan posisi Anda. Coba ulang permintaan yang sama dengan cursor yang sama. Hanya berpindah ke cursor berikutnya setelah Anda menyimpan halaman yang dilewatinya.
Token halaman pada endpoint sesi lokal adalah pengecualian untuk jeda yang lebih lama. Pada [endpoint pesan sesi lokal](https://platform.claude.com/docs/id/manage-claude/compliance-sessions#retrieve-a-local-session-transcript), token `page` dari suatu penelusuran kedaluwarsa 24 jam setelah halaman pertamanya (satu penelusuran adalah satu kali melewati semua halaman), jadi selesaikan atau lanjutkan dalam jendela waktu tersebut, atau mulai ulang tanpa parameter `page`. Pada [daftar sesi lokal](https://platform.claude.com/docs/id/manage-claude/compliance-sessions#retrieve-local-sessions), token `page` yang lebih lama masih diterima tetapi dievaluasi ulang terhadap batas retensi saat ini dan dapat melewatkan sesi, jadi selesaikan penelusuran daftar dalam 24 jam juga.
```bash cURL
# Ambil halaman pertama (aktivitas terbaru lebih dulu) dan simpan cursor di akhirnya.
last_id=$(curl --fail-with-body -sS \
"https://api.anthropic.com/v1/compliance/activities?limit=2" \
--header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
--header "anthropic-version: 2023-06-01" | jq -er '.last_id')
# Kirim kembali cursor tanpa diubah untuk mengambil halaman berikutnya (yang lebih lama).
curl --fail-with-body -sS -G \
"https://api.anthropic.com/v1/compliance/activities" \
--header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
--header "anthropic-version: 2023-06-01" \
--data-urlencode "limit=2" \
--data-urlencode "after_id=${last_id}"
```
Loop **backfill** produksi menelusuri aktivitas yang lebih lama dengan menggerakkan iterasi berdasarkan `has_more` dan `last_id`:
1. Mulai dari cursor yang Anda simpan (atau hilangkan `after_id` untuk memulai dari awal).
2. Telusuri halaman dengan `after_id=` hingga `has_more` bernilai `false`.
3. Simpan `last_id` terakhir secara permanen hanya setelah Anda menyimpan setiap halaman yang dicakupnya.
```text
cursor = stored_cursor
loop:
if cursor is not null:
page = GET /v1/compliance/activities?after_id={cursor}&limit=100
else:
page = GET /v1/compliance/activities?limit=100
store(page.data)
if page.last_id is not null:
cursor = page.last_id
if not page.has_more: break
persist(cursor)
```
## Memahami objek Activity
Setiap entri dalam `data` adalah Activity dengan bentuk tingkat atas berikut:
| Field | Tipe | Deskripsi |
| ------------------- | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | string | Pengidentifikasi unik untuk aktivitas. |
| `created_at` | string RFC 3339 | Kapan aktivitas terjadi. |
| `organization_id` | string atau null | Organisasi tempat aktivitas terjadi, atau `null` untuk peristiwa yang tidak terkait dengan organisasi (masuk, keluar, panggilan Compliance API). |
| `organization_uuid` | string atau null | Cakupan yang sama dengan `organization_id`, dinyatakan sebagai UUID. |
| `actor` | union Actor | Siapa atau apa yang melakukan aktivitas. Lihat tabel aktor berikut. |
| `type` | string | Jenis aktivitas, misalnya `claude_chat_created`. |
| *field tambahan* | bervariasi | Field spesifik per jenis, misalnya `claude_chat_id` pada peristiwa chat atau `claude_file_id` pada peristiwa file. Lihat [Mengkueri aktivitas kepatuhan](https://platform.claude.com/docs/id/api/compliance/activities/list) di referensi API untuk daftar field per jenis. |
Field `actor` adalah "discriminated union" (union terdiskriminasi). Diskriminator `type` memberi tahu Anda field lain mana yang ada:
| `actor.type` | Kapan muncul | Field utama |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `user_actor` | Pengguna claude.ai atau Claude Console yang sudah masuk melakukan tindakan, atau proses yang dijalankan Anthropic atas nama pengguna tersebut yang melakukannya (lihat paragraf setelah tabel ini). | `email_address`, `user_id`, `ip_address`, `user_agent` |
| `api_actor` | Sebuah permintaan memanggil Claude API atau Compliance API dengan kunci API yang diterbitkan pelanggan. Panggilan Compliance API menghasilkan jenis aktor ini baik untuk Compliance Access Key maupun kunci Admin API. | `api_key_id`, `ip_address`, `user_agent` |
| `admin_api_key_actor` | Admin organisasi menggunakan kunci Admin API untuk mengelola pengguna, undangan, workspace, atau kunci API. | `admin_api_key_id`, `ip_address`, `user_agent` |
| `unauthenticated_user_actor` | Suatu tindakan terjadi sebelum proses masuk selesai, misalnya `sso_login_initiated`. | `unauthenticated_email_address`, `ip_address`, `user_agent` |
| `anthropic_actor` | Anthropic bertindak atas organisasi, misalnya melalui alat internal. | `email_address` (selalu `null`; ada untuk konsistensi bentuk dengan `user_actor`, karena operator Anthropic tidak direpresentasikan dengan email individu) |
| `system_actor` | Pemrosesan latar belakang otomatis yang dilakukan oleh sistem Anthropic, bertindak tanpa kredensial pengguna atau pelanggan. | `service` (dapat bernilai null; nama proses otomatis yang melakukan tindakan, jika diketahui) |
| `scim_directory_sync_actor` | Penyedia identitas (seperti Okta, Microsoft Entra ID, atau JumpCloud) mengirimkan perubahan melalui sinkronisasi direktori SCIM. | `workos_event_id`, `directory_id`, `idp_connection_type` (dapat bernilai null; misalnya `OktaSCIMV2`, `AzureSCIMV2`) |
Aktivitas `user_actor` tidak selalu berarti pengguna yang melakukan tindakan. Proses yang dijalankan Anthropic atas nama pengguna saat ini dapat muncul sebagai `user_actor` untuk pengguna yang terdampak alih-alih sebagai `system_actor`, dan atribusi ini dapat berubah. Misalnya, aktivitas memori dari migrasi, seperti `platform_memory_store_created`, `platform_memory_created`, dan `platform_memory_deleted`, diatribusikan dengan cara ini. Aktivitas memori dapat menampilkan `ip_address` bernilai `0.0.0.0` siapa pun yang melakukannya, sehingga nilai ini saja tidak mengidentifikasi aktivitas dari proses platform.
Aktivitas `claude_*_viewed` berarti aplikasi Claude memuat konten, bukan berarti seseorang melihatnya. Jenis seperti `claude_chat_viewed`, `claude_file_viewed`, dan `claude_project_viewed` dicatat setiap kali aplikasi Claude memuat chat, file, atau proyek dari server Anthropic. Pemuatan berulang tidak dideduplikasi. Aplikasi web, desktop, dan seluler memuat konten pada saat yang berbeda, terkadang di latar belakang, dan dapat menampilkan salinan cache tanpa memuatnya. Akibatnya, jumlah aktivitas ini bervariasi menurut platform, dan tidak sesuai dengan jumlah pesan yang dikirim atau layar yang dilihat.
Aktivitas tentang file, dokumen proyek, atau artifact tidak menyertakan nama atau judulnya. Mulai 24 September 2026, field `filename` dan `title` pada aktivitas ini selalu bernilai `null`, string kosong, atau dihilangkan, termasuk pada aktivitas yang dicatat sebelum tanggal tersebut. Untuk mencari nama atau judul, berikan ID `claude_file_*`, `claude_proj_doc_*`, atau `claude_artifact_version_*` dari aktivitas ke endpoint metadata yang sesuai di [Mengambil file dan artifact](https://platform.claude.com/docs/id/manage-claude/compliance-content-data#retrieve-files-and-artifacts), menggunakan Compliance Access Key dengan scope `read:compliance_user_data`. Anda tidak dapat mencari nama atau judul setelah file, dokumen, atau artifact dihapus, atau ketika aktivitas tidak memiliki ID tersebut.
**Bangun handler yang kompatibel ke depan.** Teruskan nilai `type` dan `actor.type` yang tidak dikenali, dan abaikan field yang tidak diharapkan handler Anda, sehingga integrasi Anda tetap berfungsi ketika jenis aktivitas baru dirilis.
## Langkah selanjutnya
Skema permintaan dan respons lengkap untuk `GET /v1/compliance/activities`, termasuk setiap nilai `activity_types[]` yang didukung.
Kueri dan hapus konten yang mendasari aktivitas yang Anda temukan di feed (memerlukan Compliance Access Key).
Pilih pola konsumsi polling atau batch dan rencanakan korelasi SIEM.
Katalog kesalahan lengkap.