For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

APIs

APIs

Use Amplitude APIs to send and receive information and extend Amplitude.

API hosts and regions

Use the base URL for your project's or organization's data residency. API families use different hosts; https://analytics.amplitude.com is the Analytics web app, not an API host. The linked API reference gives the full path and any endpoint-specific exceptions.

API familyDefault base URLEU base URL
HTTP V2 and Batch Event Uploadhttps://api2.amplitude.comhttps://api.eu.amplitude.com
Attribution APIhttps://api.amplitude.comhttps://api.eu.amplitude.com
Dashboard REST, Export, Taxonomy, and Behavioral Cohortshttps://amplitude.comhttps://analytics.eu.amplitude.com
Lookup Table API V2https://data-api.amplitude.comhttps://data-api.eu.amplitude.com
SCIM API and User Management APIhttps://core.amplitude.comhttps://core.eu.amplitude.com
User Privacy API V2https://privacy.amplitude.comhttps://privacy.eu.amplitude.com
Experiment Management APIhttps://experiment.amplitude.comhttps://experiment.eu.amplitude.com
Experiment Evaluation APIhttps://api.lab.amplitude.com/v1/https://api.lab.eu.amplitude.com/v1/
Agent Analytics Export APIhttps://developer-api.amplitude.comhttps://developer-api.eu.amplitude.com
Guides and Surveys APIhttps://app.amplitude.com/a/https://app.eu.amplitude.com/a/
User Profile APIhttps://profile-api.amplitude.comNot supported

For an API that isn't listed here, use the base URL in its own reference page.

Analytics APIs

Attribution API

Send attribution campaign events (identified by idfa, idfv, or adid) that contain attribution information.

Batch Event Upload API

Upload large amounts of event data.

Behavioral Cohorts API

List all your cohorts in Amplitude, export a cohort in Amplitude, or upload a cohort.

Chart Annotations API

Programmatically annotate important dates and time ranges like feature releases and marketing campaigns on your organization's charts. Organize annotations into categories and use hourly granularity for precise timing.

Dashboard REST API

Get data that's displayed on the dashboard graphs in JSON format through the Dashboard REST API.

Data Subject Access Request API

The California Consumer Privacy Act (CCPA) requires businesses to provide all data about an end user upon request. This Data Subject Access Request (DSAR) API makes it easy to retrieve all data about a user.

Event Streaming Metrics Summary API

Get delivery metrics summary for a configured event stream.

Export API

Export your project's event data.

Group Identify API

Set or update properties of particular groups.

HTTP V2 API

Send data directly from your server to the HTTP V2 endpoint.

Identify API

Set the User ID for a particular Device ID or update user properties of a particular user without sending an event.

Lookup Table API

Augment your properties with static data.

Lookup Table API 2

Lookup tables let you augment user and event properties. Instead of using formulas, you can upload a CSV file that contains property mappings to derive new properties.

Releases API

Programmatically create releases in Amplitude using the Releases API.

Taxonomy API

Create, get, update, and delete categories, event types, event properties, and user properties.

User Mapping (Aliasing) API

If you use the Portfolio add-on, use this API to map and unmap users across projects to a global user ID.

User Privacy API

Programmatically submit requests to delete all data for a set of known Amplitude IDs or User IDs.

User Privacy API v2

Programmatically submit org-wide deletion requests through privacy.amplitude.com.

User Profile API

Fetch a user profile, which include user properties, computed properties, a list of cohort IDs, and recommendations.

Experiment APIs

Experiment Evaluation API

Lets you retrieve variant assignment data for users with remote evaluation.

Experiment Management API

Use the Management API to programmatically create and control flags and experiments.

Experiment Management API Deployment Endpoints

Fetch a list of deployments that experiments or flags can be assigned to.

Experiment Management API Experiment Endpoints

Fetch a list of experiments and their configuration details. Results are ordered with the most recently created items first.

Experiment Management API Flag Endpoints

Fetch a list of flags including their configuration details. Results are ordered with the most recently created items first.

Experiment Management API Holdout Group Endpoints

Fetch a list of holdout groups with their configuration details.

Experiment Management API Mutex Group Endpoints

Returns a list of mutex groups with their configuration details.

Experiment Management API Version Endpoints

Fetch a list of versions for all experiments or flags that the management API key can access. The list spans multiple projects when the key scope includes them.