[[ingest-apis]]
== Ingest APIs

.New API reference
[sidebar]
--
For the most up-to-date API details, refer to {api-es}/group/endpoint-ingest[Ingest APIs].
--

Use ingest APIs to manage tasks and resources related to <<ingest,ingest
pipelines>> and processors.

[discrete]
[[ingest-pipeline-apis]]
=== Ingest pipeline APIs

Use the following APIs to create, manage, and test ingest pipelines:

* <<put-pipeline-api>> to create or update a pipeline
* <<get-pipeline-api>> to retrieve a pipeline configuration
* <<delete-pipeline-api>> to delete a pipeline
* <<simulate-pipeline-api>> and <<simulate-ingest-api>> to test ingest pipelines

[discrete]
[[ingest-stat-apis]]
=== Stat APIs

Use the following APIs to get statistics about ingest processing:

* <<geoip-stats-api>> to get download statistics for IP geolocation databases used with
the <<geoip-processor,`geoip` processor>>.

[discrete]
[[ingest-ip-location-database-apis]]
=== Ingest IP Location Database APIs

Use the following APIs to configure and manage commercial IP geolocation database downloads:

* <<put-ip-location-database-api>> to create or update a database configuration
* <<get-ip-location-database-api>> to retrieve a database configuration
* <<delete-ip-location-database-api>> to delete a database configuration

include::put-pipeline.asciidoc[]
include::get-pipeline.asciidoc[]
include::delete-pipeline.asciidoc[]
include::simulate-pipeline.asciidoc[]
include::simulate-ingest.asciidoc[]
include::geoip-stats.asciidoc[]
include::put-ip-location-database.asciidoc[]
include::get-ip-location-database.asciidoc[]
include::delete-ip-location-database.asciidoc[]