Skip to main content

Farsight® Sites API

Updated over 2 months ago

Requirements

  • An active Farsight® admin account

  • Authorized API key

Limitations

Get All Sites (GET /v1/sites)

You can retrieve a list of all sites created in your organization using this API. Once authorized, this call will return all sites along with their data.

The following parameters are used to filter, sort, and paginate the list of sites returned in the response. All parameters are optional unless otherwise noted.

Input Parameter

Type

Required

Definition

ConnectionId

integer

No

The ID of the connection you want to query.

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.

sort

string

No

Fields used to sort the result. Composed by the name of the field followed by :asc or :desc. Example: id:asc.

Get One Site (GET /v1/sites/{id})

You can retrieve a site created in your organization using this API. The following parameters are used to find the Site you want to return.

Input Parameter

Type

Required

Definition

id

integer

Yes

The ID of the Site you want to query.

Get Site Availability (GET /v1/sites/{id}/availability)

You can retrieve the site availability in your organization using this API. The following parameters can be used to find the Site you want to return.

Input Parameter

Type

Required

Definition

id

integer

Yes

The ID of the Site you want to query.

From

string

No

The start date to get availability can be in UNIX seconds or a UTC Timestamp (ISO 8601).

To

string

No

The end date to get availability can be in UNIX seconds or a UTC Timestamp (ISO 8601).

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.

Related Content

Did this answer your question?