Skip to main content

​
Get Data Input Statuses

Retrieve the status of all important data sources.

​
Query Parameters

​
page
integer
default:"0"
Page number (zero-based)
​
size
integer
default:"20"
Number of items per page
​
sort
string
Sort field and direction (e.g., dataType,asc)

​
Response

Returns an array of data input status objects.
​
id
string
Unique data source identifier
​
dataType
string
Type of data source (e.g., “windows”, “linux”, “firewall”)
​
dataTypeName
string
Human-readable name of the data source
​
status
boolean
Whether the data source is currently active
​
timestamp
string
Last time data was received (ISO 8601 format)
​
eventsCount
integer
Number of events received in current period
curl -X GET "https://your-utmstack-instance.com/api/utm-data-input-statuses?page=0&size=20" \
  -H "Authorization: Bearer eyJhbGciOiJIUzUxMiJ9..."

[
  {
    "id": "windows-logs-001",
    "dataType": "windows",
    "dataTypeName": "Windows Event Logs",
    "status": true,
    "timestamp": "2024-01-15T10:30:00Z",
    "eventsCount": 15420
  },
  {
    "id": "firewall-logs-001",
    "dataType": "firewall",
    "dataTypeName": "Cisco Firewall",
    "status": true,
    "timestamp": "2024-01-15T10:29:45Z",
    "eventsCount": 8932
  },
  {
    "id": "linux-syslog-001",
    "dataType": "linux",
    "dataTypeName": "Linux Syslog",
    "status": false,
    "timestamp": "2024-01-15T09:15:30Z",
    "eventsCount": 0
  }
]

​
Get Data Source by ID

Retrieve a specific data source by ID.

​
Path Parameters

​
id
string
required
Data source identifier
curl -X GET https://your-utmstack-instance.com/api/utm-data-input-statuses/windows-logs-001 \
  -H "Authorization: Bearer eyJhbGciOiJIUzUxMiJ9..."

{
  "id": "windows-logs-001",
  "dataType": "windows",
  "dataTypeName": "Windows Event Logs",
  "status": true,
  "timestamp": "2024-01-15T10:30:00Z",
  "eventsCount": 15420,
  "details": {
    "source": "DC01.example.com",
    "version": "1.0"
  }
}

​
Count Data Sources

Get the total count of data sources matching criteria.

​
Query Parameters

Supports filtering criteria parameters (e.g., dataType.equals=windows). 
curl -X GET "https://your-utmstack-instance.com/api/utm-data-input-statuses/count?dataType.equals=windows" \
  -H "Authorization: Bearer eyJhbGciOiJIUzUxMiJ9..."

5

​
Data Source Types

Common data source types include:
  • windows - Windows Event Logs
  • linux - Linux/Unix Syslog
  • firewall - Firewall logs
  • ids-ips - Intrusion Detection/Prevention Systems
  • web-proxy - Web proxy logs
  • antivirus - Antivirus/EDR logs
  • network - Network device logs
  • cloud - Cloud service logs (AWS, Azure, GCP)
  • database - Database audit logs
  • application - Application logs

​
Response Headers

Paginated responses include these headers:
  • X-Total-Count - Total number of data sources
  • Link - Pagination links (first, last, next, prev)

Build docs developers (and LLMs) love

Get started for freeTalk to us