Amplitude
Platform Summary
Amplitude HTTP V2 and Identify API contracts.
Scope
Primary execution surface: server.
Developer Source Map
| Source | Reason |
|---|---|
| Amplitude HTTP V2 API | Event Contracts; Normalization Rules; Transport / Payload Rules; User Data Contracts; events, payload, transport |
| Amplitude Identify API | Transport / Payload Rules; User Data Contracts; user data, identify payload |
RudderStack Cross-Check
RudderStack is used here only as secondary engineering evidence for discovery and cross-check.
| Destination | Type | Link |
|---|---|---|
am | Discovery lead | source |
Verified Contracts
Event Contracts
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
event | currency | server | string | Optional | Three-letter ISO 4217 uppercase currency code. | Not clearly specified | Not clearly specified | USD | Currency format guidance is explicit in HTTP V2 docs. | Amplitude HTTP V2 API | Verified | High |
event | event_type | server | string | Required | Event name string. | Not clearly specified | Not clearly specified | - | event_type is required in event payload. | Amplitude HTTP V2 API | Verified | High |
event | insert_id | server | string | Optional | Unique event identifier for deduplication. | Not clearly specified | Not clearly specified | - | Dedup window and behavior are documented by Amplitude. | Amplitude HTTP V2 API | Verified | High |
event | time | server | integer | Optional | Milliseconds since Unix epoch. | Not clearly specified | Not clearly specified | - | If absent, upload time is used. | Amplitude HTTP V2 API | Verified | High |
User Data Contracts
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
event | device_id | server | string | Conditional | Required when user_id is not sent; minimum length 5 unless overridden by options.min_id_length. | Not clearly specified | Not clearly specified | - | Identity contract is user_id or device_id. | Amplitude HTTP V2 API | Verified | High |
event | user_id | server | string | Conditional | Required when device_id is not sent; minimum length 5 unless overridden by options.min_id_length. | Not clearly specified | Not clearly specified | - | Identity contract is user_id or device_id. | Amplitude HTTP V2 API | Verified | High |
identify | user_properties | server | object | Optional | User properties object with supported update operations. | Not clearly specified | Not clearly specified | - | Identify API user_properties supports documented operation keys. | Amplitude Identify API | Verified | High |
Normalization Rules
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
options | min_id_length | server | integer | Optional | Overrides default minimum length for user_id/device_id. | Not clearly specified | Not clearly specified | - | Explicit ID length override in HTTP V2 options. | Amplitude HTTP V2 API | Verified | High |
Transport / Payload Rules
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
http_v2_request | api_key | server | string | Required | Project API key in request body. | Not clearly specified | Not clearly specified | - | Amplitude HTTP V2 requires api_key in body. | Amplitude HTTP V2 API | Verified | High |
http_v2_request | Content-Type | server | string | Required | application/json request header. | Not clearly specified | Not clearly specified | - | Amplitude HTTP V2 requires JSON request content type. | Amplitude HTTP V2 API | Verified | High |
http_v2_request | events | server | array<object> | Required | Array of event objects in request body. | Not clearly specified | Not clearly specified | - | Amplitude HTTP V2 requires events array. | Amplitude HTTP V2 API | Verified | High |
identify_request | api_key | server | string | Required | Project API key in Identify API request body. | Not clearly specified | Not clearly specified | - | Identify API requires api_key. | Amplitude Identify API | Verified | High |
identify_request | identification | server | object|array<object> | Required | Single identification object or array in request body. | Not clearly specified | Not clearly specified | - | Identify API accepts one or more identification objects. | Amplitude Identify API | Verified | High |
Candidate / Needs Review Items
No candidate rows currently tracked.
Excluded Items
No excluded rows in this revision.
Last Reviewed
2026-03-31