Logsign SIEM API Documentation

All endpoints require authentication via the api_key query parameter.
Base URL: https://<LOGSIGN_HOST>

Table of Contents

1. Test API

Tests the API connection and validates the API key.

GET /test_api 10/min

Parameters

ParameterTypeRequiredDescription
api_keystringYesAPI key

Example Request

GET /test_api?api_key=YOUR_API_KEY

Example Response

{
  "success": true
}

2. Get Version

Returns the current Logsign SIEM version.

GET /get_version 10/min

Parameters

ParameterTypeRequiredDescription
api_keystringYesAPI key

Example Request

GET /get_version?api_key=YOUR_API_KEY

Example Response

{
  "success": true,
  "version": "6.4.1"
}

3. Feed List (GET)

Returns all entries from the specified feed list.

GET /feed_list 10/min

Parameters

ParameterTypeRequiredDescription
api_keystringYesAPI key
list_namestringYesName of the feed list
formatstringNoSet to txt to return the response as plain text

Example Request

GET /feed_list?api_key=YOUR_API_KEY&list_name=blocked_ips

4. Feed List (POST)

Adds a new entry to the specified feed list.

POST /feed_list 30/min

Query Parameters

ParameterTypeRequiredDescription
api_keystringYesAPI key
list_namestringYesName of the feed list

Body Parameters

ParameterTypeRequiredDescription
valuestringYesThe value to add
expire_timeintNoExpiration time in seconds (default: 0 = no expiry)

Example Request

POST /feed_list?api_key=YOUR_API_KEY&list_name=blocked_ips
Content-Type: application/json

{
  "value": "192.168.1.100",
  "expire_time": 3600
}

5. Get Count

Returns the event count for a given query, grouped by a specified column.

GET /get_count 30/min

Parameters

ParameterTypeRequiredDescription
api_keystringYesAPI key
querystringYesSearch query
grouped_columnstringYesColumn name to group by
criteriastringYesAggregation criteria (e.g. count, sum)
time_framestringYesTime frame for the query

Example Request

GET /get_count?api_key=YOUR_API_KEY&query=*&grouped_column=SourceIP&criteria=count&time_frame=last_1_hour

6. Get Events

Returns events matching the given query with pagination support.

GET /get_events 30/min

Parameters

ParameterTypeRequiredDescription
api_keystringYesAPI key
querystringYesSearch query
time_framestringYesTime frame for the query
pageintNoPage number (default: 1)
sizeintNoResults per page (default: 100)

Example Request

GET /get_events?api_key=YOUR_API_KEY&query=SourceIP:10.0.0.1&time_frame=last_1_hour&page=1&size=50

7. Get Columns

Returns grouped column values for a given query.

GET /get_columns 30/min

Parameters

ParameterTypeRequiredDescription
api_keystringYesAPI key
querystringYesSearch query
grouped_columnstringYesColumn name to group by
time_framestringYesTime frame for the query

Example Request

GET /get_columns?api_key=YOUR_API_KEY&query=*&grouped_column=SourceIP&time_frame=last_24_hours

8. Get Incidents

Returns incidents created after the specified timestamp.

GET /get_incidents 30/min

Parameters

ParameterTypeRequiredDescription
api_keystringYesAPI key
last_runstringYesTimestamp; returns incidents created after this time
querystringNoFilter query

Example Request

GET /get_incidents?api_key=YOUR_API_KEY&last_run=2026-04-17T00:00:00&query=severity:high

9. Set Incident Status

Updates the status of an incident.

POST /set_incident_status 30/min

Query Parameters

ParameterTypeRequiredDescription
api_keystringYesAPI key
incident_idstringYesIncident ID

Body

JSON object containing the status update data.

Example Request

POST /set_incident_status?api_key=YOUR_API_KEY&incident_id=INC-001
Content-Type: application/json

{
  "status": "closed"
}

10. Incident Comment

Adds a comment to an incident.

POST /incident_comment 30/min

Query Parameters

ParameterTypeRequiredDescription
api_keystringYesAPI key

Body Parameters

ParameterTypeRequiredDescription
incident_idstringYesIncident ID
messagestringYesComment text

Example Request

POST /incident_comment?api_key=YOUR_API_KEY
Content-Type: application/json

{
  "incident_id": "INC-001",
  "message": "Incident reviewed and closed as false positive."
}

11. Get Alert Configs

Returns all alert configurations grouped by alert blocks.

GET /get_alert_configs 1/min

Parameters

ParameterTypeRequiredDescription
api_keystringYesAPI key

Example Request

GET /get_alert_configs?api_key=YOUR_API_KEY

Example Response

[
  {
    "uid": "block-001",
    "name": "Network Alerts",
    "alerts": [
      {
        "uid": "alert-001",
        "name": "High Traffic Alert",
        "disabled": false,
        "block_uid": "block-001"
      }
    ]
  }
]

Error Responses

HTTP CodeDescription
403Invalid API key or missing required parameter
400Invalid request body (JSON parse error)
429Rate limit exceeded