Requirements
An active Farsight® admin account
Authorized API Key
Limitations
For details on usage limits (like requests per hour/month), please refer to the dedicated limitations article
Get A Paginated List of Reports (GET/v1/reports)
The following parameters are used to filter, sort, and paginate the list of reports returned in the response. All parameters are optional unless otherwise noted.
Input Parameter | Type | Required | Definition |
Limit | integer | No | The number of items you want the API to return. It can range from 1 to 50 (Free) or 1 to 500 (Pro). The default value is set to 25. |
Offset | integer | No | The index of the first item to return. Must be 0 or greater. It is set to 0 by default. |
State | string | No | The desired state of reports you want returned. |
Type | string | No | The desired type of reports you want returned. The available options are FaultsAndMaintenance, Efficiency, and ExecutivePortfolio. |
CreatedBefore | string | No | The maximal creation date of the reports. Entries with a creation date less than or equal to this value will be included. It can be in UNIX seconds or a UTC Timestamp (ISO 8601). |
CreatedAfter | string | No | The minimal creation date of the reports. Entries with a creation date greater than or equal to this value will be included. It can be in UNIX seconds or a UTC Timestamp (ISO 8601). |
PeriodStartBefore | string | No | The maximal start date of the period of the reports. Entries with a period start date less or equal than this value will be included. It can be in UNIX seconds or a UTC Timestamp (ISO 8601). |
PeriodStartAfter | string | No | The maximal start date of the period of the reports. Entries with a period start date greater than or equal to the reports. It can be in UNIX seconds or a UTC Timestamp (ISO 8601). |
PeriodEndBefore | string | No | The start date to get alarms, entries with a start time greater than or equal to this value will be included. It can be in UNIX seconds or a UTC Timestamp (ISO 8601). |
PeriodEndAfter | string | No | The maximal start date of the period of the reports. Entries with a period start date less than or equal to this value will be included. It can be in UNIX seconds or a UTC Timestamp (ISO 8601). |
sort | string | No | Fields used in the results sorting. Composed by the name of the field followed by :asc or :desc. Example: id:asc. |
Get Reports for an Asset (GET/v1/reports/{id})
Here are the parameters:
Input Parameter | Type | Required | Definition |
id | string | Yes | The ID of the asset you want reports returned for. |
