AMamplitude
Ingestion

Upload events (Batch)

Changed on

Upload large volumes of event data at once. Same payload shape as HTTP V2 with higher throughput limits and looser throttling. Use this for backfills and server-to-server pipelines.

Retrying safely. As with HTTP V2, idempotency is keyed on each event’s insert_id rather than an Idempotency-Key header. Backfills are the case where this matters most: a retried batch without stable insert_id values silently duplicates every event it contains.

post/batch

Request

  • Base URL
    https://api2.amplitude.com
  • Auth
    none required

Request body

api_keystring required

Amplitude project API key.

Response

Events accepted.

code200
events_ingestedinteger

Number of events ingested from the request.

payload_size_bytesinteger

Size of the upload payload in bytes.

server_upload_timeinteger

Milliseconds since epoch when Amplitude accepted the request.

Changes

  • e475ad97669aRevision changes
    • breaking

      the response's body type changed from object to object string for status

    • breaking

      the response's body type changed from object to object string for status

    • breaking

      the response's body type changed from object to object string for status

    • breaking

      the response's body type changed from object to object string for status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status