HTTP Event Collector REST API endpoints

The following table lists the REST API endpoints for the HTTP Event Collector. You can find the complete HTTP Event Collector REST API endpoint reference in the Splunk Enterprise REST API Reference Manual..

REST API endpoint Description
data/inputs/http Accesses or updates HTTP Event Collector global configuration tokens and application tokens.
data/inputs/http/{name} Manages the {name} HTTP Event Collector token. HTTP, as in data/inputs/http/http, indicates global configuration.
data/inputs/http/{name}/disable Turns off the {name} HTTP Event Collector token.
data/inputs/http/{name}/enable Turns on the {name} HTTP Event Collector token.
services/collector Queries events to HTTP Event Collector using the Splunk platform JavaScript Object Notation (JSON) event protocol.
services/collector/ack Queries event indexing status.
services/collector/event Sends timestamped events to the HTTP Event Collector using the Splunk platform JSON event protocol when you set the auto_extract_timestamp argument to true in the /event URL.
  • An example of a timestamp is 2017-01-02 00:00:00
  • Timestamps in the event's JSON envelope take priority over the extracted timestamp.
  • If there's no timestamp in the event's JSON envelope, the merging pipeline extracts the timestamp from the event.
  • If time=xxx is used in the /event URL, then auto_extract_timestamp is turned off.
services/collector/event/1.0 Works identically to the services/collector/event endpoint but introduces a protocol version for future scalability.
services/collector/health Checks the health of the HTTP Event Collector. This endpoint is supported in Splunk Cloud Platform and versions 6.6.0 and higher of Splunk Enterprise.
services/collector/mint Posts data formatted for Splunk MINT to the HTTP Event Collector.
services/collector/mint/1.0 Works identically to the receivers/token/mint endpoint but introduces a protocol version for future scalability.
services/collector/raw Sends raw data directly to the HTTP Event Collector.
services/collector/raw/1.0 Works identically to the services/collector/raw endpoint but introduces a protocol version for future scalability.
services/collector/s2s Receives Splunk Transmission Control Protocol (TCP) data over HTTP from the Splunk Universal Forwarder. This endpoint is supported in Splunk Enterprise 8.1.0 and higher.