Fortinet white logo
Fortinet white logo

AiLog

AiLog

Logs messages by face recognition AI on FortiRecorder.

Permissions required include Camera analytics.

HTTP Methods
  • GET

URL
https://HOST_OR_IP/api/v1/AiLog?type=activity&subtype=activity& range=TIMESTAMP&startIndex=INDEX&pageSize=ITEMS&start_time=TIMESTAMP&end_time=TIMESTAMP&person={user_id}&camera={camera_id}

where variables are:

  • TIMESTAMP — Optional (except for range=TIMESTAMP, which is a fixed value). Timestamp in the format YYYY-MM-DD-HH-MM-SS (year, month, day, hour, minute, second).
  • INDEX — Optional. See also Filtering and paging.

  • PAGE_SIZE — Optional. See also Filtering and paging.

  • person — Either the name of a person profile, KNOWN (all known persons), or UNKNOWN (all unknown persons).

  • camera — Name of a camera. See also CameraCamera.

Other parts of the URL are required, but their values cannot be changed.

Example: Find times when unknown people were seen by camera MC51

curl -X GET -b cookie.txt "https://HOST_OR_IP/api/v1/AiLog?Type=activity&subtype=activity&person=UNKNOWN&camera=MC51"
Tooltip

On Microsoft Windows with Command Prompt and the curl command, if the URL has parameters, then you must put double straight quotes ( " ) around the URL. If you do not, the command line may try to interpret URL parameters after each ampersand ( & ), question mark ( ? ), or asterisk/star ( * ) as commands or arguments. Errors at the end of the JSON indicate this problem but do not accurately show the cause, such as:

'subtype' is not recognized as an internal or external command, operable program or batch file.

Reserved characters and escape sequence vary by operating system and command line environment. Linux and Mac terminals often do not require this, and Microsoft PowerShell uses different escape sequences.

AiLog

AiLog

Logs messages by face recognition AI on FortiRecorder.

Permissions required include Camera analytics.

HTTP Methods
  • GET

URL
https://HOST_OR_IP/api/v1/AiLog?type=activity&subtype=activity& range=TIMESTAMP&startIndex=INDEX&pageSize=ITEMS&start_time=TIMESTAMP&end_time=TIMESTAMP&person={user_id}&camera={camera_id}

where variables are:

  • TIMESTAMP — Optional (except for range=TIMESTAMP, which is a fixed value). Timestamp in the format YYYY-MM-DD-HH-MM-SS (year, month, day, hour, minute, second).
  • INDEX — Optional. See also Filtering and paging.

  • PAGE_SIZE — Optional. See also Filtering and paging.

  • person — Either the name of a person profile, KNOWN (all known persons), or UNKNOWN (all unknown persons).

  • camera — Name of a camera. See also CameraCamera.

Other parts of the URL are required, but their values cannot be changed.

Example: Find times when unknown people were seen by camera MC51

curl -X GET -b cookie.txt "https://HOST_OR_IP/api/v1/AiLog?Type=activity&subtype=activity&person=UNKNOWN&camera=MC51"
Tooltip

On Microsoft Windows with Command Prompt and the curl command, if the URL has parameters, then you must put double straight quotes ( " ) around the URL. If you do not, the command line may try to interpret URL parameters after each ampersand ( & ), question mark ( ? ), or asterisk/star ( * ) as commands or arguments. Errors at the end of the JSON indicate this problem but do not accurately show the cause, such as:

'subtype' is not recognized as an internal or external command, operable program or batch file.

Reserved characters and escape sequence vary by operating system and command line environment. Linux and Mac terminals often do not require this, and Microsoft PowerShell uses different escape sequences.