Aicuflow API Quickstart

Current State

Currently, the API documentation is only available to our enterprise customers.
If you want to integrate anyway, there is a python client library built by us.

There is public api endpoints for data enrichment available though, since 20250220.

Public data enrichment endpoints

We can help enrich your data. Data Enrichment helps you infer new columns or information from your existing information.

1. Geodata and GPS Endpoints

1.1. GPS Latitude, longitude to country prediction

Example request to find the country from coordinates:

/api/gps?lat=51.0&lon=10.0

Response for the example:

{
  "country": "Germany",
  "iso_a2": "DE",
  "iso_a3": "DEU"
}

Errorstate:

{
  "country": null,
  "iso_a2": null,
  "iso_a3": null,
  "help": "https://www.aicuflow.com/docs/api"
}

1.2. German Landkreis prediction

Example to predict the name of the german region a gps coordinate is in:

/api/gps-de?lat=51.0&lon=10.0

Response for the example:

{
  "bundesland_code": "06",
  "bundesland_name": "Hessen",
  "landkreis_code": "06636",
  "landkreis_name": "Landkreis Werra-Meißner-Kreis",
  "landkreis_name_short": "Landkreis Werra-Meißner-Kreis",
  "landkreis_type": "Landkreis"
}

Errorstate:

{
  "bundesland_code": null,
  "bundesland_name": null,
  "landkreis_code": null,
  "landkreis_name": null,
  "landkreis_name_short": null,
  "landkreis_type": null,
  "help": "https://www.aicuflow.com/docs/api"
}

More Information

Reach out to Finn to learn more.

Roadmap

Within latest 2026-Q2, we are planning to publish the API documentation here too.