Skip to main content

Farsight® Reports API

Updated over 2 months ago

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.

Did this answer your question?