Skip to content

Get custom events list

Custom events collection contains a list of all custom events. All active custom events can be downloaded. Specifying a single custom event ID can be used to retrieve detailed information about a specific event.

Request data format

Request URL parameters:

ParametersTypeNotes
apiKeystringYour API key, required for authentication. Required.

Examples:

https://api.esv2.com/v2/Api/WorkflowCustomEvent?apiKey=YOUR_API_KEY_HERE 

Get custom event by custom event ID

Request URL parameters:

ParametersTypeNotes
apiKeystringYour API key, required for authentication. Required.
IDintWorkflow custom event ID. Required as a part of address (not GET parameter). See example below.
startDatedatetimeOptional. The date from which we want to check the occurrence of a custom event.
endDatedatetimeOptional. Date to when we want to check the occurrence of a custom event.

Examples:

https://api.esv2.com/v2/Api/WorkflowCustomEvent/123?apiKey=YOUR_API_KEY_HERE
https://api.esv2.com/v2/Api/WorkflowCustomEvents/123?apiKey=YOUR_API_KEY_HERE&startDate=2024-12-06%2011:22:00&endDate=2024-12-06%2012:37:00

Response

Get multiple custom events

Response Data element:

ParametersTypeNotes
CustomEventsarray[complex]Array of custom event elements.

Custom event element children:

ParametersTypeNotes
IdintCustom event identifier.
NamestringCustom event name.
IsLoggingEnabledbooleanInformation about logging enabled.

Get custom event by custom event ID

Response Data element:

ParametersTypeNotes
IdintCustom event identifier.
NamestringCustom event name.
IsLoggingEnabledbooleanInformation about logging enabled.
OccurrenceCountintNumber of appearances of a given custom event

Examples

Get multiple custom events

Request:

GET 
https://api.esv2.com/v2/Api/WorkflowCustomEvent?apiKey=test_api_key  
Accept-Encoding: gzip,deflate 
User-Agent: Jakarta Commons-HttpClient/3.1 
Host: api.esv2.com

OK response:

{
    "Data": {
        "CustomEvents": [
            {
                "Id": 1,
                "Name": "test custom event",
                "IsLoggingEnabled": true
            },
            {
                "Id": 4,
                "Name": "test",
                "IsLoggingEnabled": true
            },
            {
                "Id": 7,
                "Name": "test event",
                "IsLoggingEnabled": false
            }
        ]
    }
}

Get custom event by custom event ID

Request:

GET 
https://api.esv2.com/v2/Api/WorkflowCustomEvents/123?apiKey=YOUR_API_KEY_HERE&startDate=2024-12-06%2011:22:00&endDate=2024-12-06%2012:37:00
Accept-Encoding: gzip,deflate 
User-Agent: Jakarta Commons-HttpClient/3.1 
Host: api.esv2.com

OK response:

{
    "Data": {
        "Id": 123,
        "Name": "My custom event",
        "IsLoggingEnabled": true,
        "OccurrenceCount": 6
    }
}