Skip to main content
Who this is for: Organization owners, tenant administrators, and the security or compliance teams who connect Claude for Government to their agency’s log management or SIEM platform.
The Compliance API is a read-only HTTP endpoint that lets your security tools pull a continuous feed of audit events covering administrative activity across your organization, such as sign-ins, role changes, key creations, and seat assignments. A scheduled job can poll the endpoint and forward each event to a SIEM such as Splunk or Microsoft Sentinel. The API is available to every Claude for Government organization by default, and it is read-only, so a compromised key cannot change anything in your organization.

Managing API keys

To create and manage keys for your organization, open Compliance API under Settings in the organization admin portal. To create and manage keys that return events for every organization in your tenant, open Compliance API keys under Settings in the tenant admin portal. Only tenant administrators can open the tenant admin portal. Both pages list only their own keys, showing each key’s name, a hint with the last few characters of the key so you can tell keys apart, when the key was created, and whether it is active or revoked. To create a key, enter a name and click Create key. The full value is shown once, immediately after creation. Copy it somewhere safe before clicking Done.
The full key value is shown only once, at creation time. If you lose it, create a new key and revoke the old one.
Keys never expire on their own, so rotate them on whatever schedule your agency’s policy requires. You can keep more than one key active at a time, which lets you rotate without interrupting your SIEM feed: create a new key, update your collector to use it, confirm events are still arriving, and then revoke the old key. Revoking a key takes effect immediately, and the next request made with it returns a 401. Each key is scoped to the organization or tenant it was created in. A key created in the organization admin portal returns events for that one organization only, regardless of who holds the key. A key that a tenant administrator creates in the tenant admin portal returns the events of every organization in the tenant, together with tenant-level activity such as changes to single sign-on, to the list of tenant administrators, and to tenant-wide settings.

Calling the API

Send a GET request to your Claude for Government host followed by the fixed path /gateway-api/v1/compliance/activities, with your key in the x-api-key header. The Claude for Government host is the address of your organization admin portal. If you are unsure of it, ask your Anthropic representative.

Query parameters

The exclusive bounds created_at.gt and created_at.lt are also accepted if your collector needs them.

Response format

The response is a JSON envelope containing a page of events and the cursors for the next and previous pages.
The actor object identifies who performed the action. Its type is one of:
  • user_actor for a person acting through the product or admin portal.
  • admin_api_key_actor for an action taken through an administrative API key.
  • anthropic_actor for an action performed by Anthropic personnel or systems on your behalf, such as initial provisioning. No individual identity is included.
Each event also carries fields specific to its type, such as the role a user was changed to or the name of a key that was created.

Identifying users

When one of your own users performs an action, actor.user_id and actor.email_address name them, including on sign-in events. Actions taken by Anthropic personnel or automated systems appear as anthropic_actor with no individual identity, by design. On every user.* activity, two top-level fields identify the user the event is about, so your SIEM can map events back to people in your directory without a separate lookup. The user an event is about is not always the actor. When an owner changes someone’s role, the actor block names the owner and these fields name the user whose role changed.
The top-level user_id and user_email fields appear on activities recorded after they were added to the API. Earlier activities are not updated, so your collector should treat these fields as optional.

Activity types

Event types use a dotted resource.action naming convention. The categories emitted today include:
  • Users such as user.created, user.signed_in, user.role_changed, user.deactivated, and user.reactivated.
  • Organizations such as org.created, org.renamed, and org.deactivated.
  • Credentials such as api_key.created and api_key.revoked.
  • Seats and tiers such as seat_allocation.set, seat_allocation.tier_assigned, seat_tier.created, and seat_tier.updated.
  • Configuration such as org_config.capabilities_set.
  • Tenant such as tenant.sso_configured, tenant.admin_added, and tenant.config_set. Only keys created in the tenant admin portal return these types.
New types may be added over time, so a collector should forward unfamiliar types rather than reject them.

Connecting to your SIEM

Most deployments run a small scheduled worker that polls the API on a fixed interval, forwards each event to the SIEM’s HTTP ingest endpoint, and records a time watermark so the next run picks up where the last one left off. A typical run requests since=<watermark>, forwards every event returned, and if has_more is true, follows after_id=<last_id> for each further page until has_more is false. After all pages are drained, advance your watermark to the newest created_at you saw. Event id values are stable and unique, so your collector can deduplicate on id and safely retry a page or use an overlapping since without creating duplicate records in the SIEM.

When the API is disabled

Your tenant administrator can turn off the Compliance API setting on the tenant Config page. When that setting is off, the Create key button is hidden in the organization and tenant admin portals, and every call to /gateway-api/v1/compliance/activities returns a 400 error, including calls made with keys that were valid before the setting changed. Listing and revoking existing keys in either portal remains available even when the setting is off, so an exposed key can still be revoked.

Things to know

  • The Claude for Government Compliance API is served from the Claude for Government service hostname, not from api.anthropic.com. Use the same host you use to reach the admin portal.
  • There is no separate Splunk add-on. The polling pattern described under Connecting to your SIEM is the reference implementation for a Splunk HTTP Event Collector job.
  • The desktop application’s OpenTelemetry export is a separate log stream configured with Telemetry endpoint on the Config page. It carries per-session tool and telemetry events to a collector you specify, while this API carries administrative audit events. See Telemetry and egress for what the OpenTelemetry export includes.
  • The Compliance API returns governance and audit events only. It does not return conversation content, files, or anything your users type into Claude.
  • Each organization can hold up to 50 active keys at once, and keys created in the tenant admin portal have a separate limit of 50 active keys. Revoked keys do not count toward either limit.
  • Events are returned newest first within each page.
  • first_id and last_id are opaque cursors. Pass them back exactly as received rather than constructing them yourself.
  • If your network enforces a tenant restriction, the same restriction applies to Compliance API requests.